Partage via

Fonction h3_coverash3

  • Article

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

Retourne un TABLEAU de valeurs BIGINT représentant des ID de cellule H3. Ces valeurs correspondent à un ensemble minimal d’hexagones ou de pentagones de la résolution spécifiée qui couvrent entièrement la géographie linéaire ou de la zone d’entrée.

Syntaxe

h3_coverash3 ( geographyExpr, resolutionExpr )

Arguments

  • geographyExpr : expression BINAIRE ou de CHAÎNE représentant une géographie linéaire (linestring ou multilinestring) ou une géographie de zone (polygone ou multipolygone) dans WKB, WKT ou GeoJSON. La géographie doit disposer de 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 avec une valeur comprise entre 0 et 15 inclus, en spécifiant la résolution des ID de cellule H3.

Retours

TABLEAU de valeurs BIGINT correspondant à un ensemble minimal d’ID de cellule H3 de la résolution spécifiée qui couvrent entièrement la géographie linéaire ou de la zone d’entrée.

La fonction retourne NULL si l’une des expressions d’entrée est NULL. Si le premier argument d’entrée est de type BINAIRE, 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 CHAÎNE, la valeur d’entrée doit être la description WKT ou GeoJSON d’un linestring, d’un polygone, d’un multilinestring ou d’un multipolygone. La dimension de la chaîne de lignes, du polygone, de la chaîne multiligne ou du multipolygone en entrée peut être 2D, 3DZ, 3DM ou 4D.

Conditions de l’erreur

  • Si geographyExpr est de type BINARY et que la valeur est un WKB non valide ou ne représente pas une chaîne de lignes, un polygone, une chaîne multiligne ou un multipolygone, la fonction renvoie WKB_PARSE_ERROR.
  • Si geographyExpr est de type STRING et que la valeur est un WKT non valide ou ne représente pas une chaîne de lignes, un polygone, une chaîne multiligne ou un multipolygone, la fonction renvoie WKT_PARSE_ERROR.
  • Si geographyExpr est de type STRING et que la valeur est un GeoJSON non valide ou ne représente pas une chaîne de lignes, un polygone, une chaîne multiligne ou un multipolygone, la fonction renvoie GEOJSON_PARSE_ERROR.
  • Si resolutionExpr est inférieure à 0 ou supérieure à 15, la fonction retourne H3_INVALID_RESOLUTION_VALUE.

Exemples

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_coverash3('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 0)
  [577164439745200127, 577199624117288959, 577234808489377791, 577762574070710271]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_coverash3(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 0)
  [577164439745200127, 577199624117288959, 577234808489377791, 577762574070710271]

-- Simple example where the input is a linestring in GeoJSON format.
SELECT h3_coverash3('{"type":"LineString","coordinates":[[-122.4194,37.7749],[-118.2437,34.0522],[-74.0060,40.7128]]}', 1)
  [582248581512036351, 581698825698148351, 581707621791170559, 581716417884192767, 581641651093503999, 581650447186526207, 581672437419081727]

-- Feeding an empty multipoint in GeoJSON format (as opposed to a linestring, polygon, multilinestring, or multipolygon).
> SELECT h3_coverash3('{"type":"MultiPoint","coordinates":[]}', 2)
  [GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"MultiPoint"' at position 9

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_coverash3(unhex('020700000000'), 2)
  [WKB_PARSE_ERROR] Error parsing WKB: Invalid byte order 2 at position 1

-- Feeding an invalid polygon in WKT (polygon is not closed)
> SELECT h3_coverash3('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-74.0060 40.7128))', 2)
  [WKT_PARSE_ERROR] Error parsing WKT: Found non-closed ring at position 80

-- Resolution is out of range.
> SELECT h3_coverash3('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