H3_FromPoint

H3_FromPoint は、入力されたジオメトリポイントおよび解像度から対応する H3 セル ID を返します。H3 インデックスの詳細については、「H3」を参照してください。

構文

H3_FromPoint(geom, resolution)

引数

geom

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。geom は POINT である必要があります。

resolution

データ型 INTEGER の値または INTEGER 型と評価される式の値。この値は H3 グリッドシステムの解像度を表します。この値は 0〜15 の整数である必要があります。0 が最も粗く、15 が最も細かいです。

戻り型

BIGINT — H3 セル ID を表します。

geom が POINT でない場合、エラーが返されます。

resolution が範囲外の場合、エラーが返されます。

geom が空の場合、NULL が返されます。

例

次の SQL は、ポイント 0,0 と解像度 10 から H3 セル ID を返します。

SELECT H3_FromPoint(ST_GeomFromText('POINT(0 0)'), 10);

 h3_frompoint
-------------------
 623560421467684863