MySQL :: MySQL 8.4 参考手册 :: 14.16.11 空间 GeoJSON 函数

版本 8.4

9.0
8.0
5.7

8.0 日语

MySQL 8.4 参考手册 / ... / 空间 GeoJSON 函数

14.16.11 空间 GeoJSON 函数

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

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

MySQL 还支持本机 JSON 数据类型和一组 SQL 函数，以便对 JSON 值执行操作。有关更多信息，请参阅第 13.5 节，“JSON 数据类型” 和第 14.17 节，“JSON 函数”。

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

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

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

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

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

标志值	含义
0	无选项。这是未指定 `options` 时的默认值。
1	向输出添加边界框。
2	向输出添加短格式 CRS URN。默认格式为短格式（`EPSG:srid`）。
4	添加长格式 CRS URN（`urn:ogc:def:crs:EPSG::srid`）。此标志会覆盖标志 2。例如，选项值 5 和 7 含义相同（添加边界框和长格式 CRS URN）。

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]])

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

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

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

选项值	含义
1	拒绝文档并产生错误。这是未指定 `options` 时的默认值。
2, 3, 4	接受文档并删除更高坐标维度的坐标。

options 值 2、3 和 4 当前产生相同的效果。如果将来支持坐标维度高于 2 的几何图形，则可以预期这些值会产生不同的效果。

如果给定 srid 参数，则它必须是 32 位无符号整数。如果未给定，则 geometry 返回值具有 SRID 4326。

如果 srid 引用未定义的空间参考系统 (SRS)，则会发生 ER_SRS_NOT_FOUND 错误。

对于地理 SRS 几何参数，如果任何参数的经度或纬度超出范围，则会发生错误

如果经度值不在 (−180, 180] 范围内，则会发生 ER_LONGITUDE_OUT_OF_RANGE 错误。
如果纬度值不在 [−90, 90] 范围内，则会发生 ER_LATITUDE_OUT_OF_RANGE 错误。

所示范围以度为单位。如果 SRS 使用其他单位，则范围使用其单位中的相应值。由于浮点运算，精确的范围限制略有偏差。

GeoJSON 几何图形、要素和要素集合对象可能具有 crs 属性。解析函数解析 urn:ogc:def:crs:EPSG::srid 和 EPSG:srid 命名空间中的命名 CRS URN，但不解析作为链接对象给出的 CRS。此外，urn:ogc:def:crs:OGC:1.3:CRS84 被识别为 SRID 4326。如果对象具有无法理解的 CRS，则会发生错误，但如果给定了可选的 srid 参数，则会忽略任何 CRS，即使它是无效的。

如果在 GeoJSON 文档的较低级别找到指定与顶级对象 SRID 不同的 SRID 的 crs 成员，则会发生 ER_INVALID_GEOJSON_CRS_NOT_TOP_LEVEL 错误。

根据 GeoJSON 规范中的规定，对于 GeoJSON 输入的 type 成员（Point、LineString 等），解析区分大小写。该规范对于其他解析（在 MySQL 中不区分大小写）的区分大小写保持沉默。

此示例显示了简单 GeoJSON 对象的解析结果。请注意，坐标的顺序取决于使用的 SRID。

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