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/)を参照してください。

# ST\$1LineInterpolatePoint
<a name="ST_LineInterpolatePoint-function"></a>

ST\$1LineInterpolatePoint は、ラインの開始点からの分数距離にあるラインに沿ったポイントを返します。

ポイントの等価性を判断するために、ST\$1LineInterpolatePoint は、入力ジオメトリの 2D 射影を処理します。入力ジオメトリが空の場合、入力のコピーが同じディメンションで返されます。3DZ、3DM、4D ジオメトリの場合、`z` または `m` 座標は、ポイントが置かれているセグメントの `z` または `m` 座標の平均になります。

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

```
ST_LineInterpolatePoint(geom, fraction)
```

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

 *geom*   
データ型 `GEOMETRY` の値または `GEOMETRY` 型と評価される式の値。サブタイプは `LINESTRING` です。

 *分数*   
ラインのライン文字列に沿った点の位置を表すデータ型 `DOUBLE PRECISION` の値。値は、0～1 の範囲の小数部です。

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

`GEOMETRY`サブタイプ の `POINT`。

*geom* または *fraction* が null の場合、null が返されます。

*geom* が空の場合、空のポイントが返されます。

返されたジオメトリの空間リファレンスシステム識別子 (SRID) 値が、入力ジオメトリの SRID 値です。

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

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

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

次の SQL は、ライン文字列に沿ってポイントを返します。

```
SELECT ST_AsEWKT(ST_LineInterpolatePoint(ST_GeomFromText('LINESTRING(0 0, 5 5, 7 7, 10 10)'), 0.50));
```

```
st_asewkt
-----------
 POINT(5 5)
```

次の SQL は、ライン文字列に沿って 90% のポイントを返します。

```
SELECT ST_AsEWKT(ST_LineInterpolatePoint(ST_GeomFromText('LINESTRING(0 0, 5 5, 7 7, 10 10)'), 0.90));
```

```
st_asewkt
-----------
 POINT(9 9)
```