ShortestLineTo (Jenis Data geografi)

Berlaku untuk: SQL ServerAzure SQL Database Azure SQL Managed Instance

Mengembalikan instans LineString dengan dua titik yang mewakili jarak terpendek antara dua instans geografi . Panjang instans LineString yang dikembalikan adalah jarak antara dua instans geografi .

Sintaksis

  
.ShortestLineTo ( geography_other )  

Catatan

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

Argumen

geography_other
Menentukan instans geografi kedua yang coba ditentukan instans geografi panggilan.

Jenis Kembalian

Jenis pengembalian SQL Server: geografi

Jenis pengembalian CLR: SqlGeography

Keterangan

Metode ini mengembalikan instans LineString dengan titik akhir yang berbaring di batas dua instans geografi yang tidak berpotangan dibandingkan. Panjang LineString yang dikembalikan sama dengan jarak terpendek antara dua instans geografi. Instans LineString kosong dikembalikan ketika dua instans geografi saling berpotongan.

Contoh

J. Memanggil ShortestLineTo() pada instans non-intersecting

Contoh ini menemukan jarak terpendek antara CircularString instans dan LineString instans dan mengembalikan instans yang LineString menghubungkan dua titik:

DECLARE @g1 geography = 'CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)';  
DECLARE @g2 geography = 'LINESTRING(-119.119263 46.183634, -119.273071 47.107523, -120.640869 47.569114, -122.200928 47.454094)';  
SELECT @g1.ShortestLineTo(@g2).ToString();

B. Memanggil ShortestLineTo() pada instans yang bersinggungan

Contoh ini mengembalikan instans kosong LineString karena LineString instans berpotongan CircularString instans:

 DECLARE @g1 geography = 'CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)';  
 DECLARE @g2 geography = 'LINESTRING(-119.119263 46.183634, -119.273071 47.107523, -120.640869 47.569114, -122.348 47.649, -122.681 47.655)';  
 SELECT @g1.ShortestLineTo(@g2).ToString();

Lihat Juga

Metode yang Diperluas pada Instans Geografi
ShortestLineTo (Tipe Data geometri)