ShortestLineTo (tipo di dati geometry)

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure

Restituisce un'istanza LineString con due punti che rappresentano la distanza più breve tra le due istanze geometry. La lunghezza dell'istanza LineString restituita è la distanza tra le due istanze geometry.

Sintassi

  
.ShortestLineTo ( geometry_other )  

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

geometry_other
Seconda istanza geometry da cui l'istanza geometry chiamante prova a determinare la distanza più breve.

Tipi restituiti

Tipo SQL Server restituito: geometry

Tipo CLR restituito: SqlGeometry

Osservazioni:

Il metodo restituisce un'istanza LineString con endpoint che si trovano sui bordi delle due istanze geometry non intersecate messe a confronto. La lunghezza dell'istanza LineString restituita corrisponde alla distanza minore tra le due istanze geometry. Viene restituita un'istanza LineString vuota quando le due istanze geometry si intersecano.

Esempi

R. Chiamata di ShortestLineTo() in istanze non intersecate

In questo esempio viene individuata la distanza più breve tra un'istanza CircularString e un'istanza LineString e viene restituita l'istanza LineString che collega i due punti:

 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. Chiamata di ShortestLineTo() in istanze intersecate

In questo esempio viene restituita un'istanza LineString vuota perché l'istanza LineString interseca l'istanza 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();

Vedi anche

ShortestLineTo (tipo di dati geography)