Catégories :: Fonctions géospatiales

H3_LATLNG_TO_CELL¶

Renvoie la valeur INTEGER de l’ID de cellule H3 pour une latitude, une longitude et une résolution données.

Voir aussi :: H3_LATLNG_TO_CELL_STRING

Syntaxe¶

H3_LATLNG_TO_CELL( <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 INTEGER correspondant à l’ID de cellule 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 H3 pour la porte de Brandebourg à la résolution 8.

SELECT H3_LATLNG_TO_CELL(52.516262, 13.377704, 8);

Copy

+--------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 13.377704, 8) |
|--------------------------------------------|
|                         613036919424548863 |
+--------------------------------------------+

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(52.516262, 373.377704, 8);

Copy

+---------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 373.377704, 8) |
|---------------------------------------------|
|                          613036919424548863 |
+---------------------------------------------+

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

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 18);

Copy

100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).