名称

ST_PointFromText — 使用给定的 SRID 从 WKT 创建点几何。如果未给定 SRID,则默认为未知。

语法

geometry ST_PointFromText(text WKT);

geometry ST_PointFromText(text WKT, integer srid);

说明

根据 OGC 已知文本表示形式构建 PostGIS ST_Geometry 点对象。如果未给定 SRID,则默认为未知(当前为 0)。如果几何不是 WKT 点表示形式,则返回 null。如果 WKT 完全无效,则抛出错误。

[Note]

ST_PointFromText 函数有 2 个变体,第一个不采用 SRID,并返回一个未定义空间参考系统的几何。第二个将空间参考 ID 作为第二个参数,并返回一个 ST_Geometry,其中包含此 srid 作为其元数据的一部分。srid 必须在 spatial_ref_sys 表中定义。

[Note]

如果你绝对确定所有 WKT 几何都是点,请不要使用此函数。它比 ST_GeomFromText 慢,因为它添加了一个额外的验证步骤。如果你正在从经纬度坐标构建点,并且更关心性能和准确性而不是 OGC 合规性,请使用 ST_MakePoint 或 OGC 合规别名 ST_Point

此方法实现了 SQL 1.1 的 OGC 简单要素实施规范。

s3.2.6.2 - 选项 SRID 来自一致性套件。

此方法实现了 SQL/MM 规范。

SQL-MM 3: 6.1.8

示例

SELECT ST_PointFromText('POINT(-71.064544 42.28787)');
SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);
	

另请参阅

ST_GeomFromTextST_MakePointST_PointST_SRID