Функция h3_longlatash3

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

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

Синтаксис

h3_longlatash3 ( longitudeExpr, latitudeExpr, resolutionExpr )

Аргументы

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

Возвраты

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

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

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

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

Примеры

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

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

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