Partilhar via

geo_distância_2pontos()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcula a menor distância em metros entre duas coordenadas geoespaciais na Terra.

Sintaxe

geo_distance_2points( , p1_longitude, p1_latitude, p2_longitude, p2_latitude[ use_spheroid ])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
p1_longitude real ✔️ O valor da longitude em graus da primeira coordenada geoespacial. Um valor válido está no intervalo [-180, +180].
p1_latitude real ✔️ O valor da latitude em graus da primeira coordenada geoespacial. Um valor válido está no intervalo [-90, +90].
p2_longitude real ✔️ O valor da longitude em graus da segunda coordenada geoespacial. Um valor válido está no intervalo [-180, +180].
p2_latitude real ✔️ O valor da latitude em graus da segunda coordenada geoespacial. Um valor válido está no intervalo [-90, +90].
use_spheroid bool Se false vai usar uma esfera como dado geodésico para medir a distância. Se true vai medir a distância usando esferoide. Se não for especificado, o valor false padrão será usado.

Devoluções

A menor distância, em metros, entre duas localizações geográficas na Terra. Se as coordenadas forem inválidas, a consulta produzirá um resultado nulo.

Observação

  • As coordenadas geoespaciais são interpretadas como representadas pelo sistema de referência de coordenadas WGS-84 .
  • A maioria das aplicações deve medir a distância usando esfera ('use_spheroid' = false), que é mais eficiente. Se for necessária precisão extra, a opção 'use_spheroid' pode ser definida como 'true', para precisão extra, o que pode ser mais relevante para distâncias maiores, que podem ser impactadas devido à curvatura da terra.

Exemplos

O exemplo a seguir localiza a menor distância entre Seattle e Los Angeles.

Distância entre Seattle e Los Angeles.

Executar a consulta

print distance_in_meters = geo_distance_2points(-122.407628, 47.578557, -118.275287, 34.019056)

Output

distance_in_meters
1546754.35197381

O exemplo a seguir encontra uma aproximação do caminho mais curto de Seattle a Londres. A linha consiste em coordenadas ao longo do LineString e dentro de 500 metros dele.

Executar a consulta

range i from 1 to 1000000 step 1
| project lng = rand() * real(-122), lat = rand() * 90
| where lng between(real(-122) .. 0) and lat between(47 .. 90)
| where geo_distance_point_to_line(lng,lat,dynamic({"type":"LineString","coordinates":[[-122,47],[0,51]]})) < 500
| render scatterchart with (kind=map)

Output

Screenshot do Seattle para London LineString.

O exemplo a seguir localiza todas as linhas em que a menor distância entre duas coordenadas é entre um metro e 11 metros.

Executar a consulta

StormEvents
| extend distance_1_to_11m = geo_distance_2points(BeginLon, BeginLat, EndLon, EndLat)
| where distance_1_to_11m between (1 .. 11)
| project distance_1_to_11m

Output

distance_1_to_11m
10.5723100154958
7.92153588248414

O exemplo a seguir retorna um resultado nulo devido à entrada de coordenadas inválida.

Executar a consulta

print distance = geo_distance_2points(300,1,1,1)

Output

Distância
  • Last updated on