通过

h3_try_coverash3string 函数

适用于：已选中“是” Databricks SQL 已选中“是” Databricks Runtime 16.3 及更高版本

此函数的行为与 h3_coverash3string相同，但如果第一个参数无效，则返回 NULL 而不是错误。 它返回表示 H3 单元格 ID 的 BIGINT 值的 ARRAY。 这些值对应于在指定分辨率下完全覆盖输入线性或区域地理的最小六边形或五边形集。

语法

h3_try_coverash3string ( geographyExpr, resolutionExpr )

论据

  • geographyExpr：一个 BINARY 或 STRING 表达式，以 WKB、WKT 或 GeoJSON 格式表示线性（线性字符串或多重线性字符串）或区域性（多边形或多重多边形）地理信息。 地理位置应具有参考 WGS84 坐标参考系的经纬度坐标（以度为单位）。
  • resolutionExpr：一个 INT 表达式，其值介于 0 和 15 包括之间，指定 H3 单元格 ID 的分辨率。

退货

BIGINT 值的 ARRAY，这些值对应于最小的一组具有指定分辨率且完全涵盖输入线性或区域地理的六边形或五边形。

如果任一输入表达式为 NULL，则函数返回 NULL 。 如果第一个输入参数的类型为类型 BINARY，则输入值必须是线字符串、多边形、多行字符串或多多边形的 WKB 说明。 如果第一个输入参数的类型为 STRING，则输入值必须为线串、多边形、多线串或多多边形的 WKT 或 GeoJSON 说明。 输入线字符串、多边形、多行字符串或多多边形的维度可以是 2D、3DZ、3DM 或 4D。 如果第一个参数对应于无效的WKB、WKT或GeoJSON，或者不表示线串、面、多线串或多面，则函数返回NULL。

错误条件

例子

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_coverash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 0)
  [8027fffffffffff,8029fffffffffff,802bfffffffffff,8049fffffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_coverash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 0)
  [8027fffffffffff,8029fffffffffff,802bfffffffffff,8049fffffffffff]

-- Simple example where the input is a linestring in GeoJSON format.
SELECT h3_coverash3string('{"type":"LineString","coordinates":[[-122.4194,37.7749],[-118.2437,34.0522],[-74.0060,40.7128]]}', 1)
  [8148fffffffffff, 8129bffffffffff, 812a3ffffffffff, 812abffffffffff, 81267ffffffffff, 8126fffffffffff, 81283ffffffffff]

-- Feeding an empty multipoint in GeoJSON format (as opposed to a linestring, polygon, multilinestring, or multipolygon).
> SELECT h3_try_coverash3string('{"type":"MultiPoint","coordinates":[]}', 2)
  null

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_try_coverash3string(unhex('020700000000'), 2)
  null

-- Feeding an invalid polygon in WKT (polygon is not closed)
> SELECT h3_try_coverash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-74.0060 40.7128))', 2)
  null

-- Resolution is out of range.
> SELECT h3_try_coverash3string('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