ShortestLineTo (type de données geography)ShortestLineTo (geography Data Type)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retourne une instance LineString avec deux points qui représentent la distance la plus courte entre les deux instances geography.Returns a LineString instance with two points that represent the shortest distance between the two geography instances. La longueur de l’instance LineString retournée correspond à la distance entre les deux instances geography.The length of the LineString instance returned is the distance between the two geography instances.

SyntaxeSyntax

  
.ShortestLineTo ( geography_other )  

ArgumentsArguments

geography_othergeography_other
Spécifie la deuxième instance geography dont l’instance geography appelante tente de déterminer la distance la plus courte.Specifies the second geography instance that the calling geography instance is trying to determine the shortest distance to.

Types de retourReturn Types

Type de retour SQL ServerSQL Server : geographySQL ServerSQL Server return type: geography

Type de retour CLR : SqlGeographyCLR return type: SqlGeography

NotesRemarks

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.The method returns a LineString instance with endpoints lying on the borders of the two non-intersecting geography instances being compared. La longueur du LineString retourné est égale à la distance la plus courte entre les deux instances geography.The length of the LineString returned equals the shortest distance between the two geography instances. Une instance LineString vide est retournée quand les deux instances geography se croisent.An empty LineString instance is returned when the two geography instances intersect each other.

ExemplesExamples

A.A. Appel de ShortestLineTo() sur des instances qui ne se croisent pasCalling ShortestLineTo() on non-intersecting instances

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 :This example finds the shortest distance between a CircularString instance and a LineString instance and returns the LineString instance connecting the two 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.B. Appel de ShortestLineTo() sur des instances qui se croisentCalling ShortestLineTo() on intersecting instances

Cet exemple retourne une instance LineString vide du fait que l'instance LineString croise l'instance CircularString :This example returns an empty LineString instance because the LineString instance intersects the CircularString instance:

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 aussiSee Also

Méthodes étendues sur des instances geographyExtended Methods on Geography Instances