PostGIS 常用函数中文介绍说明

青旅半醒 2022-09-24 14:17 305阅读 0赞

# PostGIS 常用函数中文介绍说明 #

http://www.opensourcegis.org/

postgis 计算函数中文api资料太少，下面给出一些gis函数中文说明

**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()

其他的函数还有可以到官网进行查看

postgis2.0官方文档

地址如下http://postgis.net/docs/manual-2.0/reference.html