geo_h3cell_parent()
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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 |