Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 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\$1GeomFromGeoJSON
<a name="ST_GeomFromGeoJSON-function"></a>

ST\$1GeomFromGeoJSON 會從輸入幾何的 GeoJSON 表示法建構幾何物件。如需 GeoJSON 格式的相關資訊，請參閱 Wikipedia 中的 [GeoJSON](https://en.wikipedia.org/wiki/GeoJSON)。

如果至少有一個點具有三個或更多座標，則產生的幾何圖形為 3DZ，其中對於僅具有兩個座標的點，Z 分量為零。如果輸入 GeoJSON 中的所有點都包含兩個座標或為空，則 ST\$1GeomFromGeoJSON 會傳回 2D 幾何。傳回幾何的空間參考系統識別碼 (SRID) 一律為 4326。

## 語法
<a name="ST_GeomFromGeoJSON-function-syntax"></a>

```
ST_GeomFromGeoJSON(geojson_string)
```

## 引數
<a name="ST_GeomFromGeoJSON-function-arguments"></a>

 *geojson\$1string*   
`VARCHAR` 或 `SUPER` 資料類型的值，或評估為 `VARCHAR` 類型的表達式，也就是幾何的 GeoJSON 表示法。

## 傳回類型
<a name="ST_GeomFromGeoJSON-function-return"></a>

`GEOMETRY`

如果 *geojson\$1string* 為 null，則傳回 null。

如果 *geojson\$1string* 無效，則會傳回錯誤。

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

以下 SQL 傳回輸入 GeoJSON 中表示的二維幾何。

```
SELECT ST_AsEWKT(ST_GeomFromGeoJSON('{"type":"Point","coordinates":[1,2]}'));
```

```
 st_asewkt       
-----------------------
 SRID=4326;POINT(1 2)
```

以下 SQL 傳回輸入 GeoJSON 中表示的 3DZ 幾何。

```
SELECT ST_AsEWKT(ST_GeomFromGeoJSON('{"type":"LineString","coordinates":[[1,2,3],[4,5,6],[7,8,9]]}'));
```

```
 st_asewkt  
------------------------------------------
 SRID=4326;LINESTRING Z (1 2 3,4 5 6,7 8 9)
```

當輸入 GeoJSON 中只有一個點具有三個座標而所有其他點都具有兩個座標時，以下 SQL 傳回 3DZ 幾何。

```
SELECT ST_AsEWKT(ST_GeomFromGeoJSON('{"type":"Polygon","coordinates":[[[0, 0],[0, 1, 8],[1, 0],[0, 0]]]}'));
```

```
 st_asewkt  
------------------------------------------------
 SRID=4326;POLYGON Z ((0 0 0,0 1 8,1 0 0,0 0 0))
```