Funkcja h3_longlatash3
Dotyczy:
Databricks SQL 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.
Values poza [-180, 180] dla wyrażenia długości geograficznej, a [-90, 90] dla wyrażenia szerokości geograficznej są mapowane na ich odpowiedniki w tych zakresach.
Długość geograficzna i szerokość geograficzna values powinny znajdować się w systemie odniesienia współrzędnych WGS84.
Warunki błędu
- Jeśli
resolutionExprfunkcja jest mniejsza lub większa niż015, funkcja zwraca H3_INVALID_RESOLUTION_VALUE.
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