ShortestLineTo (geografidatatyp)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-databas i Microsoft Fabric

Returnerar en LineString-instans med två punkter som representerar det kortaste avståndet mellan de två geografiska instanserna. Längden på den LineString-instans som returneras är avståndet mellan de två geografiska instanserna.

Syntax

  
.ShortestLineTo ( geography_other )  

Arguments

geography_other
Anger den andra geografiinstansen som den anropande geografiinstansen försöker fastställa det kortaste avståndet till.

Returtyper

SQL Server-returtyp: geografi

CLR-returtyp: SqlGeography

Remarks

Metoden returnerar en LineString-instans med slutpunkter som ligger på kantlinjerna för de två geografiinstanser som inte är korsande och jämförs. Längden på linestring som returneras är lika med det kortaste avståndet mellan de två geografiska instanserna. En tom LineString-instans returneras när de två geografiska instanserna korsar varandra.

Examples

A. Anropa ShortestLineTo() på icke-korsande instanser

Det här exemplet hittar det kortaste avståndet mellan en CircularString instans och en LineString instans och returnerar den instans som LineString ansluter de två punkterna:

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. Anropa ShortestLineTo() på korsande instanser

Det här exemplet returnerar en tom LineString instans eftersom instansen LineString korsar instansen CircularString :

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

Se även

Utökade metoder för geografiinstanser
ShortestLineTo (geometridatatyp)