STDistance (Jenis Data geografi)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Mengembalikan jarak terpendek antara titik dalam instans geografi dan titik dalam instans geografi lain.

Catatan

STDistance()mengembalikan LineString terpendek di antara dua jenis geografi. Ini adalah perkiraan dekat dengan jarak geodesik. Penyimpangan STDistance() pada model bumi umum dari jarak geodesik yang tepat tidak lebih dari .25%. Ini menghindari kebingungan atas perbedaan halus antara panjang dan jarak dalam jenis geodesik.

Sintaksis

  
.STDistance ( other_geography )  

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

other_geography
Adalah instans geografi lain untuk mengukur jarak antara instans tempat STDistance() dipanggil. Jika other_geography adalah set kosong, STDistance() mengembalikan null.

Jenis Kembalian

Jenis pengembalian SQL Server: float

Jenis pengembalian CLR: SqlDouble

Keterangan

Hasilnya dinyatakan dalam satuan ukuran yang ditentukan oleh Pengidentifikasi Referensi Spasial (SRID) data spasial. STDistance() selalu mengembalikan null jika ID referensi spasial (SRID) instans geografi tidak cocok.

Catatan

Metode pada jenis data geografi yang menghitung area atau jarak akan mengembalikan hasil yang berbeda berdasarkan SRID instans yang digunakan dalam metode . Untuk informasi selengkapnya tentang SRID, lihat Pengidentifikasi Referensi Spasial (SRID).

Contoh

Contoh berikut menemukan jarak antara dua instans geografi .

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

Lihat Juga

Metode OGC pada Instans Geografi