Catégories :

Fonctions géospatiales

H3_POINT_TO_CELL

Renvoie la valeur INTEGER d’un ID de cellule H3 pour un point (spécifié par un objet GEOGRAPHY) à une résolution donnée.

Voir aussi :

H3_POINT_TO_CELL_STRING , H3_CELL_TO_POINT

Syntaxe

H3_POINT_TO_CELL( <geography_point> , <target_resolution> )
Copy

Arguments

geography_point

Un objet GEOGRAPHY qui représente un point.

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 une valeur INTEGER correspondant à l’ID de cellule H3 pour l’emplacement et la résolution donnés.

Exemples

L’exemple suivant renvoie l’ID de cellule H3 pour la porte de Brandebourg à la résolution 8.

SELECT H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 8);
Copy
+-----------------------------------------------------+
| H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 8) |
|-----------------------------------------------------|
|                                  613036919424548863 |
+-----------------------------------------------------+

L’exemple suivant montre que vous ne pouvez pas spécifier une résolution en dehors de 0 à 15.

SELECT H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 18);
Copy
100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).