Catégories :

Fonctions géospatiales

H3_TRY_COVERAGE_STRINGS

Version spéciale de H3_COVERAGE_STRINGS qui renvoie NULL en cas d’erreur lorsqu’elle tente de renvoyer un tableau 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).

Syntaxe

H3_TRY_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 tableau de valeurs VARCHAR ou NULL.

  • Si la fonction peut effectuer un calcul correct, renvoie un tableau 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.

  • Si la fonction ne peut pas effectuer de calcul correct, renvoie NULL sans signaler d’erreur.

Notes sur l’utilisation

Pour les Notes sur l’utilisation, voir H3_COVERAGE_STRINGS.

Exemples

L’exemple suivant tente de renvoyer un tableau d’IDs qui identifient l’ensemble minimal de cellules H3 qui couvrent complètement une forme (spécifiée par un objet GEOGRAPHY). Comme le tableau des cellules qui couvrent l’hexagone donné à la résolution donnée dépasse la taille limite autorisée, la fonction renvoie NULL.

SELECT H3_TRY_COVERAGE_STRINGS(
  TO_GEOGRAPHY('POLYGON((-108.959 40.948,
                         -109.015 37.077,
                         -102.117 36.956,
                         -102.134 40.953,
                         -108.959 40.948))'
              ), 15) AS set_of_h3_cells_covering_polygon;
Copy
+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| NULL                             |
+----------------------------------+

Pour des exemples qui renvoient correctement un tableau d’IDs, voir H3_COVERAGE_STRINGS.

Langage: Français