点 由 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) | +-------------------------------------------+