Поделиться через

Функция 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