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

geo_point_to_h3cell()

  • Статья

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

Вычисляет строковое значение токена ячейки H3 географического расположения.

Дополнительные сведения о ячейке H3.

Синтаксис

geo_point_to_h3cell(широта долготы,, [ разрешение ])

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

Параметры

Имя (название) Type Обязательно Описание
longitude real ✔️ Геопространственные координаты, значение долготы в градусах. Допустимое значение — это реальное число и в диапазоне [-180, +180].
latitude real ✔️ Геопространственные координаты, значение широты в градусах. Допустимое значение — это реальное число и в диапазоне [-90, +90].
резолюция int Определяет запрошенные разрешения ячеек. Поддерживаемые значения находятся в диапазоне [0, 15]. Если не задано, по умолчанию используется значение 6.

Возвраты

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

Примечание.

  • Ячейка H3 может быть полезным инструментом геопространственного кластеризации.
  • Ячейка H3 имеет 16 уровней иерархии с покрытием области от 4250 547 км до самого высокого уровня 0 до 0,9 млн м 15.
  • H3 Cell имеет уникальную шестнадцатеричную форму, и это приводит к некоторым уникальным свойствам:
  • Хексагон имеют 6 соседей
  • Хексагоны позволяют нам приблизить радиусы легко, и все соседи эквивалентны
  • Хексагоны визуально приятны
  • В некоторых редких случаях форма является пентагоном.
  • Ячейка H3 имеет прямоугольную область на поверхности плоскости.
  • Вызов функции geo_h3cell_to_central_point() в строке токена ячейки H3, вычисляемой по долготе x и широте y, не обязательно возвращает x и y.
  • Возможно, что два географических расположения очень близки друг к другу, но имеют разные токены ячейки H3.

Приблизительное покрытие области H3 на значение разрешения

Уровень Средняя шестнадцатеричная длина края
0 1108 км
1 419 км
2 158 км
3 60 км
4 23 км
5 8 км
6 3 км
7 1 км
8 460 м
9 174 м
10 66 м
11 25 м
12 9 м
13 3 м
14 1 м
15 0,5 м

Источник таблицы можно найти в этом статистическом ресурсе ячейки H3.

См. также geo_point_to_s2cell(), geo_point_to_geohash().

Для сравнения с другими доступными системами сетки. см. геопространственные кластеризации с язык запросов Kusto.

Примеры

print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)

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

h3cell
862a1072fffffff

В следующем примере показано, как найти группы координат. Каждая пара координат в группе находится в ячейке H3 со средней шестнадцатеричной площадью 253 км 253 км.

datatable(location_id:string, longitude:real, latitude:real)
[
    "A", -73.956683, 40.807907,
    "B", -73.916869, 40.818314,
    "C", -73.989148, 40.743273,
]
| summarize count = count(),                                         // Items per group count
            locations = make_list(location_id)                       // Items in the group
            by h3cell = geo_point_to_h3cell(longitude, latitude, 5)  // H3 Cell of the group

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

h3cell count locations
852a100bfffffff 2 [
"A",
"B"
]
852a1073fffffff 1 [
"C"
]

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

print h3cell = geo_point_to_h3cell(300,1,8)

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

h3cell

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

print h3cell = geo_point_to_h3cell(1,1,16)

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

h3cell

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

print h3cell = geo_point_to_h3cell(1,1,int(null))

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

h3cell