Функция h3_longlatash3string

Область применения: Databricks SQL Databricks Runtime 11.3 LTS и выше

Возвращает идентификатор ячейки H3 (в виде шестнадцатеричной строки), соответствующий заданной долготе и широте в указанном разрешении.

Синтаксис

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

Аргументы

• longitudeExpr DOUBLE: выражение, представляющее долготу (в градусах) расположения, идентификатор ячейки H3 которого мы хотим вычислить.
• latitudeExpr DOUBLE: выражение, представляющее широту (в градусах) расположения, идентификатор ячейки H3 которого мы хотим вычислить.
• resolutionExpr INT: выражение, значение которого должно составлять от 0 до 15 включительно, указывая разрешение для идентификатора ячейки H3.

Возвраты

Значение типа STRING, представляющее идентификатор ячейки H3 входного расположения в виде шестнадцатеричной строки при указанном разрешении.

Функция возвращает NULL, если одно из трех входных выражений NULL. Значения вне [-180, 180] для выражения долготы и [-90, 90] для выражения широты сопоставляются с их эквивалентами в этих диапазонах. Ожидается, что значения долготы и широты будут находиться в справочной системе координат WGS84.

Условия ошибок

• Если значение resolutionExpr меньше 0 или больше 15, функция возвращает H3_INVALID_RESOLUTION_VALUE.

Примеры

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

Связанные функции

• h3_longlatash3 функция
• h3_pointash3 функция
• h3_pointash3string функция