ST_GeographyFromText

将熟知文本 (WKT) 字符串转换为其对应的 GEOGRAPHY 对象。使用此函数可将 WKT 字符串转换为 Vertica Place 函数所需的格式。

GEOGRAPHY 对象是在地球表面使用坐标 (longitude, latitude) 定义的空间对象。坐标使用划分地球的参考平面的度数（经度、纬度）表示。

GEOGRAPHY 对象的最大大小为 10 MB。如果将 WKT 传递给 ST_GeographyFromText 并且生成大小超过 10 MB 的空间对象，ST_GeographyFromText 将会返回错误。

开放地理空间联盟 (OGC) 在 OGC 简易功能访问第 1 部分 - 通用架构规范的第 7 节定义了 WKT 字符串的格式。

行为类型

不可变

语法

ST_GeographyFromText( wkt [ USING PARAMETERS ignore_errors={'y'|'n'} ] )

参数

wkt

GEOGRAPHY 对象的熟知文本 (WKT) 字符串，类型为 LONG VARCHAR

ignore_errors

（可选）ST_GeographyFromText 将基于提供的参数返回以下结果：

• NULL—如果 wkt 无效并且 ignore_errors='y'。

• Error—如果 wkt 无效并且 ignore_errors='n' 或未指定。

返回

GEOGRAPHY

支持的数据类型

示例

以下示例显示了 ST_GeographyFromText 的用法。

将 WKT 转换为 GEOGRAPHY 对象：

=> CREATE TABLE wkt_ex (g GEOGRAPHY);
 CREATE TABLE
=> INSERT INTO wkt_ex VALUES(ST_GeographyFromText('POLYGON((1 2,3 4,2 3,1 2))'));
 OUTPUT
--------
      1
(1 row)