Fonction h3_longlatash3

  • 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 (en tant que BIGINT) correspondant à la longitude et à la latitude fournies à la résolution spécifiée.

Syntaxe

h3_longlatash3 ( 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 de BIGINT représentant 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_longlatash3(100, 45, 6)
  604116085645508607

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

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