h3_try_polyfillash3 関数

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

h3_polyfillash3 と同じように動作しますが、最初の引数が無効な場合はエラーではなく NULL が返される点が異なります。 より正確には、指定された解像度の六角形または五角形に対応する H3 セル ID (ARRAY として表される) のBIGINTを返します。この重心は入力の地理的位置に含まれています。

構文

h3_try_polyfillash3 ( geographyExpr, resolutionExpr )

引数

  • geographyExpr: BINARY、STRING、または GeoJSON の等角地理 (多角形またはマルチポリゴン) を表す式または式。 地理的な場所には、WGS84 座標参照系を参照する経度と緯度の座標が必要です。
  • resolutionExpr: INT 式。値が 0 と 15 の間にあると予想され、H3 セルの解像度を指定します。

戻り値

入力に重心が含まれる、指定した解像度の H3 セル ID に対応するARRAY値のBIGINT。

入力式のいずれかが NULL の場合、この関数は NULL を返します。 最初の入力引数が BINARY 型の場合、入力値は多角形またはマルチポリゴンの WKB 記述であることが期待されます。 最初の入力引数が STRING型の場合、入力値は、多角形またはマルチポリゴンの WKT または GeoJSON の説明である必要があります。 入力多角形またはマルチポリゴンの次元は、2D、3DZ、3DM、または 4D にすることができます。 この関数は、最初の引数が無効な NULL、WKT、または GeoJSON に対応しているか、多角形またはマルチポリゴンを表していない場合に、を返します。

エラー条件

例

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_try_polyfillash3('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2);
  [586146350232502271,586147449744130047,586198577034821631,586152397546455039,586199676546449407,586153497058082815,586142501941805055,586201325813891071]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_try_polyfillash3(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2);
  [586146350232502271,586147449744130047,586198577034821631,586152397546455039,586199676546449407,586153497058082815,586142501941805055,586201325813891071]

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

-- Resolution is out of range.
> SELECT h3_try_polyfillash3('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
  • 最終更新: