PostGreSQL(五)PostGIS-常用函数
PostGIS中的常用函数
图形和地理位置
-
ST_GeometryType(geometry) —— 返回几何图形的类型
-
-
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
-
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点