Catégories :

Fonctions géospatiales

H3_POLYGON_TO_CELLS

Renvoie un ARRAY des valeurs INTEGER des IDs des cellules H3 dont les centres de gravité sont contenus par un polygone (spécifié par un objet GEOGRAPHY).

Voir aussi :

H3_POLYGON_TO_CELLS_STRINGS , H3_COVERAGE

Syntaxe

H3_POLYGON_TO_CELLS( <geography_polygon> , <target_resolution> )
Copy

Arguments

geography_polygon

Un objet GEOGRAPHY qui représente un polygone.

target_resolution

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

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

Renvoie

Renvoie un ARRAY de valeurs INTEGER pour les IDs des cellules H3 dont les centres de gravité sont contenus dans le polygone d’entrée spécifié.

Notes sur l’utilisation

  • La fonction utilise une approximation planaire, qui traite les points à la surface de la Terre comme s’ils étaient reliés par des lignes droites plutôt que par des arcs courbes. Si vous avez besoin d’une approximation sphérique, utilisez plutôt H3_COVERAGE.

  • Une cellule est considérée comme faisant partie du polygone si son centre de gravité est contenu dans le polygone.

  • Lorsque vous appliquez FLATTEN aux ARRAY renvoyés par la fonction, convertissez chaque valeur explicitement en un nombre entier.

Exemples

L’exemple suivant renvoie un ARRAY des IDs des cellules H3 dont les centres de gravité sont contenus dans le polygone spécifié.

SELECT H3_POLYGON_TO_CELLS(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'
  ),
  9) AS h3_cells_in_polygon;
Copy
+-----------------------+
| H3_CELLS_IN_POLYGON   |
|-----------------------|
| [                     |
|   617700171176476671, |
|   617700171168874495, |
|   617700171177525247, |
|   617700171167563775, |
|   617700171225497599, |
|   617700171188011007, |
|   617700171168350207, |
|   617700171168612351, |
|   617700171167825919  |
| ]                     |
+-----------------------+
Langage: Français