ShortestLineTo (tipo de dados de geometria)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Retorna uma ocorrência de LineString com dois pontos que representam a menor distância entre as duas ocorrências de geometria . O comprimento da ocorrência de LineString retornada é a distância entre as duas instâncias de geometria .

Syntax

  
.ShortestLineTo ( geometry_other )  

Arguments

geometry_other
A segunda instância de geometria para a qual a instância de geometria chamadora está tentando determinar a menor distância.

Tipos de devolução

Tipo de retorno do SQL Server: geometria

Tipo de retorno CLR: SqlGeometry

Remarks

O método retorna uma ocorrência de LineString com pontos de extremidade situados nas bordas das duas instâncias de geometria sem interseção que estão sendo comparadas. O comprimento do LineString retornado é igual à menor distância entre as duas instâncias de geometria . Uma ocorrência vazia de LineString é retornada quando as duas instâncias de geometria se cruzam.

Examples

A. Chamando ShortestLineTo() em instâncias sem interseção

Este exemplo localiza a menor distância entre uma CircularString instância e uma LineString instância e retorna a LineString instância que conecta os dois pontos:

 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. Chamando ShortestLineTo() em instâncias de interseção

Este exemplo retorna uma instância vazia LineString porque a LineString instância intersecta a CircularString instância:

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

Ver também

ShortestLineTo (tipo de dados geográficos)