本节介绍用于在 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 接受文档并剥离坐标以获得更高的坐标维度。 options
2、3 和 4 的值目前产生相同的效果。如果以后支持坐标维度大于2的几何,这些值可以预期会产生不同的效果。参数(
srid
如果给定)必须是 32 位无符号整数。如果未给出,则几何返回值的 SRID 为 4326。GeoJSON 几何、特征和特征集合对象可能有一个
crs
属性。解析函数解析 和 命名空间中命名的 CRS URN , 但不解析作为链接对象给出的 CRS。此外, 被识别为 SRID 4326。如果对象具有无法理解的 CRS,则会发生错误,但如果提供了可选 参数,则任何 CRS 都会被忽略,即使它是无效的。urn:ogc:def:crs:EPSG::
srid
EPSG:
srid
urn:ogc:def:crs:OGC:1.3:CRS84
srid
type
正如 GeoJSON 规范中指定的那样,解析对于GeoJSON 输入的成员(Point
、LineString
等) 区分大小写。该规范没有提及其他解析的大小写敏感性,这在 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) | +--------------------------------------+