OpenGIS 规范定义了以下函数,用于使用精确的对象形状来测试两个几何值 g1
和 g2
之间的关系。返回值 1 和 0 分别表示真和假,但距离函数返回距离值。
本节中的函数检测笛卡尔或地理空间参考系 (SRS) 中的参数,并返回适合 SRS 的结果。
除非另有说明,否则本节中的函数按如下方式处理其几何参数:
如果任何参数为
NULL
或任何几何参数为空几何,则返回值为NULL
。如果任何几何参数不是语法上格式良好的几何,则会发生
ER_GIS_INVALID_DATA
错误。如果任何几何参数是未定义空间参考系 (SRS) 中语法上格式良好的几何,则会发生
ER_SRS_NOT_FOUND
错误。对于采用多个几何参数的函数,如果这些参数不在同一个 SRS 中,则会发生
ER_GIS_DIFFERENT_SRIDS
错误。如果任何几何参数在几何上无效,则结果为真或假(未定义哪个),或者会发生错误。
对于地理 SRS 几何参数,如果任何参数的经度或纬度超出范围,则会发生错误。
如果经度值不在 (−180, 180] 范围内,则会发生
ER_GEOMETRY_PARAM_LONGITUDE_OUT_OF_RANGE
错误。如果纬度值不在 [−90, 90] 范围内,则会发生
ER_GEOMETRY_PARAM_LATITUDE_OUT_OF_RANGE
错误。
所示范围以度为单位。如果 SRS 使用其他单位,则该范围使用其单位中的相应值。由于浮点运算,精确的范围限制略有偏差。
否则,返回值为非
NULL
。
本节中的某些函数允许使用单位参数来指定返回值的长度单位。除非另有说明,否则函数按如下方式处理其单位参数:
如果在
INFORMATION_SCHEMA
ST_UNITS_OF_MEASURE
表中找到单位,则支持该单位。请参阅 第 28.3.37 节 “INFORMATION_SCHEMA ST_UNITS_OF_MEASURE 表”。如果指定了单位但 MySQL 不支持该单位,则会发生
ER_UNIT_NOT_FOUND
错误。如果指定了支持的线性单位且 SRID 为 0,则会发生
ER_GEOMETRY_IN_UNKNOWN_LENGTH_UNIT
错误。如果指定了支持的线性单位且 SRID 不为 0,则结果将以该单位表示。
如果未指定单位,则结果将以几何图形的 SRS 单位表示,无论是笛卡尔坐标系还是地理坐标系。目前,所有 MySQL SRS 均以米表示。
以下对象形状函数可用于测试几何关系:
返回 1 或 0 以指示
g1
是否完全包含g2
。这将测试与ST_Within()
相反的关系。ST_Contains()
按本节引言中的描述处理其参数。如果两个几何图形 空间交叉,则它们的空间关系具有以下属性:
除非
g1
和g2
的维度均为 1:如果g2
的内部与g1
的内部有共同点,但g2
未覆盖g1
的整个内部,则g1
与g2
交叉。如果
g1
和g2
的维度均为 1:如果两条线在有限数量的点处相交(即,没有公共线段,只有单个公共点)。
此函数返回 1 或 0 以指示
g1
是否在空间上与g2
交叉。ST_Crosses()
按本节引言中的描述处理其参数,但在以下附加条件下,返回值为NULL
:g1
的维度为 2(Polygon
或MultiPolygon
)。g2
的维度为 1(Point
或MultiPoint
)。
返回 1 或 0 以指示
g1
是否在空间上与(不与之相交)g2
不相交。ST_Disjoint()
按本节引言中的描述处理其参数。返回
g1
和g2
之间的距离,以几何参数的空间参考系统 (SRS) 的长度单位或可选的unit
参数(如果指定)的单位进行测量。此函数通过返回两个几何参数的分量所有组合中最短的距离来处理几何集合。
ST_Distance()
处理其几何参数的方式如本节引言中所述,但以下情况除外ST_Distance()
检测地理(椭球体)空间参考系统中的参数,并返回椭球体上的测地距离。ST_Distance()
支持所有几何类型的地理 SRS 参数的距离计算。如果任何参数在几何上无效,则结果是未定义的距离(即,它可以是任何数字),或者发生错误。
如果中间或最终结果产生
NaN
或负数,则会发生ER_GIS_INVALID_DATA
错误。
ST_Distance()
允许使用可选的unit
参数指定返回距离值的线性单位,ST_Distance()
处理该参数的方式如本节引言中所述。mysql> SET @g1 = ST_GeomFromText('POINT(1 1)'); mysql> SET @g2 = ST_GeomFromText('POINT(2 2)'); mysql> SELECT ST_Distance(@g1, @g2); +-----------------------+ | ST_Distance(@g1, @g2) | +-----------------------+ | 1.4142135623730951 | +-----------------------+ mysql> SET @g1 = ST_GeomFromText('POINT(1 1)', 4326); mysql> SET @g2 = ST_GeomFromText('POINT(2 2)', 4326); mysql> SELECT ST_Distance(@g1, @g2); +-----------------------+ | ST_Distance(@g1, @g2) | +-----------------------+ | 156874.3859490455 | +-----------------------+ mysql> SELECT ST_Distance(@g1, @g2, 'metre'); +--------------------------------+ | ST_Distance(@g1, @g2, 'metre') | +--------------------------------+ | 156874.3859490455 | +--------------------------------+ mysql> SELECT ST_Distance(@g1, @g2, 'foot'); +-------------------------------+ | ST_Distance(@g1, @g2, 'foot') | +-------------------------------+ | 514679.7439273146 | +-------------------------------+
有关球体上距离计算的特殊情况,请参见
ST_Distance_Sphere()
函数。返回 1 或 0 以指示
g1
在空间上是否等于g2
。ST_Equals()
处理其参数的方式如本节引言中所述,但它不会为空的几何参数返回NULL
。mysql> SET @g1 = Point(1,1), @g2 = Point(2,2); mysql> SELECT ST_Equals(@g1, @g1), ST_Equals(@g1, @g2); +---------------------+---------------------+ | ST_Equals(@g1, @g1) | ST_Equals(@g1, @g2) | +---------------------+---------------------+ | 1 | 0 | +---------------------+---------------------+
ST_FrechetDistance(
g1
,g2
[,unit
])返回两个几何图形之间的离散 Fréchet 距离,反映几何图形的相似程度。结果是一个双精度数字,以几何参数的空间参考系统 (SRS) 的长度单位或
unit
参数(如果给出)的长度单位进行测量。此函数实现离散 Fréchet 距离,这意味着它仅限于几何图形点之间的距离。例如,给定两个
LineString
参数,则仅考虑几何图形中明确提到的点。不考虑这些点之间线段上的点。ST_FrechetDistance()
处理其几何参数的方式如本节引言中所述,但以下情况除外几何图形可能具有笛卡尔坐标系或地理坐标系,但仅支持
LineString
值。如果参数在相同的笛卡尔坐标系或地理坐标系中,但其中一个不是LineString
,则会发生ER_NOT_IMPLEMENTED_FOR_CARTESIAN_SRS
或ER_NOT_IMPLEMENTED_FOR_GEOGRAPHIC_SRS
错误,具体取决于 SRS 类型。
ST_FrechetDistance()
处理其可选的unit
参数的方式如本节引言中所述。mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)'); mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)'); mysql> SELECT ST_FrechetDistance(@ls1, @ls2); +--------------------------------+ | ST_FrechetDistance(@ls1, @ls2) | +--------------------------------+ | 2.8284271247461903 | +--------------------------------+ mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)', 4326); mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)', 4326); mysql> SELECT ST_FrechetDistance(@ls1, @ls2); +--------------------------------+ | ST_FrechetDistance(@ls1, @ls2) | +--------------------------------+ | 313421.1999416798 | +--------------------------------+ mysql> SELECT ST_FrechetDistance(@ls1, @ls2, 'foot'); +----------------------------------------+ | ST_FrechetDistance(@ls1, @ls2, 'foot') | +----------------------------------------+ | 1028284.7767115477 | +----------------------------------------+
ST_HausdorffDistance(
g1
,g2
[,unit
])返回两个几何图形之间的离散 Hausdorff 距离,反映几何图形的相似程度。结果是一个双精度数字,以几何参数的空间参考系统 (SRS) 的长度单位或
unit
参数(如果给出)的长度单位进行测量。此函数实现离散 Hausdorff 距离,这意味着它仅限于几何图形点之间的距离。例如,给定两个
LineString
参数,则仅考虑几何图形中明确提到的点。不考虑这些点之间线段上的点。ST_HausdorffDistance()
处理其几何参数的方式如本节引言中所述,但以下情况除外如果几何参数在相同的笛卡尔坐标系或地理坐标系中,但不在支持的组合中,则会发生
ER_NOT_IMPLEMENTED_FOR_CARTESIAN_SRS
或ER_NOT_IMPLEMENTED_FOR_GEOGRAPHIC_SRS
错误,具体取决于 SRS 类型。支持以下组合LineString
和LineString
Point
和MultiPoint
LineString
和MultiLineString
MultiPoint
和MultiPoint
MultiLineString
和MultiLineString
ST_HausdorffDistance()
处理其可选的unit
参数的方式如本节引言中所述。mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)'); mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)'); mysql> SELECT ST_HausdorffDistance(@ls1, @ls2); +----------------------------------+ | ST_HausdorffDistance(@ls1, @ls2) | +----------------------------------+ | 1 | +----------------------------------+ mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,0 5,5 5)', 4326); mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 1,0 6,3 3,5 6)', 4326); mysql> SELECT ST_HausdorffDistance(@ls1, @ls2); +----------------------------------+ | ST_HausdorffDistance(@ls1, @ls2) | +----------------------------------+ | 111319.49079326246 | +----------------------------------+ mysql> SELECT ST_HausdorffDistance(@ls1, @ls2, 'foot'); +------------------------------------------+ | ST_HausdorffDistance(@ls1, @ls2, 'foot') | +------------------------------------------+ | 365221.4264870815 | +------------------------------------------+
返回 1 或 0 以指示
g1
在空间上是否与g2
相交。ST_Intersects()
处理其参数的方式如本节引言中所述。如果两个几何图形相交并且它们的交集产生相同维度的几何图形但不等于任何给定的几何图形,则这两个几何图形在空间上重叠。
此函数返回 1 或 0 以指示
g1
在空间上是否与g2
重叠。ST_Overlaps()
处理其参数的方式如本节引言中所述,但返回值为NULL
的附加条件是两个几何图形的维度不相等。如果两个几何图形的内部不相交,但其中一个几何图形的边界与另一个几何图形的边界或内部相交,则这两个几何图形在空间上相切。
此函数返回 1 或 0 以指示
g1
在空间上是否与g2
相切。ST_Touches()
处理其参数的方式如本节引言中所述,但返回值为NULL
的附加条件是两个几何图形的维度均为 0(Point
或MultiPoint
)。返回 1 或 0 以指示
g1
在空间上是否在g2
内。这将测试与ST_Contains()
相反的关系。ST_Within()
处理其参数的方式如本节引言中所述。