STDistance(geography 데이터 형식)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

지리 인스턴스의 지점과 다른 지리 인스턴스의 점 사이의 가장 짧은 거리를 반환합니다.

참고 항목

STDistance() 는 두 지리 형식 간의 가장 짧은 LineString을 반환합니다. 이것은 측지 거리에 가까운 근사치입니다. 정확한 측지 거리에서 공통 지구 모델의 편차 STDistance() 는 .25%를 넘지 않습니다. 이렇게 하면 측지 형식의 길이와 거리 사이의 미묘한 차이에 대한 혼동을 방지할 수 있습니다.

Syntax

  
.STDistance ( other_geography )

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

other_geography
STDistance()가 호출되는 인스턴스 사이의 거리를 측정하는 또 다른 지리 인스턴스입니다. other_geography 빈 집합이면 STDistance()는 null을 반환합니다.

반환 형식

SQL Server 반환 형식: float

CLR 반환 형식: SqlDouble

설명

결과는 공간 데이터의 SRID(Spatial Reference Identifier)에서 정의한 측정 단위로 표현됩니다. 지리 인스턴스의 SRID(공간 참조 ID)가 일치하지 않으면 STDistance()는 항상 null을 반환합니다.

참고 항목

영역 또는 거리를 계산하는 지리 데이터 형식의 메서드는 메서드에 사용된 인스턴스의 SRID에 따라 다른 결과를 반환합니다. SRID에 대한 자세한 내용은 SRID(Spatial Reference Identifiers)를 참조하세요.

예제

다음 예제에서는 두 지리 인스턴스 사이의 거리를 찾습니다.

DECLARE @g geography;  
DECLARE @h geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SET @h = geography::STGeomFromText('POINT(-122.34900 47.65100)', 4326);  
SELECT @g.STDistance(@h);

참고 항목

Geography 인스턴스의 OGC 메서드