ShortestLineTo (type de données geography)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Retourne une instance LineString avec deux points qui représentent la distance la plus courte entre les deux instances geography. La longueur de l’instance LineString retournée correspond à la distance entre les deux instances geography.

Syntaxe

  
.ShortestLineTo ( geography_other )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

geography_other
Spécifie la deuxième instance geography dont l’instance geography appelante tente de déterminer la distance la plus courte.

Types de retour

Type de retour SQL Server : geography

Type de retour CLR : SqlGeography

Notes

La méthode retourne une instance LineString avec des points de terminaison situés sur les bordures des deux instances geography sans intersection qui sont comparées. La longueur du LineString retourné est égale à la distance la plus courte entre les deux instances geography. Une instance LineString vide est retournée quand les deux instances geography se croisent.

Exemples

R. Appel de ShortestLineTo() sur des instances qui ne se croisent pas

Cet exemple recherche la distance la plus courte entre une instance CircularString et une instance LineString et retourne l'instance LineString qui connecte les deux points :

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. Appel de ShortestLineTo() sur des instances qui se croisent

Cet exemple retourne une instance LineString vide du fait que l'instance LineString croise l'instance 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();

Voir aussi

Méthodes étendues sur des instances geography
ShortestLineTo (type de données geometry)