Функция h3_try_polyfillash3string

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

Ведет себя так же, как h3_polyfillash3string, за исключением того, что NULL возвращается вместо ошибки, если первый аргумент недопустим. Точнее, возвращает ARRAY идентификаторы ячеек H3 (представленные как STRING) соответствующие шестнадцатеричным или пентагонам, из указанного разрешения, центроиды которых содержатся в входных данных являются географическими.

Синтаксис

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

Аргументы

  • geographyExpr: выражение BINARYSTRING, представляющее ареальную географию (многоугольник или многополигон) в WKB, WKT или GeoJSON. Ожидается, что география будет иметь координаты долготы и широты в градусах в системе координат WGS84.
  • resolutionExpr INT: выражение, значение которого должно находиться между 0 и 15 инклюзивным, указывая разрешение для ячеек H3.

Возвраты

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

Функция возвращается NULL , если какой-либо из входных выражений имеет значение NULL. Если первый входной аргумент имеет тип BINARY, входное значение, как ожидается, будет описание WKB многоугольника или многоугольника. Если первый входной аргумент имеет тип STRING, входное значение, как ожидается, будет либо WKT , либо описание GeoJSON многоугольника или многоугольника. Число измерений входного многоугольника или множества многоугольников может быть 2D, 3DZ, 3DM или 4D. Функция возвращается NULL , если первый аргумент соответствует недопустимому WKB, WKT или GeoJSON или не представляет многоугольник или многополигон.

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

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

Примеры

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2);
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_try_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2);
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- The input is invalid.
> SELECT h3_try_polyfillash3string('Not-a-valid-rep', 2);
  null

-- Resolution is out of range.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 16);
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive
  • Last updated on