Funkcja h3_longlatash3

  • 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 BIGINT) odpowiadający podanej długości i szerokości geograficznej w określonej rozdzielczości.

Składnia

h3_longlatash3 ( 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 BIGINT reprezentująca 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_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