h3_try_polyfillash3string 関数

  • [アーティクル]

適用対象: check marked yes Databricks SQL Databricks Runtime 11.3 LTS 以降

最初の引数が無効な場合にエラーの代わりに NULL が返されることを除き、h3_polyfillash3string と同じ動作をします。 より正確には、入力された面状の地理的な場所に含まれているもので、指定した解像度の六角形または五角形に対応する H3 セル ID (STRING として表されます) の ARRAY を返します。

構文

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

引数

  • geographyExpr: WKB、WKT、または GeoJSON での地域の地理的な場所 (ポリゴンまたはマルチポリゴン) を表す BINARY または STRING 式。 地理的な場所には、WGS84 座標参照系を参照する経度と緯度の座標が必要です。
  • resolutionExpr: H3 セルの解像度を指定する、値が 0 から 15 の範囲である INT 式。

戻り値

入力地域の地理的な場所に含まれる、指定した解像度の H3 セル ID に対応する STRING 値の配列。

いずれかの入力式が 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_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