geo_point_to_h3cell()

Вычисляет строковое значение токена ячейки 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