PostGreSQL（五）PostGIS-常用函数

PostGIS中的常用函数

图形和地理位置

• ST_GeometryType(geometry) —— 返回几何图形的类型

• ST_Transform(geometry, srid)——将几何图形投影为地理坐标数据 或 转换为不同srid坐标系统的坐标数据

• Geography(geometry)——将基于EPSG:4326(srid=4326)的geometry数据类型转换为geography数据类型

• ST_NDims(geometry) —— 返回几何图形的维数

• ST_SRID(geometry) —— 返回几何图形的空间参考标识码 srid

• ST_SetSRID(geometry，SRID）——设置srid

• sum(expression) ——返回一个计算式/表达式的和

• count(expression) ——返回一个表达式中的次数

PS : geometry，是几何类型的列的列名

srid，不同的srid就是不同标准的坐标系

点空间函数：

• ST_X(geometry) —— 返回X坐标

• ST_Y(geometry) —— 返回Y坐标

线串空间函数：

• ST_Length(geometry) —— 返回线串的长度

• ST_StartPoint(geometry) —— 将线串的第一个坐标作为点返回

• ST_EndPoint(geometry） —— 将线串的最后一个坐标作为点返回

• ST_NPoints(geometry) —— 返回线串的坐标数量

多边形空间函数：

• ST_Area(geometry) —— 返回多边形的面积

• ST_NRings(geometry) —— 返回多边形中环的数量（通常为1个，其他是孔）

• ST_ExteriorRing(geometry) —— 以线串的形式返回多边形最外面的环

• ST_InteriorRingN(geometry, n) —— 以线串形式返回指定的内部环

• ST_Perimeter(geometry) —— 返回所有环的长度

集合空间函数(多点、多线、多面、任意图形组合)：

• ST_NumGeometries(geometry) —— 返回集合中的组成部分的数量

• ST_GeometryN(geometry, n) —— 返回集合中指定的组成部分

• ST_Area(geometry) —— 返回集合中所有多边形组成部分的总面积

• ST_Length(geometry) —— 返回所有线段组成部分的总长度

几何图形输入和输出

在数据库中，几何图形（Geometry）以仅供PostGIS使用的格式存储在磁盘上。为了让外部程序插入和检索有用的几何图形信息，需要将它们转换为其他应用程序可以理解的格式。

①Well-known text（WKT）

• ST_GeomFromText(text, srid) —— 返回geometry，除非指定SRID，否则将得到一个包含未知SRID的几何图形

• ST_GeographyFromText(text)——返回Geography

• ST_AsText(geometry) —— 返回text

• ST_AsEWKT(geometry) —— 返回text

②Well-known binary（WKB）

• ST_GeomFromWKB(bytea) —— 返回geometry

• ST_AsBinary(geometry) —— 返回bytea

• ST_AsEWKB(geometry) —— 返回bytea

③Geographic Mark-up Language（GML）

• ST_GeomFromGML(text) —— 返回geometry

• ST_ASGML(geometry) —— 返回text

④Keyhole Mark-up Language（KML）

• ST_GeomFromKML(text) —— 返回geometry

• ST_ASKML(geometry) —— 返回text

⑤GeoJson

• ST_AsGeoJSON(geometry) —— 返回text

⑥Scalable Vector Graphics(SVG）

• ST_AsSVG(geometry) —— 返回text

以上函数最常见的用法是将几何图形的文本（text）表示形式转换为内部表示形式

请注意，除了具有几何图形表示形式的文本参数外，还可以指定一个提供几何图形SRID的数字参数。

图形关系

ST_Equals(geometry A, geometry B)

• 用于测试两个图形的空间相等性。

• 如果两个相同类型的几何图形具有相同的x、y坐标值，即如果第二个图形与第一个图形的坐标信息相等（相同），则ST_Equals()返回TRUE。

ST_Intersects、ST_Disjoint、ST_Crosses和ST_Overlaps

• ST_Intersects、ST_Crosses和ST_Overlaps测试几何图形是否相交。

• 如果两个图形有重合的部分，即如果它们的边界或内部相交，则ST_Intersects(geometry A, geometry B)返回TRUE

• ST_Disjoint(geometry A, geometry B)，如果两个几何图形没有重合的部分，则它们不相交，反之亦然。事实上测试"not intersect"通常比测试"disjoint"更有效，因为intersect测试可以使用空间索引

• 对于multipoint/polygon、multipoint/linestring、linestring/linestring、linestring/polygon和linestring/multipolygon的比较，如果相交生成的几何图形的维度小于两个源几何图形的最大维度，且相交集位于两个源几何图形的内部，则ST_Crosses(geometry A, geometry B)将返回TRUE。

• ST_Overlaps(geometry A, geometry B)比较两个相同维度的几何图形，如果它们的结果集与两个源几何图形都不同但具有相同维度，则返回TRUE。

ST_Touches()

• 测试两个几何图形是否在它们的边界上接触，但在它们的内部不相交

• 如果两个几何图形的边界相交，或者只有一个几何图形的内部与另一个几何图形的边界相交，则ST_Touches(geometry A, geometry B)将返回TRUE

ST_Within和ST_Contains

• ST_Within()和ST_Contains()测试一个几何图形是否完全位于另一个几何图形内

• 如果第一个几何图形完全位于第二个几何图形内，则ST_Within(geometry A, geometry B)返回TRUE，ST_Within()测试的结果与ST_Contains()完全相反

• 如果第二个几何图形完全包含在第一个几何图形内，则ST_Contains(geometry A, geometry B)返回TRUE

ST_Distance和ST_DWithin

• ST_Distance(geometry A, geometry B)计算两个几何图形之间的最短距离，并将其作为浮点数返回。这对于实际报告几何图形之间的距离非常有用

• ST_DWithin()，测试两个几何图形之间的距离是否在某个范围之内，

geography类型

• ST_AsText(geography) returns text

• ST_GeographyFromText(text) returns geography

• ST_AsBinary(geography) returns bytea

• ST_GeogFromWKB(bytea) returns geography

• ST_AsSVG(geography) returns text

• ST_AsGML(geography) returns text

• ST_AsKML(geography) returns text

• ST_AsGeoJson(geography) returns text

• ST_Distance(geography, geography) returns double

• ST_DWithin(geography, geography, float8) returns boolean

• ST_Area(geography) returns double

• ST_Length(geography) returns double

• ST_Covers(geography, geography) returns boolean

• ST_CoveredBy(geography, geography) returns boolean

• ST_Intersects(geography, geography) returns boolean

• ST_Buffer(geography, float8) returns geography[1]

• ST_Intersection(geography, geography) returns geography[1]

geography转换为geometry

PostgreSQL的类型转换语法是将 ::typename 附加到希望转换的值的末尾。因此，2::text将数字2转换为文本字符串"2"；'POINT(0 0)' :: geometry将点的文本表示形式转换为geometry点