Partilhar via


STDistance (tipo de dados geometry)

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

Sintaxe

.STDistance ( other_geometry )

Argumentos

  • other_geometry
    É outra instância geometry a partir da qual medir a distância entre a instância na qual STDistance() é invocado. Se other_geometry for um conjunto vazio, STDistance() retornará nulo.

Tipos de retorno

Tipo de retorno do SQL Server: float

Tipo de retorno CLR: SqlDouble

Comentários

STDistance() sempre retornará nulo se as SRIDs (IDs de referência espacial) das instâncias 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);