ShortestLineTo (type de données geometry)

S’applique à : SQL ServerAzure SQL Database Azure SQL Managed Instance

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

Syntaxe

  
.ShortestLineTo ( geometry_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

geometry_other
Deuxième instance geometry dont l’instance geometry appelante tente de déterminer la distance la plus courte.

Types de retour

Type de retour SQL Server : geometry

Type de retour CLR : SqlGeometry

Remarques

La méthode retourne une instance LineString avec des points de terminaison situés sur les bordures des deux instances geometry sans intersection qui sont comparées. La longueur du LineString retourné est égale à la distance la plus courte entre les deux instances geometry. Une instance LineString vide est retournée quand les deux instances geometry 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 geometry = 'CIRCULARSTRING(0 0, 1 2.1082, 3 6.3246, 0 7, -3 6.3246, -1 2.1082, 0 0)';  
 DECLARE @g2 geometry = 'LINESTRING(-4 7, 7 10, 3 7)';  
 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 geometry = 'CIRCULARSTRING(0 0, 1 2.1082, 3 6.3246, 0 7, -3 6.3246, -1 2.1082, 0 0)';  
 DECLARE @g2 geometry = 'LINESTRING(0 5, 7 10, 3 7)';  
 SELECT @g1.ShortestLineTo(@g2).ToString();

Voir aussi

ShortestLineTo (type de données geography)