PostGIS中的常用函数

网上看到的最全最详细的PostGIS空间函数整理，搬运过来方便以后查看

PostGreSQL（五）PostGIS-常用函数 - huiyii - 博客园 (cnblogs.com)

https://www.cnblogs.com/yjh1995/p/13893295.html#:~:text=PostGIS%E4%B8%AD%E7%9A%84%E5%B8%B8%E7%94%A8%E5%87%BD%E6%95%B0%20%E5%9B%BE%E5%BD%A2%E5%92%8C%E5%9C%B0%E7%90%86%E4%BD%8D%E7%BD%AE%20ST_GeometryType%28geometry%29%E2%80%94%E2%80%94%20%E8%BF%94%E5%9B%9E%E5%87%A0%E4%BD%95%E5%9B%BE%E5%BD%A2%E7%9A%84%E7%B1%BB%E5%9E%8B,ST_Transform%28geometry%2C%20srid%29%E2%80%94%E2%80%94%E5%B0%86%E5%87%A0%E4%BD%95%E5%9B%BE%E5%BD%A2%E6%8A%95%E5%BD%B1%E4%B8%BA%E5%9C%B0%E7%90%86%E5%9D%90%E6%A0%87%E6%95%B0%E6%8D%AE%20%E6%88%96%20%E8%BD%AC%E6%8D%A2%E4%B8%BA%E4%B8%8D%E5%90%8Csrid%E5%9D%90%E6%A0%87%E7%B3%BB%E7%BB%9F%E7%9A%84%E5%9D%90%E6%A0%87%E6%95%B0%E6%8D%AE%20Geography%28geometry%29%E2%80%94%E2%80%94%E5%B0%86%E5%9F%BA%E4%BA%8EEPSG%3A4326%28srid%3D4326%29%E7%9A%84geometry%E6%95%B0%E6%8D%AE%E7%B1%BB%E5%9E%8B%E8%BD%AC%E6%8D%A2%E4%B8%BAgeography%E6%95%B0%E6%8D%AE%E7%B1%BB%E5%9E%8B顺便记录一个问题：

ST_AsGeoJSON函数返回的Json虽然有crs属性，但无法被ArcGIS的开源项目terraformer-js的geojsonToArcGIS方法识别到，转出的要素wkid全是4326，不清楚是不是我的使用方式不对

图形和地理位置

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点