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

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