41. 附录 A:PostGIS 函数

41.1. 构造器

ST_MakePoint(Longitude, Latitude)

返回一个新的点。注意坐标分量的顺序(先经度,然后纬度)。

ST_GeomFromText(WellKnownText, srid)

输入 WKT 字符串和 srid 并返回一个新的几何对象。

ST_SetSRID(geometry, srid)

更新几何图形的空间参考标识符(SRID)。该函数返回原几何图形(坐标值不变),仅更新其SRID值,适用于处理未定义空间参考的几何数据。

ST_Expand(geometry, Radius)

返回一个基于输入几何图形扩展后的边界框新几何图形。该函数适用于为索引搜索创建包络范围。

41.2. 输出

ST_AsText(geometry)

返回几何图形的可读文本格式。

ST_AsGML(geometry)

返回符合OGC标准 :term:`GML`格式的几何图形表示。

ST_AsGeoJSON(geometry)

将一个几何对象转为标准的 GeoJSON 格式。

41.3. 量测

ST_Area(geometry)

返回基于坐标系单位的几何对象的面积。

ST_Length(geometry)

返回几何图形在空间参考系单位下的长度值。

ST_Perimeter(geometry)

返回几何图形在空间参考系单位下的周长值。

ST_NumPoints(linestring)

返回线串图形中的顶点数量。

ST_NumRings(polygon)

返回 Polygon 中 Ring 的数量。

ST_NumGeometries(geometry)

返回几何容器(GeometryCollection)中几何对象的个数。

41.4. 关系查询

ST_Distance(geometry, geometry)

返回两几何对象间的距离值,其计量单位与空间参考系统(SRID)定义保持一致。

ST_DWithin(geometry, geometry, radius)

若两个几何对象之间的距离小于等于指定半径值则返回 true,否则返回 false。

ST_Intersects(geometry, geometry)

若几何图形非相离(即存在空间交集)则返回 true,否则返回 false。

ST_Contains(geometry, geometry)

若第一个几何图形完全包含第二个几何图形则返回 true,否则返回 false。

ST_Crosses(geometry, geometry)

如果一条线或多边形边界与另一条线或多边形边界相交,则返回 true,否则返回 false。