Catégories :: Fonctions géospatiales

H3_TRY_COVERAGE¶

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

Syntaxe¶

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

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

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(
  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.