

 Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。

# H3\$1FromPoint
<a name="H3_FromPoint-function"></a>

H3\$1FromPoint は、入力されたジオメトリポイントおよび解像度から対応する H3 セル ID を返します。H3 インデックスの詳細については、「[H3](spatial-terminology.md#spatial-terminology-h3)」を参照してください。

## 構文
<a name="H3_FromPoint-function-syntax"></a>

```
H3_FromPoint(geom, resolution)
```

## 引数
<a name="H3_FromPoint-function-arguments"></a>

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

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

## 戻り型
<a name="H3_FromPoint-function-return"></a>

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

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

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

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

## 例
<a name="H3_FromPoint-function-examples"></a>

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

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

```
 h3_frompoint
-------------------
 623560421467684863
```