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点