Поделиться через

geo_distance_2points()

  • Статья

Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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

Синтаксис

geo_distance_2points(,p1_longitude p1_latitude,p2_longitude p2_latitude,)

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

Параметры

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

Возвраты

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

Примечание.

  • Геопространственные координаты интерпретируются как представленные эталонной системой координат WGS-84 .
  • Геостатический datum , используемый для измерения расстояния на Земле является сферой.

Примеры

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

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

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