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点

你可能感兴趣的:(postgresql)