ShortestLineTo (type de données geography)
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 )
Arguments
- geography_other
Spécifie la deuxième instance geography à laquelle l'instance geography appelante essaie de déterminer la distance la plus courte.
Types de retour
SQL Server type de retour : geography
Type de retour CLR : SqlGeography
Notes
La méthode retourne une instance LineString avec les points de terminaison qui se situent sur les bordures des deux instances geography sans intersection commune qui sont comparées. La longueur de LineString retournée est égale à la distance la plus courte entre les deux instances geography. Une instance LineString vide est retournée lorsque les deux instances geography se croisent.
Exemples
A.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();