STDistance (tipo de dados geometry)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzurePonto de extremidade de análises SQL no Microsoft FabricWarehouse 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 )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

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