STDistance (Tipo de dados geography)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

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

Observação

STDistance() retorna a LineString mais curta entre dois tipos de geografia. Trata-se de uma aproximação para a distância geodésica. O desvio de STDistance() em modelos terrestres comuns da distância geodésica exata não é maior que 0,25%. Isso evita confusão quanto às diferenças mínimas entre o comprimento e a distância em tipos geodésicos.

Sintaxe

  
.STDistance ( other_geography )  

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_geography
É outra instância de geography da qual medir a distância entre a instância na qual STDistance() é invocado. Se other_geography for um conjunto vazio, STDistance() retornará nulo.

Tipos de retorno

Tipo de retorno do SQL Server: float

Tipo de retorno do CLR: SqlDouble

Comentários

O resultado é expresso na unidade de medida definida pelo Identificador de Referência Espacial (SRID) de dados espaciais. STDistance() sempre retornará nulo se os SRIDs (IDs de referência espacial) das instâncias de geografia não forem correspondentes.

Observação

Métodos no tipo de dados geography que calculam uma área ou distância retornarão resultados diferentes com base no SRID da instância usado no método. Para obter mais informações sobre SRIDs, confira SRIDs (Identificadores de Referência Espacial).

Exemplos

O exemplo a seguir localiza a distância entre duas instâncias de geography.

DECLARE @g geography;  
DECLARE @h geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SET @h = geography::STGeomFromText('POINT(-122.34900 47.65100)', 4326);  
SELECT @g.STDistance(@h);  

Consulte Também

Métodos do OGC em instâncias de geography