Catégories :

Fonctions géospatiales

H3_COVERAGE

Renvoie un ARRAY d’IDs (sous forme de valeurs INTEGER) identifiant l’ensemble minimal de cellules H3 qui couvrent complètement une forme (spécifiée par un objet GEOGRAPHY).

Voir aussi :

H3_COVERAGE_STRINGS , H3_POLYGON_TO_CELLS

Syntaxe

H3_COVERAGE( <geography_expression> , <target_resolution> )
Copy

Arguments

geography_expression

Un objet GEOGRAPHY.

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 de l’ensemble minimal de cellules H3 qui couvrent complètement la forme d’entrée spécifiée.

Notes sur l’utilisation

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

  • Une cellule est incluse dans le jeu de résultats si sa limite coupe la forme d’entrée.

  • 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 qui identifient l’ensemble minimal de cellules H3 qui couvrent complètement le polygone spécifié.

SELECT H3_COVERAGE(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'),
  8) AS set_of_h3_cells_covering_polygon;
Copy
+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| [                                |
|   613196571542028287,            |
|   613196571548319743,            |
|   613196571598651391,            |
|   613196571539931135,            |
|   613196571560902655,            |
|   613196571550416895             |
| ]                                |
+----------------------------------+
Langage: Français