本部分描述用于在 GeoJSON 文档和空间值之间转换的函数。GeoJSON 是一个用于编码几何/地理特征的开放标准。GeoJSON 支持与 MySQL 相同的几何/地理数据类型。不支持 Feature 和 FeatureCollection 对象,除非从它们中提取出几何对象。CRS 支持仅限于标识 SRID 的值。MySQL 还支持原生 JSON 数据类型和一组 SQL 函数,以支持对 JSON 值的操作。● ST_AsGeoJSON(g [, max_dec_digits [, options]])从几何值 g 生成一个 GeoJSON 对象。对象字符串具有连接的字符集和排序规则。如果任何参数为 NULL,则返回值为 NULL。如果任何非 NULL 参数无效,则会发生错误。如果指定了 max_dec_digits,将限制坐标的小数位数,会对输出进行四舍五入。如果未指定,此参数默认为其最大值2^32−1。最小值是0。options 为位掩码。下表显示了允许的标志值。如果几何参数的SRID为0,那么即使是那些请求一个CRS对象的标志值也不会生成CRS对象。 | |
| |
| |
| 向输出添加短格式的 CRS URN。默认格式为短格式(EPSG:srid)。 |
| 添加长格式 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,这是默认选项。 |
| |
options 值 2、3 和 4 目前产生相同的效果。如果将来支持坐标维数大于2的几何图形,可以预期这些值将产生不同的效果。如果给定 srid 参数,必须是一个32位的无符号整数。如果未给出,几何返回值的 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) |
+-------------------------------------------------+
https://dev.mysql.com/doc/refman/8.0/en/spatial-geojson-functions.html