点
由 X 和 Y 坐标组成,可以使用 ST_X()
和 ST_Y()
函数分别获取。这些函数还允许使用可选的第二个参数来指定 X 或 Y 坐标值,在这种情况下,函数结果是第一个参数中的 点
对象,其相应的坐标修改为等于第二个参数。
对于具有地理空间参考系 (SRS) 的 点
对象,可以使用 ST_Longitude()
和 ST_Latitude()
函数分别获取经度和纬度。这些函数还允许使用可选的第二个参数来指定经度或纬度值,在这种情况下,函数结果是第一个参数中的 点
对象,其经度或纬度修改为等于第二个参数。
除非另有说明,否则本节中的函数按如下方式处理其几何参数
如果任何参数为
NULL
,则返回值为NULL
。如果任何几何参数是有效的几何图形但不是
点
对象,则会发生ER_UNEXPECTED_GEOMETRY_TYPE
错误。如果任何几何参数不是语法上格式正确的几何图形,则会发生
ER_GIS_INVALID_DATA
错误。如果任何几何参数是语法上格式正确的几何图形,但位于未定义的空间参考系 (SRS) 中,则会发生
ER_SRS_NOT_FOUND
错误。如果提供了 X 或 Y 坐标参数,并且该值为
-inf
、+inf
或NaN
,则会发生ER_DATA_OUT_OF_RANGE
错误。如果经度或纬度值超出范围,则会发生错误
如果经度值不在 (−180, 180] 范围内,则会发生
ER_LONGITUDE_OUT_OF_RANGE
错误。如果纬度值不在 [−90, 90] 范围内,则会发生
ER_LATITUDE_OUT_OF_RANGE
错误。
显示的范围以度为单位。由于浮点运算,精确的范围限制略有偏差。
否则,返回值为非
NULL
。
可以使用以下函数来获取点属性
ST_Latitude(
p
[,new_latitude_val
])使用表示具有地理空间参考系 (SRS) 的有效
点
对象p
的单个参数,ST_Latitude()
以双精度数字形式返回p
的纬度值。使用表示有效纬度值的可选第二个参数,
ST_Latitude()
返回一个点
对象,该对象类似于第一个参数,其纬度等于第二个参数。ST_Latitude()
按照本节引言中的描述处理其参数,但如果点
对象有效但没有地理 SRS,则会发生ER_SRS_NOT_GEOGRAPHIC
错误。mysql> SET @pt = ST_GeomFromText('POINT(45 90)', 4326); mysql> SELECT ST_Latitude(@pt); +------------------+ | ST_Latitude(@pt) | +------------------+ | 45 | +------------------+ mysql> SELECT ST_AsText(ST_Latitude(@pt, 10)); +---------------------------------+ | ST_AsText(ST_Latitude(@pt, 10)) | +---------------------------------+ | POINT(10 90) | +---------------------------------+
ST_Longitude(
p
[,new_longitude_val
])使用表示具有地理空间参考系 (SRS) 的有效
点
对象p
的单个参数,ST_Longitude()
以双精度数字形式返回p
的经度值。使用表示有效经度值的可选第二个参数,
ST_Longitude()
返回一个点
对象,该对象类似于第一个参数,其经度等于第二个参数。ST_Longitude()
按照本节引言中的描述处理其参数,但如果点
对象有效但没有地理 SRS,则会发生ER_SRS_NOT_GEOGRAPHIC
错误。mysql> SET @pt = ST_GeomFromText('POINT(45 90)', 4326); mysql> SELECT ST_Longitude(@pt); +-------------------+ | ST_Longitude(@pt) | +-------------------+ | 90 | +-------------------+ mysql> SELECT ST_AsText(ST_Longitude(@pt, 10)); +----------------------------------+ | ST_AsText(ST_Longitude(@pt, 10)) | +----------------------------------+ | POINT(45 10) | +----------------------------------+
使用表示有效
点
对象p
的单个参数,ST_X()
以双精度数字形式返回p
的 X 坐标值。X 坐标被认为是指在点
空间参考系 (SRS) 定义中首先出现的轴。使用可选的第二个参数,
ST_X()
返回一个点
对象,该对象类似于第一个参数,其 X 坐标等于第二个参数。如果点
对象具有地理 SRS,则第二个参数必须在经度或纬度值的正确范围内。ST_X()
按照本节引言中的描述处理其参数。mysql> SELECT ST_X(Point(56.7, 53.34)); +--------------------------+ | ST_X(Point(56.7, 53.34)) | +--------------------------+ | 56.7 | +--------------------------+ mysql> SELECT ST_AsText(ST_X(Point(56.7, 53.34), 10.5)); +-------------------------------------------+ | ST_AsText(ST_X(Point(56.7, 53.34), 10.5)) | +-------------------------------------------+ | POINT(10.5 53.34) | +-------------------------------------------+
当只有一个参数,表示一个有效的
Point
对象p
时,ST_Y()
返回p
的 Y 坐标值,该值是一个双精度浮点数。Y 坐标是指Point
空间参考系 (SRS) 定义中出现的第二个轴。当使用可选的第二个参数时,
ST_Y()
返回一个Point
对象,该对象与第一个参数类似,但其 Y 坐标等于第二个参数。如果Point
对象具有地理 SRS,则第二个参数必须在经度或纬度的有效范围内。ST_Y()
对其参数的处理方式如本节引言中所述。mysql> SELECT ST_Y(Point(56.7, 53.34)); +--------------------------+ | ST_Y(Point(56.7, 53.34)) | +--------------------------+ | 53.34 | +--------------------------+ mysql> SELECT ST_AsText(ST_Y(Point(56.7, 53.34), 10.5)); +-------------------------------------------+ | ST_AsText(ST_Y(Point(56.7, 53.34), 10.5)) | +-------------------------------------------+ | POINT(56.7 10.5) | +-------------------------------------------+