STDistance (Tipo de dados geography)
Aplica-se a: 
SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric
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 )
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);