geo_h3cell_parent()
Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Вычисляет родительский элемент ячейки H3.
Дополнительные сведения о ячейке H3.
Синтаксис
geo_h3cell_parent(Разрешение h3cell,)
Дополнительные сведения о соглашениях синтаксиса.
Параметры
| Имя (название) | Type | Обязательно | Описание |
|---|---|---|---|
| h3cell | string |
✔️ | Значение маркера ячейки H3, вычисляемое geo_point_to_h3cell(). |
| резолюция | int |
Определяет разрешение запрошенных дочерних ячеек. Поддерживаемые значения находятся в диапазоне [0, 14]. Если не указано, будет вычисляться маркер немедленного дочернего маркера. |
Возвраты
Родительский маркер stringячейки H3. Если ячейка H3 недопустима или родительское разрешение выше заданной ячейки, запрос создаст пустой результат.
Примеры
print parent_cell = geo_h3cell_parent('862a1072fffffff')
Выходные данные
| parent_cell |
|---|
| 852a1073fffffff |
В следующем примере вычисляется родительский элемент ячейки на уровне 1.
print parent_cell = geo_h3cell_parent('862a1072fffffff', 1)
Выходные данные
| parent_cell |
|---|
| 812a3ffffffff |
print parent_res = geo_h3cell_level(geo_h3cell_parent((geo_point_to_h3cell(1,1,10))))
Выходные данные
| parent_res |
|---|
| 9 |
print parent_res = geo_h3cell_level(geo_h3cell_parent(geo_point_to_h3cell(1,1,10), 3))
Выходные данные
| parent_res |
|---|
| 3 |
В следующем примере создается пустой результат из-за недопустимых входных данных ячейки.
print invalid = isempty(geo_h3cell_parent('123'))
Выходные данные
| недопустимо |
|---|
| 1 |
В следующем примере создается пустой результат из-за недопустимого родительского разрешения.
print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 100))
Выходные данные
| недопустимо |
|---|
| 1 |
В следующем примере создается пустой результат, так как родительский объект не может иметь более высокое разрешение, чем дочерний.
print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 15))
Выходные данные
| недопустимо |
|---|
| 1 |