geo_h3cell_children()

Berechnet die untergeordneten H3-Zellen.

Erfahren Sie mehr über H3 Cell.

Syntax

geo_h3cell_children(h3cell,Auflösung)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Typ	Erforderlich	BESCHREIBUNG
h3cell	string	✔️	Ein H3 Cell-Tokenwert, wie er von geo_point_to_h3cell() berechnet wurde.
Auflösung	int		Definiert die angeforderte Auflösung untergeordneter Zellen. Unterstützte Werte liegen im Bereich [1, 15]. Wenn keine Angabe erfolgt, wird ein direkt untergeordnetes Token berechnet.

Gibt zurück

Array von untergeordneten H3 Cell-Token. Wenn die H3-Zelle ungültig ist oder die untergeordnete Auflösung niedriger als die angegebene Zelle ist, erzeugt die Abfrage ein NULL-Ergebnis.

Hinweis

Ein Unterschied zwischen der Zellauflösung und den untergeordneten Elementen darf nicht mehr als 5 sein. Ein Unterschied von 5 Ebenen führt zu bis zu 16807 untergeordneten Token.

Beispiele

Abfrage ausführen

print children = geo_h3cell_children('862a1072fffffff')

Ausgabe

Untergeordnete
[ "872a10728ffff", "872a10729ffff", "872a1072affffff", "872a1072bffffff", "872a1072cffffff", "872a1072dffffff", "872a1072effff" ]

Im folgenden Beispiel werden untergeordnete Elemente 3 Ebenen unterhalb einer bestimmten Zelle zählt.

Abfrage ausführen

let h3_cell = '862a1072fffffff'; 
print children_count = array_length(geo_h3cell_children(h3_cell, geo_h3cell_level(h3_cell) + 3))

Ausgabe

children_count
343

Im folgenden Beispiel wird die GeoJSON-Geometrieauflistung von untergeordneten H3 Cell-Polygonen zusammengesetzt.

Abfrage ausführen

print children = geo_h3cell_children('862a1072fffffff')
| mv-expand children to typeof(string)
| project child = geo_h3cell_to_polygon(children)
| summarize h3_hash_polygon_lst = make_list(child)
| project geojson = bag_pack(
    "type", "Feature",
    "geometry", bag_pack("type", "GeometryCollection", "geometries", h3_hash_polygon_lst),
    "properties", bag_pack("name", "H3 polygons collection"))

Ausgabe

geojson
{ "type": "Feature", "geometry": { "type": "GeometryCollection", "geometries": [ ... ... ... ] }, "properties": { "name": "H3 polygons collection" }}

Im folgenden Beispiel wird aufgrund der ungültigen Zelle true zurückgegeben.

Abfrage ausführen

print is_null = isnull(geo_h3cell_children('abc'))

Ausgabe

is_null
1

Im folgenden Beispiel wird true zurückgegeben, da der Ebenenunterschied zwischen Zelle und ihren untergeordneten Elementen mehr als 5 beträgt.

Abfrage ausführen

print is_null = isnull(geo_h3cell_children(geo_point_to_h3cell(1, 1, 9), 15))

Ausgabe

is_null
1