Catégories :: Fonctions géospatiales

H3_COVERAGE_STRINGS¶

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

Voir aussi :: H3_COVERAGE , H3_POLYGON_TO_CELLS_STRINGS

Syntaxe¶

H3_COVERAGE_STRINGS( <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 VARCHAR pour les IDs hexadécimaux 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_STRINGS.
Une cellule est incluse dans le jeu de résultats si sa limite coupe la forme d’entrée.

Exemples¶

L’exemple suivant renvoie un ARRAY des IDs hexadécimaux qui identifie l’ensemble minimal de cellules H3 qui couvrent complètement le polygone spécifié.

SELECT H3_COVERAGE_STRINGS(
  TO_GEGGRAPHY(
    '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 |
|----------------------------------|
| [                                |
|   "882830870bfffff",             |
|   "8828308703fffff",             |
|   "8828308739fffff",             |
|   "8828308709fffff",             |
|   "8828308701fffff",             |
|   "8828308715fffff"              |
| ]                                |
|----------------------------------|