geo_distance_2points()

Переключайте службы с помощью раскрывающегося списка Версия. Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Вычисляет самое короткое расстояние в метрах между двумя геопространственных координатами на Земле.

Синтаксис

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

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
p1_longitude real ✔️ Значение долготы в градусах первой геопространственной координаты. Допустимое значение находится в диапазоне [-180, +180].
p1_latitude real ✔️ Значение широты в градусах первой геопространственной координаты. Допустимое значение находится в диапазоне [-90, +90].
p2_longitude real ✔️ Значение долготы в градусах второй геопространственной координаты. Допустимое значение находится в диапазоне [-180, +180].
p2_latitude real ✔️ Значение широты в градусах второй геопространственной координаты. Допустимое значение находится в диапазоне [-90, +90].
use_spheroid bool Если false будет использовать сферу в качестве геодимической datum для измерения расстояния. Если true будет измерять расстояние с помощью сфероида. Если не указано, используется значение false по умолчанию.

Возвраты

Самое короткое расстояние в метрах между двумя географическими расположениями на Земле. Если координаты недопустимы, запрос создает результат NULL.

Примечание.

  • Геопространственные координаты интерпретируются как представленные эталонной системой координат WGS-84 .
  • Большинство приложений должны измерять расстояние с помощью сферы ('use_spheroid' = false), которая является более эффективной. Если требуется дополнительная точность, параметр "use_spheroid" может иметь значение true, для дополнительной точности, которая может быть более актуальной для больших расстояний, которые могут оказаться затронуты из-за кривизны земли.

Примеры

В следующем примере находит самое короткое расстояние между Сиэтлом и Лос-Анджелесом.

Расстояние между Сиэтлом и Лос-Анджелесом.

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

Выходные данные

distance_in_meters
1546754.35197381

В следующем примере обнаруживается приближение кратчайшего пути от Сиэтла до Лондона. Линия состоит из координат вдоль LineString и в пределах 500 метров от него.

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)

Выходные данные

Снимок экрана: Сиэтл — Лондон LineString.

В следующем примере находятся все строки, в которых самое короткое расстояние между двумя координатами составляет от одного метра до 11 метров.

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

Выходные данные

distance_1_to_11m
10.5723100154958
7.92153588248414

В следующем примере возвращается пустой результат из-за недопустимого ввода координат.

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

Выходные данные

distance