H3_FromPoint - Amazon Redshift
構文引数戻り型例

Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

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