STDistance(geography 데이터 형식)
geography 인스턴스의 점 및 다른 geography 인스턴스의 점 간 최단 길이를 반환합니다.
[!참고]
STDistance()는 두 geography 형식 사이의 최단 LineString을 반환합니다. 이 길이는 측지 거리와 거의 같습니다. 일반 지구 모델에서 STDistance() 와 정확한 측지 거리 간의 편차는 .25%를 넘지 않으므로 geodesic 형식에서 길이와 거리의 미세한 차이로 인한 혼동이 발생하지 않습니다.
구문
.STDistance ( other_geography )
인수
- other_geography
**STDistance()**를 호출할 인스턴스 사이의 거리를 측정하는 다른 geography 인스턴스입니다. other_geography가 빈 집합이면 **STDistance()**는 Null을 반환합니다.
반환 형식
SQL Server 반환 형식: float
CLR 반환 형식: SqlDouble
주의
**STDistance()**는 geography 인스턴스의 SRID(Spatial Reference ID)가 일치하지 않으면 항상 Null을 반환합니다.
[!참고]
면적 또는 거리를 계산하는 geography 데이터 형식에 대한 메서드는 메서드에서 사용되는 인스턴스의 SRID에 따라 다른 결과를 반환합니다. SRID에 대한 자세한 내용은 SRID(Spatial Reference Identifier)를 참조하십시오.
예
다음 예에서는 두 geography 인스턴스 간의 거리를 찾습니다.
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);