Funkcja h3_longlatash3string

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

Zwraca identyfikator komórki H3 (jako ciąg szesnastkowy) odpowiadający podanej długości i szerokości geograficznej w określonej rozdzielczości.

Składnia

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

Argumenty

  • longitudeExpr: Wyrażenie DOUBLE reprezentujące długość geograficzną (w stopniach) lokalizacji, której identyfikator komórki H3 chcemy obliczyć.
  • latitudeExpr: Wyrażenie DOUBLE reprezentujące szerokość geograficzną (w stopniach) lokalizacji, której identyfikator komórki H3 chcemy obliczyć.
  • resolutionExpr: Wyrażenie INT, którego wartość powinna należeć do zakresu od 0 do 15 włącznie, określając rozdzielczość identyfikatora komórki H3.

Zwraca

Wartość typu STRING reprezentującego ciąg szesnastkowy identyfikator komórki H3 lokalizacji wejściowej w określonej rozdzielczości.

Funkcja zwraca wartość NULL, jeśli dowolne z trzech wyrażeń wejściowych ma wartość NULL. Wartości poza [-180, 180] wyrażeniem długości geograficznej i [-90, 90] wyrażenia szerokości geograficznej są mapowane na ich odpowiedniki w tych zakresach. Wartości długości i szerokości geograficznej powinny znajdować się w systemie odniesienia współrzędnych WGS84.

Warunki błędu

Przykłady

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