Partilhar via


STDistance (tipo de dados de geometria)

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

Retorna a menor distância entre um ponto em uma ocorrência de geometria e um ponto em outra ocorrência de geometria .

Syntax

  
.STDistance ( other_geometry )  

Arguments

other_geometry
É outra instância de geometria a partir da qual medir a distância entre a instância na qual STDistance() é invocada. Se other_geometry for um conjunto vazio, STDistance() retornará null.

Tipos de devolução

Tipo de retorno do SQL Server: float

Tipo de retorno CLR: SqlDouble

Remarks

STDistance() sempre retorna null se os IDs de referência espacial (SRIDs) das instâncias de geometria não corresponderem.

Examples

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

Ver também

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