本文介绍时空函数中的关系函数。
引擎与版本
关系函数仅适用于宽表引擎。无版本要求。
函数列表
Lindorm GanosBase支持的关系函数如下表所示。
函数 | 说明 |
如果Geometry对象A包含Geometry对象B, | |
如果两个Geometry对象的二维平面距离在指定范围内, | |
如果两个Geometry对象的球面距离在指定范围内, | |
判断两个Geometry对象是否相交。如果两个Geometry对象有任意共享空间的部分,那么两个Geometry对象相交, | |
如果两个Geometry对象在空间上有重叠的部分,但不存在其中一个完全包含另一个的情况, | |
如果Geometry对象A完全在Geometry对象B内, |
ST_Contains
如果Geometry对象A包含Geometry对象B,ST_Contains
函数则返回true。
语法
判断对象geomA是否包含对象geomB
boolean ST_Contains(geometry geomA,geometry geomB)
判断对象geom和点坐标(x,y)的包含关系
boolean ST_Contains(geometry geom,double x,double y)
参数说明
参数 | 描述 |
geomA | 指定的第一个Geometry对象。 |
geomB | 指定的第二个Geometry对象。 |
geom | 指定的Geometry对象。 |
x | 坐标经度x值。 |
y | 坐标纬度y值。 |
geomB对象的所有点均在geomA对象的内部或者边界上,则geomA对象包含geomB对象。
ST_Contains
函数是ST_Within
的反函数,即ST_Contains(A,B)=ST_Within(B,A)
。
示例
示例1
SELECT ST_Contains(ST_GeomFromText('POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))'), ST_GeomFromText('POINT(5 5)')) AS iscontain;
返回结果:
+-----------+ | iscontain | +-----------+ | true | +-----------+
示例2
SELECT ST_Contains(ST_GeomFromText('POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))'),5,5) AS iscontain;
返回结果:
+-----------+ | iscontain | +-----------+ | true | +-----------+
示例3
SELECT ST_Contains(ST_GeomFromText('POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))'), ST_GeomFromText('POINT(180 23)')) AS iscontain;
返回结果:
+-----------+ | iscontain | +-----------+ | false | +-----------+
示例4
SELECT ST_Contains(ST_GeomFromText('POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))'),180,23) AS iscontain;
返回结果:
+-----------+ | iscontain | +-----------+ | false | +-----------+
ST_DWithin
如果两个Geometry对象的二维平面距离在指定范围内,ST_DWithin
函数则返回true。
语法
判断对象geomA和对象geomB的二维平面距离是否在指定范围内
boolean ST_DWithin(geometry geomA, geometry geomB, double distanceOfSrid)
判断对象geom和点坐标(x,y)的二维平面距离是否在指定范围内
boolean ST_DWithin(geometry geom, double x, double y, double distanceOfSrid)
参数说明
参数 | 描述 |
geomA | 指定的第一个Geometry对象。 |
geomB | 指定的第二个Geometry对象。 |
distanceOfSrid | 在SRID 4326下的距离,单位为degree。 |
geom | 指定的Geometry对象。 |
x | 坐标经度x值。 |
y | 坐标纬度y值。 |
Geometry对象支持Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon和GeometryCollection类型。
示例
示例1
SELECT ST_DWithin(ST_GeomFromText('POINT(5 5)'), ST_GeomFromText('POINT(6 6)'), 10) AS iswithin;
返回结果:
+----------+ | iswithin | +----------+ | true | +----------+
示例2
SELECT ST_DWithin(ST_GeomFromText('POINT(5 5)'),6,6,10) AS iswithin;
返回结果:
+----------+ | iswithin | +----------+ | true | +----------+
ST_DWithinSphere
如果两个Geometry对象的球面距离在指定范围内,ST_DWithinSphere
函数则返回true。
语法
判断对象geomA和对象geomB的球面距离是否在指定范围内
boolean ST_DWithinSphere(geometry geomA, geometry geomB, double distance)
判断对象geom和点坐标(x,y)的球面距离是否在指定范围内
boolean ST_DWithinSPhere(geometry geom, double x, double y, double distance)
参数说明
参数 | 描述 |
geomA | 指定的第一个Geometry对象。 |
geomB | 指定的第二个Geometry对象。 |
distance | 球面距离,单位为米。球面距离的判断存在一定的误差,误差为厘米级别。 |
geom | 指定的Geometry对象。 |
x | 坐标经度x值。 |
y | 坐标纬度y值。 |
Geometry对象支持Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon和GeometryCollection类型。
示例
示例1:球面上POINT(120 36)和POINT(116 40)之间的距离为566034.7930717631米,距离在指定的范围内,
ST_DWithinSphere
函数则返回true。SELECT ST_DWithinSphere(ST_GeomFromText('POINT(120 36)'), ST_GeomFromText('POINT(116 40)'), 570000) AS iswithin;
返回结果:
+----------+ | iswithin | +----------+ | true | +----------+
示例2
SELECT ST_DWithinSphere(ST_GeomFromText('POINT(120 36)'),116,40,570000) AS iswithin;
返回结果:
+----------+ | iswithin | +----------+ | true | +----------+
ST_Intersects
判断两个Geometry对象是否相交。如果两个Geometry对象有任意共享空间的部分,那么两个Geometry对象相交,ST_Intersects
函数则返回true。
语法
判断对象geomA和对象geomB的是否相交
boolean ST_Intersects(geometry geomA, geometry geomB)
判断对象geom和点坐标(x,y)是否相交
boolean ST_Intersects(geometry geom, double x, double y)
参数说明
参数 | 描述 |
geomA | 指定的第一个Geometry对象。 |
geomB | 指定的第二个Geometry对象。 |
geom | 指定的Geometry对象。 |
x | 坐标经度x值。 |
y | 坐标纬度y值。 |
Geometry对象支持Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon和GeometryCollection类型。
示例
示例1
SELECT ST_Intersects(ST_GeomFromText('POINT(0 0)'), ST_GeomFromText('LINESTRING ( 2 0, 0 2 )')) AS isinter;
返回结果:
+---------+ | isinter | +---------+ | false | +---------+
示例2
SELECT ST_Intersects(ST_GeomFromText('LINESTRING ( 2 0, 0 2 )'), 0, 0) AS isinter;
返回结果:
+---------+ | isinter | +---------+ | false | +---------+
示例3
SELECT ST_Intersects(ST_GeomFromText('POINT(0 0)'), ST_GeomFromText('LINESTRING ( 0 0, 0 2 )')) AS isinter;
返回结果:
+---------+ | isinter | +---------+ | true | +---------+
示例4
SELECT ST_Intersects(ST_GeomFromText('LINESTRING ( 0 0, 0 2 )'), 0, 0) AS isinter;
返回结果:
+---------+ | isinter | +---------+ | true | +---------+
ST_Overlaps
如果两个Geometry对象在空间上有重叠的部分,但不存在其中一个完全包含另一个的情况,ST_Overlaps
函数则返回true。
语法
判断对象geomA和对象geomB在空间上是否有重叠的部分
boolean ST_Overlaps(geometry geomA, geometry geomB)
判断对象geom和点坐标(x,y)在空间上是否有重叠的部分
boolean ST_Overlaps(geometry geom, double x, double y)
参数说明
参数 | 描述 |
geomA | 指定的第一个Geometry对象。 |
geomB | 指定的第二个Geometry对象。 |
geom | 指定的Geometry对象。 |
x | 坐标经度x值。 |
y | 坐标纬度y值。 |
Geometry对象支持Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon和GeometryCollection类型。
示例
示例1
SELECT ST_Overlaps(ST_GeomFromText('LINESTRING(0 0,0 2)'),ST_GeomFromText('LINESTRING(0 1,0 3)')) as overlaps;
返回结果:
+----------+ | overlaps | +----------+ | true | +----------+
示例2
SELECT ST_Overlaps(ST_GeomFromText('LINESTRING(0 0,0 2)'),ST_GeomFromText('POINT(0 1)')) as overlaps;
返回结果:
+----------+ | overlaps | +----------+ | false | +----------+
示例3
SELECT ST_Overlaps(ST_GeomFromText('LINESTRING(0 0,0 2)'), 0, 1) as overlaps;
返回结果:
+----------+ | overlaps | +----------+ | false | +----------+
ST_Within
如果Geometry对象A完全在Geometry对象B内,ST_Within
函数则返回true。
语法
判断对象geomA和对象geomB的包含关系
boolean ST_Within(geometry geomA, geometry geomB)
判断对象geom和点坐标(x,y)的包含关系
bboolean ST_Within(double x, double y, geometry geom)
参数说明
参数 | 描述 |
geomA | 指定的第一个Geometry对象。 |
geomB | 指定的第二个Geometry对象。 |
geom | 指定的Geometry对象。 |
x | 坐标经度x值。 |
y | 坐标纬度y值。 |
Geometry对象支持Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon和GeometryCollection类型。
如果
ST_Within(A,B)
的返回结果与ST_Within(B,A)
的返回结果都为true,则认为Geometry对象A和Geometry对象B在空间上相同。
示例
示例1
SELECT ST_Within(ST_GeomFromText('POINT(5 5)'), ST_GeomFromText('POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))')) AS iswithin;
返回结果:
+----------+ | iswithin | +----------+ | true | +----------+
示例2
SELECT ST_Within(5, 5, ST_GeomFromText('POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))')) AS iswithin;
返回结果:
+----------+ | iswithin | +----------+ | true | +----------+