Fonction h3_longlatash3string

  • Article

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

Retourne l’ID de cellule H3 (sous forme de STRING héxadecimale) correspondant à la longitude et à la latitude fournies, à la résolution spécifiée.

Syntaxe

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

Arguments

  • longitudeExpr : expression DOUBLE représentant la longitude (en degrés) de l’emplacement dont nous souhaitons calculer l’ID de cellule H3.
  • latitudeExpr : expression DOUBLE représentant la latitude (en degrés) de l’emplacement dont nous souhaitons calculer l’ID de cellule H3.
  • resolutionExpr : expression INT dont la valeur doit être comprise entre 0 et 15 inclus, en spécifiant la résolution de l’ID de cellule H3.

Retours

Valeur de type STRING représentant, sous forme de chaîne hexadécimale, l’ID de cellule H3 de l’emplacement d’entrée à la résolution spécifiée.

La fonction retourne NULL si l’une des trois expressions d’entrée est NULL. Les valeurs extérieures [-180, 180] pour l’expression de longitude et [-90, 90] pour l’expression de latitude sont mappées à leurs équivalents au sein de ces plages. Les valeurs de longitude et de latitude sont attendues dans le système de référence des coordonnées WGS84.

Conditions d'erreur

Exemples

-- Simple example.
> SELECT h3_longlatash3string(100, 45, 6)
  86240610fffffff

-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_longlatash3string(-122.4783, 37.8199, 13)
  8d283087022a93f

-- Resolution is out of range.
> SELECT h3_longlatash3string(-122.4783, 37.8199, 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive