postgis空间函数说明

缺乏、安全感 2021-09-29 02:24 458阅读 0赞

## **微信搜索：“二十同学” 公众号，欢迎关注一条不一样的成长之路** ##

## PostGIS的具体函数详细了解以及用法例子可以到官网查看: [http://postgis.net/docs/reference.html][http_postgis.net_docs_reference.html] ##

# **1.OGC标准函数** #

### **管理函数：**  ###

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

### **几何对象关系函数 ：** ###

**获取两个几何对象间的距离 ST\_Distance(geometry, geometry)   
如果两个几何对象间距离在给定值范围内，则返回TRUE ST\_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, geometry B)   
返回两个几何对象的合并结果 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,\[\])

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)

# **2. PostGIS扩展函数** #

### **管理函数：** ###

删除一个空间表（包括geometry\_columns中的记录） DropGeometryTable(\[\], )   
更新空间表的空间参考 UpdateGeometrySRID(\[\], , , )   
更新空间表的统计信息 update\_geometry\_stats(\[, \])

**参考语义：**

Geos：GEOS库   
Jts：JTS库   
Proj：PROJ4库 postgis\_version()

postgis\_lib\_version()   
postgis\_lib\_build\_date()   
postgis\_script\_build\_date()   
postgis\_scripts\_installed()   
postgis\_scripts\_released()   
postgis\_geos\_version()   
postgis\_jts\_version()   
postgis\_proj\_version()   
postgis\_uses\_stats()   
postgis\_full\_version()

### **几何操作符：** ###

A范围=B范围 A = B   
A范围覆盖B范围或A范围在B范围左侧 A &<> B   
A范围在B范围左侧 A <<>> B   
A范围覆盖B范围或A范围在B范围下方 A &<| B A范围覆盖B范围或A范围在B范围上方 A |&> B   
A范围在B范围下方 A <<| B A范围在B范围上方 A |>> B   
A=B A ~= B   
A范围被B范围包含 A @ B   
A范围包含B范围 A ~ B   
A范围覆盖B范围 A && B

### **几何量测函数：** ###

量测面积 ST\_Area(geometry)   
根据经纬度点计算在地球曲面上的距离，单位米，地球半径取值6370986米 ST\_distance\_sphere(point, point)   
类似上，使用指定的地球椭球参数 ST\_distance\_spheroid(point, point, spheroid)   
量测2D对象长度 ST\_length2d(geometry)   
量测3D对象长度 ST\_length3d(geometry)   
根据经纬度对象计算在地球曲面上的长度 ST\_length\_spheroid(geometry,spheroid)   
ST\_length3d\_spheroid(geometry,spheroid)   
量测两个对象间距离 ST\_distance(geometry, geometry)   
量测两条线之间的最大距离 ST\_max\_distance(linestring,linestring)   
量测2D对象的周长 ST\_perimeter(geometry)   
ST\_perimeter2d(geometry)   
量测3D对象的周长 ST\_perimeter3d(geometry)   
量测两点构成的方位角，单位弧度 ST\_azimuth(geometry, geometry)

### **几何对象输出：**  ###

参考语义：   
NDR：Little Endian   
XDR：big-endian   
HEXEWKB：Canonical   
SVG：SVG 格式   
GML：GML 格式   
KML：KML 格式   
GeoJson：GeoJson 格式

ST\_AsBinary(geometry,\{‘NDR’|’XDR’\})   
ST\_AsEWKT(geometry)   
ST\_AsEWKB(geometry, \{‘NDR’|’XDR’\})   
ST\_AsHEXEWKB(geometry, \{‘NDR’|’XDR’\})   
ST\_AsSVG(geometry, \[rel\], \[precision\])   
ST\_AsGML(\[version\], geometry, \[precision\])   
ST\_AsKML(\[version\], geometry, \[precision\])   
ST\_AsGeoJson(\[version\], geometry, \[precision\], \[options\])

### **几何对象创建：** ###

参考语义：   
Dump：转储 ST\_GeomFromEWKT(text)

ST\_GeomFromEWKB(bytea)   
ST\_MakePoint(, , \[\], \[\])   
ST\_MakePointM(, , )   
ST\_MakeBox2D(, )   
ST\_MakeBox3D(, )   
ST\_MakeLine(geometry set)   
ST\_MakeLine(geometry, geometry)   
ST\_LineFromMultiPoint(multipoint)   
ST\_MakePolygon(linestring, \[linestring\[\]\])   
ST\_BuildArea(geometry)   
ST\_Polygonize(geometry set)   
ST\_Collect(geometry set)   
ST\_Collect(geometry, geometry)   
ST\_Dump(geometry)   
ST\_DumpRings(geometry)

### **几何对象编辑：** ###

给几何对象添加一个边界，会使查询速度加快 ST\_AddBBOX(geometry)   
删除几何对象的边界 ST\_DropBBOX(geometry)   
添加、删除、设置点 ST\_AddPoint(linestring, point, \[\])   
ST\_RemovePoint(linestring, offset)   
ST\_SetPoint(linestring, N, point)   
几何对象类型转换 ST\_Force\_collection(geometry)   
ST\_Force\_2d(geometry)   
ST\_Force\_3dz(geometry), ST\_Force\_3d(geometry),   
ST\_Force\_3dm(geometry)   
ST\_Force\_4d(geometry)   
ST\_Multi(geometry)   
将几何对象转化到指定空间参考 ST\_Transform(geometry,integer)   
对3D几何对象作仿射变化 ST\_Affine(geometry, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8)   
对2D几何对象作仿射变化 ST\_Affine(geometry, float8, float8, float8, float8, float8, float8)   
对几何对象作偏移 ST\_Translate(geometry, float8, float8, float8)   
对几何对象作缩放 ST\_Scale(geometry, float8, float8, float8)   
对3D几何对象作旋转 ST\_RotateZ(geometry, float8)   
ST\_RotateX(geometry, float8)   
ST\_RotateY(geometry, float8)   
对2D对象作偏移和缩放 ST\_TransScale(geometry, float8, float8, float8, float8)   
反转 ST\_Reverse(geometry)   
转化到右手定则 ST\_ForceRHR(geometry)   
参考IsSimple函数   
使用Douglas-Peuker算法 ST\_Simplify(geometry, tolerance)   
ST\_SimplifyPreserveTopology(geometry, tolerance)   
讲几何对象顶点捕捉到网格 ST\_SnapToGrid(geometry, originX, originY, sizeX, sizeY)   
ST\_SnapToGrid(geometry, sizeX, sizeY), ST\_SnapToGrid(geometry, size)   
第二个参数为点，指定原点坐标 ST\_SnapToGrid(geometry, geometry, sizeX, sizeY, sizeZ, sizeM)   
分段 ST\_Segmentize(geometry, maxlength)   
合并为线 ST\_LineMerge(geometry)

### **线性参考：** ###

根据location（0-1）获得该位置的点 ST\_line\_interpolate\_point(linestring, location)   
获取一段线 ST\_line\_substring(linestring, start, end)   
根据点获取location（0-1） ST\_line\_locate\_point(LineString, Point)   
根据量测值获得几何对象 ST\_locate\_along\_measure(geometry, float8)   
根据量测值区间获得几何对象集合 ST\_locate\_between\_measures(geometry, float8, float8)

### **杂项功能函数：**  ###

几何对象的摘要 ST\_Summary(geometry)   
几何对象的边界 ST\_box2d(geometry)   
ST\_box3d(geometry)   
多个几何对象的边界 ST\_extent(geometry set)   
0=2d, 1=3dm, 2=3dz, 3=4d ST\_zmflag(geometry)   
是否包含Bounding Box ST\_HasBBOX(geometry)   
几何对象的维数：2、3、4 ST\_ndims(geometry)   
子对象的个数 ST\_nrings(geometry)   
ST\_npoints(geometry)   
对象是否验证成功 ST\_isvalid(geometry)   
扩大几何对象 ST\_expand(geometry, float)   
计算一个空间表的边界范围 ST\_estimated\_extent(\[schema\], table, geocolumn)   
获得空间参考 ST\_find\_srid(, , )   
几何对象使用的内存大小，单位byte ST\_mem\_size(geometry)   
点是否在圆上 ST\_point\_inside\_circle(,,,)   
获取边界的X、Y、Z ST\_XMin(box3d)   
ST\_YMin(box3d)   
ST\_ZMin(box3d)   
ST\_XMax(box3d)   
ST\_YMax(box3d)   
ST\_ZMax(box3d)   
构造一个几何对象的数组 ST\_Accum(geometry set)

### **长事务支持：**  ###

启用/关闭长事务支持，重复调用无副作用 EnableLongTransactions()   
DisableLongTransactions()   
检查对行的update和delete操作是否已授权 CheckAuth(\[\],   
, )   
锁定行 LockRow(\[\], , , , \[\])   
解锁行 UnlockRows()   
在当前事务中添加授权ID AddAuth()

[http_postgis.net_docs_reference.html]: http://postgis.net/docs/reference.html