Name

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

Synopsis

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);