Partager via


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

Voir aussi

Autres ressources

Méthodes étendues sur les instances géographiques