PostgreSQL 空间处理函数

清疚 2021-10-09 10:34 397阅读 0赞

PostGIS中的常用函数

以下内容包括比较多的尖括号，发布到blogger的时候会显示不正常，内容太多我也无暇一个个手动改代码，因此如有问题就去参考PostGIS官方文档。

首先需要说明一下，这里许多函数是以ST\_\[X\]yyy形式命名的，事实上很多函数也可以通过xyyy的形式访问，在PostGIS的函数库中我们可以看到这两种函数定义完全一样。

1. OGC标准函数

管理函数：  
添加几何字段 AddGeometryColumn(, , , , , )  
删除几何字段 DropGeometryColumn(, , )  
检查数据库几何字段并在geometry\_columns中归档 Probe\_Geometry\_Columns()  
给几何对象设置空间参考（在通过一个范围做空间查询时常用）ST\_SetSRID(geometry, integer)

几何对象关系函数：  
获取两个几何对象间的距离                                                                                        ST\_Distance(geometry, geometry)  
如果两个几何对象间距离在给定值范围内，则返回                                                    TRUEST\_DWithin(geometry, geometry, float)  
判断两个几何对象是否相等  
（比如LINESTRING(0 0, 2 2)和LINESTRING(0 0, 1 1, 2 2)是相同的几何对象）      ST\_Equals(geometry, geometry)  
判断两个几何对象是否分离                                                                                         ST\_Disjoint(geometry, geometry)  
判断两个几何对象是否相交                                                                                         ST\_Intersects(geometry, geometry)  
判断两个几何对象的边缘是否接触                                                                              ST\_Touches(geometry, geometry)  
判断两个几何对象是否互相穿过                                                                                  ST\_Crosses(geometry, geometry)  
判断A是否被B包含                                                                                                       ST\_Within(geometry A, geometry B)  
判断两个几何对象是否是重叠                                                                                      ST\_Overlaps(geometry, geometry)  
判断A是否包含B                                                                                                          ST\_Contains(geometry A, geometry B)  
判断A是否覆盖 B                                                                                                         ST\_Covers(geometry A, geometry B)  
判断A是否被B所覆盖                                                                                                   ST\_CoveredBy(geometry A, geometry B)  
通过DE-9IM 矩阵判断两个几何对象的关系是否成立                                                   ST\_Relate(geometry, geometry, intersectionPatternMatrix)  
获得两个几何对象的关系（DE-9IM矩阵）                                                                   ST\_Relate(geometry, geometry)

几何对象处理函数：  
获取几何对象的中心                                                                                                      ST\_Centroid(geometry)  
面积量测                                                                                                                        ST\_Area(geometry)  
长度量测                                                                                                                        ST\_Length(geometry)  
返回曲面上的一个点                                                                                                      ST\_PointOnSurface(geometry)  
获取边界                                                                                                                        ST\_Boundary(geometry)  
获取缓冲后的几何对象                                                                                                   ST\_Buffer(geometry, double,\[integer\])  
获取多几何对象的外接对象                                                                                            ST\_ConvexHull(geometry)  
获取两个几何对象相交的部分                                                                                        ST\_Intersection(geometry, geometry)  
将经度小于0的值加360使所有经度值在0-360间                                                            ST\_Shift\_Longitude(geometry)  
获取两个几何对象不相交的部分（A、B可互换）                                                          ST\_SymDifference(geometry A,geometry B)  
从A去除和B相交的部分后返回                                                                                      ST\_Difference(geometry A, geometryB)  
返回两个几何对象的合并结果                                                                                       ST\_Union(geometry, geometry)  
返回一系列几何对象的合并结果                                                                                    ST\_Union(geometry set)  
用较少的内存和较长的时间完成合并操作，结果和ST\_Union相同 ST\_MemUnion(geometry set)

几何对象存取函数：  
获取几何对象的WKT描述 ST\_AsText(geometry)  
获取几何对象的WKB描述 ST\_AsBinary(geometry)  
获取几何对象的空间参考ID ST\_SRID(geometry)  
获取几何对象的维数 ST\_Dimension(geometry)  
获取几何对象的边界范围 ST\_Envelope(geometry)  
判断几何对象是否为空 ST\_IsEmpty(geometry)  
判断几何对象是否不包含特殊点（比如自相交）ST\_IsSimple(geometry)  
判断几何对象是否闭合 ST\_IsClosed(geometry)  
判断曲线是否闭合并且不包含特殊点 ST\_IsRing(geometry)  
获取多几何对象中的对象个数 ST\_NumGeometries(geometry)  
获取多几何对象中第N个对象 ST\_GeometryN(geometry,int)  
获取几何对象中的点个数 ST\_NumPoints(geometry)  
获取几何对象的第N个点 ST\_PointN(geometry,integer)  
获取多边形的外边缘 ST\_ExteriorRing(geometry)  
获取多边形内边界个数 ST\_NumInteriorRings(geometry)  
同上 ST\_NumInteriorRing(geometry)  
获取多边形的第N个内边界 ST\_InteriorRingN(geometry,integer)  
获取线的终点 ST\_EndPoint(geometry)  
获取线的起始点 ST\_StartPoint(geometry)  
获取几何对象的类型 GeometryType(geometry)  
类似上，但是不检查M值，即POINTM对象会被判断为point ST\_GeometryType(geometry)  
获取点的X坐标 ST\_X(geometry)  
获取点的Y坐标 ST\_Y(geometry)  
获取点的Z坐标 ST\_Z(geometry)  
获取点的M值 ST\_M(geometry)

几何对象构造函数：  
参考语义：  
Text：WKT  
WKB：WKB  
Geom:Geometry  
M:Multi  
Bd:BuildArea  
Coll:Collection ST\_GeomFromText(text,\[\])    将wkt转为geometry

ST\_PointFromText(text,\[\])  
ST\_LineFromText(text,\[\])  
ST\_LinestringFromText(text,\[\])  
ST\_PolyFromText(text,\[\])  
ST\_PolygonFromText(text,\[\])  
ST\_MPointFromText(text,\[\])  
ST\_MLineFromText(text,\[\])  
ST\_MPolyFromText(text,\[\])  
ST\_GeomCollFromText(text,\[\])  
ST\_GeomFromWKB(bytea,\[\])  
ST\_GeometryFromWKB(bytea,\[\])  
ST\_PointFromWKB(bytea,\[\])  
ST\_LineFromWKB(bytea,\[\])  
ST\_LinestringFromWKB(bytea,\[\])  
ST\_PolyFromWKB(bytea,\[\])  
ST\_PolygonFromWKB(bytea,\[\])  
ST\_MPointFromWKB(bytea,\[\])  
ST\_MLineFromWKB(bytea,\[\])  
ST\_MPolyFromWKB(bytea,\[\])  
ST\_GeomCollFromWKB(bytea,\[\])  
ST\_BdPolyFromText(text WKT, integer SRID)  
ST\_BdMPolyFromText(text WKT, integer SRID)