Kategorien:

Geodatenfunktionen

H3_CELL_TO_PARENT

Gibt die ID der übergeordneten Zelle einer H3-Zelle für eine gegebene Auflösung zurück. Die ID wird als INTEGER-Wert zurückgegeben (wenn als Eingabe-IDein INTEGER-Wert angegeben wurde) oder als VARCHAR-Wert mit der hexadezimalen ID (wenn die hexadezimale ID als Eingabe-ID angegeben wurde) zurückgegeben.

Siehe auch:

H3_CELL_TO_CHILDREN, H3_CELL_TO_CHILDREN_STRING

Syntax

H3_CELL_TO_PARENT( <cell_id> , <target_resolution> )
Copy

Argumente

cell_id

Ein INTEGER-Wert, der die ID der H3-Zelle (Index) repräsentiert, oder ein VARCHAR-Wert, der die ID der Zelle im Hexadezimalformat repräsentiert.

target_resolution

Ein INTEGER-Wert zwischen 0 und 15 (einschließlich), der die H3-Auflösung angibt, die Sie für die zurückgegebene H3-Zelle verwenden möchten.

Die Angabe eines beliebigen anderen INTEGER-Werts führt zu einem Fehler.

Rückgabewerte

Gibt die ID der übergeordneten H3-Zelle mit der angegebenen Zielauflösung zurück. Die ID hat eines der folgenden Formate:

  • Wenn cell_id ein INTEGER-Wert ist, gibt die Funktion die ID als INTEGER-Wert zurück.

  • Wenn cell_id ein VARCHAR-Wert ist, der die hexadezimale ID enthält, gibt die Funktion die hexadezimale ID als VARCHAR-Wert zurück.

Beispiele

Im folgenden Beispiel wird die ID der übergeordneten H3-Zelle für die H3-Zelle mit der ID 613036919424548863 (als INTEGER angegeben) zurückgegeben:

SELECT H3_CELL_TO_PARENT(613036919424548863, 7);
Copy
+------------------------------------------+
| H3_CELL_TO_PARENT(613036919424548863, 7) |
|------------------------------------------|
|                       608533319805566975 |
+------------------------------------------+

Im folgenden Beispiel wird die ID der übergeordneten H3-Zelle für die H3-Zelle mit der ID 881F1D4887FFFFF (als VARCHAR angegeben) zurückgegeben:

SELECT H3_CELL_TO_PARENT('881F1D4887FFFFF', 7);
Copy
+-----------------------------------------+
| H3_CELL_TO_PARENT('881F1D4887FFFFF', 7) |
|-----------------------------------------|
|  871F1D488FFFFFF                        |
+-----------------------------------------+