Compartilhar via


STDistance (tipo de dados geometry)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric

Retorna a distância mais curta entre um ponto em uma instância de geometry e um ponto em outra instância de geometry.

Sintaxe

  
.STDistance ( other_geometry )  

Argumentos

other_geometry
É outra instância de geometry da qual medir a distância entre a instância na qual STDistance() é invocado. Se other_geometry é um conjunto vazio, STDistance() retorna nulo.

Tipos de retorno

Tipo de retorno do SQL Server: float

Tipo de retorno do CLR: SqlDouble

Comentários

STDistance() sempre retornará nulo se as SRIDs (IDs de referência espacial) das instâncias de geometry não forem correspondentes.

Exemplos

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))', 0);  
SET @h = geometry::STGeomFromText('POINT(10 10)', 0);  
SELECT @g.STDistance(@h);  

Consulte Também

Visão geral de índices espaciais
Métodos OGC em instâncias geometry