STDistance (Tipo de dados de geografia)
Retorna a distância mais curta entre um ponto em uma instância de geography e um ponto em outra instância de geography.
.gif "Observação") Observação |
|---|
STDistance() retorna o LineString mais curto 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 )
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
SQL Server tipo de retorno: float
Tipo de retorno CLR: SqlDouble
Comentários
STDistance() sempre retornará nulo se os SRIDs (IDs de referência espacial) das instâncias de geography não corresponderem.
| Observação |
|---|
Métodos no tipo de dados geography que calculam uma área ou distância retornarão resultados diferentes com base na SRID da instância usada no método. Para obter mais informações sobre SRIDs, consulte SRIDs (Spatial Reference Identifiers). |
Exemplos
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);