Freigeben über


geo_h3cell_parent()

Gilt für: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Berechnet das übergeordnete Element der H3-Zelle.

Weitere Informationen zu H3 Cell.

Syntax

geo_h3cell_parent(h3cell-Auflösung,)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
h3cell string ✔️ Ein H3 Cell-Tokenwert, wie er durch geo_point_to_h3cell()berechnet wurde.
Auflösung int Definiert die auflösung der angeforderten untergeordneten Zellen. Unterstützte Werte befinden sich im Bereich [0, 14]. Wenn nicht angegeben, wird ein sofortiges untergeordnetes Token berechnet.

Gibt zurück

Übergeordnetes H3 Cell-Token string. Wenn die H3 Cell ungültig ist oder die übergeordnete Auflösung höher als die angegebene Zelle ist, erzeugt die Abfrage ein leeres Ergebnis.

Beispiele

print parent_cell = geo_h3cell_parent('862a1072fffffff')

Output

parent_cell
852a1073fffffff

Im folgenden Beispiel wird das übergeordnete Zellenformat auf Ebene 1 berechnet.

print parent_cell = geo_h3cell_parent('862a1072fffffff', 1)

Output

parent_cell
812a3ffffffffff
print parent_res = geo_h3cell_level(geo_h3cell_parent((geo_point_to_h3cell(1,1,10))))

Output

parent_res
9
print parent_res = geo_h3cell_level(geo_h3cell_parent(geo_point_to_h3cell(1,1,10), 3))

Output

parent_res
3

Im folgenden Beispiel wird aufgrund der ungültigen Zelleneingabe ein leeres Ergebnis erzeugt.

print invalid = isempty(geo_h3cell_parent('123'))

Output

Ungültig
1

Im folgenden Beispiel wird aufgrund der ungültigen übergeordneten Auflösung ein leeres Ergebnis erzeugt.

print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 100))

Output

Ungültig
1

Im folgenden Beispiel wird ein leeres Ergebnis erzeugt, da das übergeordnete Element keine höhere Auflösung als untergeordnete Elemente aufweisen kann.

print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 15))

Output

Ungültig
1