文档首页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
信息 (Gzip) - 4.0Mb
信息 (Zip) - 4.0Mb


14.16.7.2 点属性函数

由 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+infNaN,则会发生 ER_DATA_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)                     |
    +----------------------------------+
  • ST_X(p [, new_x_val])

    使用表示有效 对象 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)                         |
    +-------------------------------------------+
  • ST_Y(p [, new_y_val])

    当只有一个参数,表示一个有效的 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)                          |
    +-------------------------------------------+