Documentation Home
MySQL 8.0 参考手册  / 第 12 章函数和运算符  / 12.17空间分析函数  /  12.17.11 空间 GeoJSON 函数

12.17.11 空间 GeoJSON 函数

本节介绍用于在 GeoJSON 文档和空间值之间进行转换的函数。GeoJSON 是一种用于编码几何/地理特征的开放标准。有关详细信息,请参阅http://geojson.org。此处讨论的函数遵循 GeoJSON 规范修订版 1.0。

GeoJSON 支持与 MySQL 相同的几何/地理数据类型。不支持 Feature 和 FeatureCollection 对象,除了从中提取几何对象。CRS 支持仅限于标识 SRID 的值。

MySQL 还支持原生JSON 数据类型和一组 SQL 函数,以启用对 JSON 值的操作。有关详细信息,请参阅第 11.5 节,“JSON 数据类型”第 12.18 节,“JSON 函数”

  • ST_AsGeoJSON(g [, max_dec_digits [, options]])

    从 geometry 生成一个 GeoJSON 对象 g。对象字符串具有连接字符集和排序规则。

    如果任何参数是NULL,则返回值为NULL。如果任何非NULL 参数无效,则会发生错误。

    max_dec_digits,如果指定,则限制坐标的小数位数并导致输出四舍五入。如果未指定,则此参数默认为其最大值 2 32 − 1。最小值为 0。

    options,如果指定,是一个位掩码。下表显示了允许的标志值。如果几何参数的 SRID 为 0,则即使对于那些请求一个的标志值,也不会生成 CRS 对象。

    标志值 意义
    0 没有选择。options如果未指定,则这是默认值。
    1个 向输出添加边界框。
    2个 在输出中添加短格式 CRS URN。默认格式是短格式 ( )。EPSG:srid
    4个 添加长格式 CRS URN ( )。此标志覆盖标志 2。例如,选项值 5 和 7 表示相同(添加边界框和长格式 CRS URN)。urn:ogc:def:crs:EPSG::srid
    mysql> SELECT ST_AsGeoJSON(ST_GeomFromText('POINT(11.11111 12.22222)'),2);
    +-------------------------------------------------------------+
    | ST_AsGeoJSON(ST_GeomFromText('POINT(11.11111 12.22222)'),2) |
    +-------------------------------------------------------------+
    | {"type": "Point", "coordinates": [11.11, 12.22]}            |
    +-------------------------------------------------------------+
  • ST_GeomFromGeoJSON(str [, options [, srid]])

    str解析表示 GeoJSON 对象 的字符串并返回几何图形。

    如果任何参数是NULL,则返回值为NULL。如果任何非NULL 参数无效,则会发生错误。

    options,如果给定,描述如何处理包含坐标维度大于 2 的几何图形的 GeoJSON 文档。下表显示了允许的options值。

    期权价值 意义
    1个 拒绝文档并产生错误。options如果未指定,则这是默认值 。
    2, 3, 4 接受文档并剥离坐标以获得更高的坐标维度。

    options2、3 和 4 的值目前产生相同的效果。如果以后支持坐标维度大于2的几何,这些值可以预期会产生不同的效果。

    参数(srid如果给定)必须是 32 位无符号整数。如果未给出,则几何返回值的 SRID 为 4326。

    GeoJSON 几何、特征和特征集合对象可能有一个crs属性。解析函数解析 和 命名空间中命名的 CRS URN , 但不解析作为链接对象给出的 CRS。此外, 被识别为 SRID 4326。如果对象具有无法理解的 CRS,则会发生错误,但如果提供了可选 参数,则任何 CRS 都会被忽略,即使它是无效的。 urn:ogc:def:crs:EPSG::sridEPSG:sridurn:ogc:def:crs:OGC:1.3:CRS84srid

    type正如 GeoJSON 规范中指定的那样,解析对于GeoJSON 输入的成员(PointLineString等) 区分大小写。该规范没有提及其他解析的大小写敏感性,这在 MySQL 中是不区分大小写的。

    此示例显示了一个简单的 GeoJSON 对象的解析结果:

    mysql> SET @json = '{ "type": "Point", "coordinates": [102.0, 0.0]}';
    mysql> SELECT ST_AsText(ST_GeomFromGeoJSON(@json));
    +--------------------------------------+
    | ST_AsText(ST_GeomFromGeoJSON(@json)) |
    +--------------------------------------+
    | POINT(102 0)                         |
    +--------------------------------------+