STDistance (coğrafya Veri Türü)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiMicrosoft Fabric'te SQL veritabanı

Coğrafya örneğindeki bir nokta ile başka bircoğrafya örneğindeki bir nokta arasındaki en kısa mesafeyi döndürür.

Note

STDistance() iki coğrafya türü arasındaki en kısa LineString değerini döndürür. Bu, jeodezik mesafeye yaklaşık olarak yakındır. Ortak dünya modellerinin STDistance() tam jeodezik mesafeden sapması en fazla 0,25%. Bu, jeodezik türlerdeki uzunluk ve uzaklık arasındaki ince farkların karışıklığını önler.

Syntax

  
.STDistance ( other_geography )  

Arguments

other_geography
STDistance() öğesinin çağrıldığı örnek arasındaki mesafenin ölçüldiği başka bir coğrafya örneğidir. other_geography boş bir kümeyse, STDistance() null döndürür.

Dönüş Türleri

SQL Server dönüş türü: float

CLR dönüş türü: sqldouble

Remarks

Sonuç, uzamsal verilerin Uzamsal Başvuru Tanımlayıcısı (SRID) tarafından tanımlanan ölçü biriminde ifade edilir. Coğrafya örneklerinin uzamsal başvuru kimlikleri (SRID) eşleşmiyorsa STDistance() her zaman null döndürür.

Note

Bir alanı veya uzaklığı hesaplayan coğrafya veri türündeki yöntemler, yönteminde kullanılan örneğin SRID'sine göre farklı sonuçlar döndürür. SRID'ler hakkında daha fazla bilgi için bkz . Uzamsal Başvuru Tanımlayıcıları (SRID).

Examples

Aşağıdaki örnek, iki coğrafya örneği arasındaki uzaklığı bulur.

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);  

Ayrıca Bkz.

Coğrafya Örneklerinde OGC Yöntemleri