Lindorm时空函数中的关系函数 - 云原生多模数据库 Lindorm

本文介绍时空函数中的关系函数。

引擎与版本

关系函数仅适用于宽表引擎。无版本要求。

函数列表

Lindorm GanosBase支持的关系函数如下表所示。

函数	说明
ST_Contains	如果Geometry对象A包含Geometry对象B，`ST_Contains`函数则返回true。
ST_DWithin	如果两个Geometry对象的二维平面距离在指定范围内，`ST_DWithin`函数则返回true。
ST_DWithinSphere	如果两个Geometry对象的球面距离在指定范围内，`ST_DWithinSphere`函数则返回true。
ST_Intersects	判断两个Geometry对象是否相交。如果两个Geometry对象有任意共享空间的部分，那么两个Geometry对象相交，`ST_Intersects`函数则返回true。
ST_Overlaps	如果两个Geometry对象在空间上有重叠的部分，但不存在其中一个完全包含另一个的情况，`ST_Overlaps`函数则返回true。
ST_Within	如果Geometry对象A完全在Geometry对象B内，`ST_Within`函数则返回true。

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     |
+----------+