类别：

地理空间函数、转换函数

ST_GEOGRAPHYFROMWKT

解析 WKT（已知文本） (link removed) 或 EWKT（扩展的已知文本） 输入，并返回 GEOGRAPHY 类型的值。

别名：

ST_GEOGFROMWKT、ST_GEOGRAPHYFROMEWKT、ST_GEOGFROMEWKT、ST_GEOGRAPHYFROMTEXT、ST_GEOGFROMTEXT

另请参阅：

TO_GEOGRAPHY

语法

ST_GEOGRAPHYFROMWKT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGFROMWKT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGRAPHYFROMEWKT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGFROMEWKT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGRAPHYFROMTEXT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGFROMTEXT( <varchar_expression> [ , <allow_invalid> ] )
Copy

实参

必填：

varchar_expression

实参必须是表示有效地理空间对象的字符串表达式（格式为 WKT 或 EWKT）。

可选：

allow_invalid

如果为 TRUE，即使输入形状无效且无法修复，指定函数也应返回 GEOGRAPHY 或 GEOMETRY 对象。有关详细信息，请参阅 指定如何处理无效的地理空间形状。

返回

该函数返回 GEOGRAPHY 类型的值。

使用说明

  • 如果无法将输入解析为 WKT 或 EWKT，则会引发错误。

  • 如果输入格式为 EWKT 且 SRID 不是 4326，则会引发错误。请参阅 EWKT 和 EWKB 处理备注。

  • 对于 WKT、EWKT 和 GeoJSON 中的坐标，经度在纬度之前显示（例如 POINT(lon lat)）。

示例

以下示例返回以 WKT 格式描述的地理空间对象的 GEOGRAPHY 对象：

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';
Copy
select ST_GEOGRAPHYFROMWKT('POINT(-122.35 37.55)');
Copy
+---------------------------------------------+
| ST_GEOGRAPHYFROMWKT('POINT(-122.35 37.55)') |
|---------------------------------------------|
| POINT(-122.35 37.55)                        |
+---------------------------------------------+

以下示例为具有 Z 坐标（以 WKT 格式描述）的地理空间对象返回 GEOGRAPHY 对象：

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';
Copy
select ST_GEOGRAPHYFROMWKT('POINTZ(-122.35 37.55 30)');
Copy
+-------------------------------------------------+
| ST_GEOGRAPHYFROMWKT('POINTZ(-122.35 37.55 30)') |
|-------------------------------------------------|
| POINTZ(-122.35 37.55 30)                        |
+-------------------------------------------------+

以下示例返回以 EWKT 格式描述的地理空间对象的 GEOGRAPHY 对象：

-- Set the output format to EWKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';
Copy
select ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)');
Copy
+--------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)') |
|--------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                         |
+--------------------------------------------------------+
语言: 中文