Partager via

Fonction h3_try_polyfillash3string

  • Article

S’applique à : coche marquée oui Databricks SQL case marquée oui Databricks Runtime 11.3 LTS et versions ultérieures

Il se comporte de la même manière que h3_polyfillash3string, à la différence que NULL est renvoyé au lieu d’une erreur si le premier argument n’est pas valide. Plus précisément, celui-ci renvoie un tableau d’ID de cellules H3 (représentées par des STRING) correspondant à des hexagones ou des pentagones, de la résolution spécifiée, qui sont contenus dans la géographie de la zone d’entrée.

Syntaxe

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

Arguments

  • geographyExpr : Une expression BINARY ou STRING représentant une zone géographique (polygone ou multipolygone) dans WKB , WKT ou GeoJSON. La géographie doit avoir des coordonnées de longitude et de latitude en degrés faisant référence au système de référence de coordonnées WGS84.
  • resolutionExpr : expression INT dont la valeur doit être comprise entre 0 et 15 inclus, en spécifiant la résolution des cellules H3.

Retours

TABLEAU de valeurs STRING correspondant aux ID de cellule H3, de la résolution spécifiée, qui sont contenues par la géographie de la zone d’entrée.

La fonction renvoie NULL si l’une des expressions d’entrée est NULL. Si le premier argument d’entrée est de type BINARY, la valeur d’entrée doit correspondre à la description WKB d’un polygone ou d’un multipolygone. Si le premier argument d’entrée est de type STRING, la valeur d’entrée est censée être la description WKT ou GeoJSON d’un polygone ou d’un multipolygone. La dimension du polygone ou multipolygone d’entrée peut être 2D, 3DZ, 3DM ou 4D. La fonction retourne NULL si le premier argument correspond à un WKB, WKT ou GeoJSON non valide ou ne représente pas un polygone ou un multipolygone.

Conditions de l’erreur

Exemples

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2)
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_try_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2)
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- The input is invalid.
> SELECT h3_try_polyfillash3string('Not-a-valid-rep', 2)
  null

-- Resolution is out of range.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive