Java系列之数据库geometry的相关函数

柔情只为你懂 2024-03-23 18:25 101阅读 0赞

#### 文章目录 ####

*  前言
 *  一、geometry是什么？
 *  二、geometry常用函数
 *   *  1.OGC标准函数
     *   *  ①管理函数
         *  ②几何对象关系函数
         *  ③几何对象处理函数
         *  ④几何对象存取函数
         *  ⑤几何对象构造函数
     *  2.PostGIS扩展函数
     *   *  ①管理函数
         *  ②几何操作符
         *  ③几何量测函数
         *  ④几何对象输出
         *  ⑤几何对象创建
         *  ⑥几何对象编辑
         *  ⑦线性参考
         *  ⑧杂项功能函数
 *  总结

--------------------

## 前言 ##

当涉及到处理空间数据（如地理位置、地图、几何形状等）时，数据库中的Geometry函数成为了不可或缺的工具。Geometry函数提供了各种功能和操作，使得在数据库中存储和查询空间数据变得更加便捷和灵活。这些函数允许我们对几何对象进行创建、修改、分析和查询，从而能够处理和展示与地理位置相关的信息。

在数据库中，Geometry函数的使用可以涵盖多个方面，例如：

1.  几何对象的创建和存储：Geometry函数允许我们创建和存储各种几何对象，如点(Point)、线(Line)、多边形(Polygon)等。通过这些函数，我们可以定义和保存空间数据，以便日后进行查询和分析。
2.  几何对象的编辑和变换：Geometry函数提供了丰富的功能来编辑和变换几何对象。我们可以通过函数调整几何对象的大小、位置和形状，进行平移、旋转、缩放等操作，以满足特定需求。
3.  空间关系和拓扑分析：Geometry函数还支持对几何对象之间的空间关系进行分析。我们可以检查两个几何对象是否相交、是否包含于某个区域、是否相邻等。这些分析可以用于空间查询和空间数据挖掘。
4.  空间索引和查询优化：Geometry函数允许我们创建空间索引，以提高对空间数据的查询性能。通过合理地使用索引，可以加快空间查询的速度，提高整体数据库的效率。

需要注意的是，不同的数据库系统对Geometry函数的支持和语法可能会有所差异。一些主流数据库系统如MySQL、PostgreSQL和Oracle都提供了自己的Geometry函数库，同时也有一些开源的空间数据库系统（如PostGIS）专注于提供更丰富的Geometry函数和功能。

综上所述，Geometry函数在数据库中扮演着重要的角色，为处理和分析空间数据提供了强大的工具。通过合理地应用这些函数，我们能够更好地利用数据库来存储、查询和分析与地理位置相关的信息，从而实现更多样化和细致化的数据操作。

--------------------

## 一、geometry是什么？ ##

Geometry类型是一种在数据库中用于存储和处理空间数据的数据类型。它是一种用于表示几何对象（如点、线、多边形等）的结构化数据类型。在数据库系统中，常见的几何类型包括Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon等。

每个几何类型都具有特定的结构和属性，可以用来表示不同的空间对象。例如，Point表示一个点，由具体的坐标组成；LineString表示一条连续的线段，由多个点按顺序连接而成；Polygon表示一个封闭的区域，由多个边界线段组成，并且具有内部和外部区域。

几何类型的存储和操作可以在数据库系统中进行。数据库系统通常提供了相关的函数和操作符来处理几何类型数据，例如，计算几何对象之间的距离、判断两个几何对象是否相交、获取几何对象的边界等。这些函数和操作符可以用于查询和分析空间数据，并支持地理信息系统（GIS）和其他空间应用的开发。

几何类型的使用可以使数据库系统具备空间分析和空间查询的能力，使得存储和处理与地理位置相关的数据更加方便和高效。数据库系统如PostgreSQL、MySQL、Oracle等都提供了几何类型的支持，并且通常还提供了对应的几何函数库，以便进行更复杂的几何操作和分析。

需要注意的是，不同的数据库系统对几何类型的支持和实现可能会有所不同，因此在具体开发中，需要查阅相关数据库文档以了解特定数据库系统的几何类型和函数的使用方法。

## 二、geometry常用函数 ##

总结几何常用函数的目的是提供开发人员一个方便的参考和指南，帮助他们更好地理解、学习和应用这些函数。通过简明扼要地总结函数的功能、用法和最佳实践，这个资源可以帮助开发人员快速查找和调用所需的几何函数，促进他们对几何数据处理的理解和应用能力，以及遵循标准化和最佳实践，从而提高开发效率和代码质量。

### 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

--------------------

## 总结 ##

**关注微信公众号：CV算法小屋 获取更多用法**