Catégories :

Fonctions géospatiales

H3_LATLNG_TO_CELL_STRING

Renvoie l’ID de cellule H3 au format hexadécimal (sous forme de valeur VARCHAR) pour une latitude, une longitude et une résolution données.

Voir aussi :

H3_LATLNG_TO_CELL

Syntaxe

H3_LATLNG_TO_CELL_STRING( <latitude> , <longitude> , <target_resolution> )
Copy

Arguments

latitude

Un FLOAT qui représente la latitude.

Les valeurs en dehors de la plage de latitude standard sont regroupées dans la plage [-90, 90].

longitude

Un FLOAT qui représente la longitude.

Les valeurs en dehors de la plage de longitude standard sont renvoyées dans la plage [-180, 180].

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

Notes sur l’utilisation

  • La spécification des valeurs NaN ou Inf pour tout argument d’entrée entraîne une erreur.

Exemples

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

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8);
Copy
+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

L’exemple suivant spécifie une valeur longitude (373.377704) qui se situe en dehors de la plage de longitude traditionnelle (-180 à 180). La fonction interprète cette valeur comme 13.377704 (373.377704 modulo 180).

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 373.377704, 8);
Copy
+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

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

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 373.377704, 18);
Copy
100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).
Langage: Français