geo_distance_2points()

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

Синтаксис

geo_distance_2points(, p1_longitude, p1_latitude, p2_longitudep2_latitude)

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

Параметры

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

Возвращаемое значение

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

Примечание

• Геопространственные координаты интерпретируются в виде системы координат 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)

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

В следующем примере выполняется поиск всех строк, в которых наименьшее расстояние между двумя координатами составляет от одного метра до 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