Catégories :

Fonctions géospatiales

H3_CELL_TO_PARENT

Renvoie l’ID du parent d’une cellule H3 pour une résolution donnée. L’ID est renvoyé sous forme de valeur INTEGER (si une valeur INTEGER a été fournie comme ID d’entrée) ou sous forme de VARCHAR contenant l’ID hexadécimal (si l’ID hexadécimal a été fourni comme ID d’entrée).

Voir aussi :

H3_CELL_TO_CHILDREN , H3_CELL_TO_CHILDREN_STRING

Syntaxe

H3_CELL_TO_PARENT( <cell_id> , <target_resolution> )
Copy

Arguments

cell_id

Un INTEGER qui représente l’ID de cellule H3 (index), ou un VARCHAR qui représente l’ID de cellule au format hexadécimal.

target_resolution

Un INTEGER compris entre 0 et 15 (inclus) spécifiant la résolution H3 que vous souhaitez utiliser pour la cellule H3 renvoyée.

La spécification de toute autre valeur INTEGER entraîne une erreur.

Renvoie

Renvoie l’ID de la cellule parent H3 à la résolution cible spécifiée. L’ID se présente dans l’un des formats suivants :

  • Si cell_id est une valeur INTEGER, la fonction renvoie l’ID sous la forme d’une valeur INTEGER.

  • Si cell_id est une valeur VARCHAR contenant l’IDhexadécimal, la fonction renvoie l’ID hexadécimal sous forme de valeur VARCHAR.

Exemples

L’exemple suivant renvoie l’ID de cellule H3 pour le parent de la cellule H3 avec l’ID 613036919424548863 (spécifié comme valeur INTEGER) :

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

L’exemple suivant renvoie l’ID de cellule H3 pour le parent de la cellule H3 avec l’ID 881F1D4887FFFFF (spécifié comme valeur VARCHAR) :

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