MySQL ST_AsGeoJSON 怎样把空间对象转换成 GeoJSON

如果空间列已经存进 MySQL，应用层通常还需要把它交给地图组件或接口返回。这个转换不必先手写 JSON：ST_AsGeoJSON(g[, max_dec_digits[, options]]) 会把几何对象转换成 GeoJSON。真正容易出错的是三个参数的职责不同：第二个参数控制坐标小数位，第三个参数用位掩码控制 bbox 和 CRS 等附加信息。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/spatial-geojson-functions.html

最稳妥的用法是先用默认参数确认几何类型和坐标，再按接口契约补上小数位或 bbox；只有确实需要坐标参考系信息时才设置 options。不要把 ST_AsGeoJSON 当成 Feature 或 FeatureCollection 生成器，它主要负责几何对象的 GeoJSON 表示。

本文用一个 POINT 作为基线，再扩展到空间表列、精度控制和 SRID 差异。所有 SQL 都是可复用的示例，结果解释以 MySQL 8.4 官方空间 GeoJSON 函数说明为准。

先看默认输出：几何对象怎样变成 GeoJSON

先不要急着添加参数。用 WKT 构造一个点，再调用默认的 ST_AsGeoJSON()，可以确认输入对象是否正确，以及坐标数组是否符合应用预期。

-- 用一个简单点确认几何类型与 GeoJSON 基本结构
SELECT ST_AsGeoJSON(
    ST_GeomFromText('POINT(11.11111 12.22222)')
) AS geojson;

-- 指定两位小数，观察坐标值的舍入结果
SELECT ST_AsGeoJSON(
    ST_GeomFromText('POINT(11.11111 12.22222)'),
    2
) AS geojson;

第一条语句关注结构，结果会包含 type 和 coordinates。第二条语句把 max_dec_digits 设为 2，坐标会按两位小数输出。这里的参数只影响序列化出来的数字位数，不会把原表中的空间值改成低精度值。

拆开三个参数：精度和附加信息不要混用

把函数签名拆开看，最不容易误解：

例如，设置 options=1 表示请求 bbox；设置 options=2 表示加入短格式 CRS 标识；设置 options=4 表示使用长格式 CRS 标识，而且它隐含 CRS 选项。多个能力可以按位相加，但应根据消费者是否真的读取这些字段来选择。

-- options=1：请求输出几何对象的边界框信息
SELECT ST_AsGeoJSON(
    ST_GeomFromText('LINESTRING(0 0, 10 5, 8 12)'),
    3,
    1
) AS geojson_with_bbox;

-- options=2：请求短格式 CRS 标识；精度仍由第二个参数控制
SELECT ST_AsGeoJSON(
    ST_SRID(ST_GeomFromText('POINT(116.4 39.9)'), 4326),
    6,
    2
) AS geojson_with_crs;

如果前端只需要画点或线，通常从 options=0 开始即可。bbox 和 CRS 会增加响应结构，接口消费者必须知道如何读取它们；不要为了“信息更全”盲目开启。

从空间表列转换：属性字段要在 SQL 中一起保留

实际接口往往不只返回几何，还要返回业务主键、名称和类型。此时让 ST_AsGeoJSON(location) 只负责几何转换，其他字段照常选择，应用层再决定是否包装成 Feature。

-- 假设 places.location 是 POINT 类型的空间列
SELECT
    id,
    place_name,
    -- 六位小数适合保留常见地理坐标的展示精度
    ST_AsGeoJSON(location, 6, 0) AS geometry_json
FROM places
WHERE is_enabled = 1;

-- 用 NULL 保护缺失位置，避免把缺失几何误当成有效坐标
SELECT
    id,
    CASE
        WHEN location IS NULL THEN NULL
        ELSE ST_AsGeoJSON(location, 6, 0)
    END AS geometry_json
FROM places;

这里的 geometry_json 是几何的 GeoJSON 表示，id 和 place_name 仍是普通列。若接口协议需要 GeoJSON Feature，应在应用层明确拼接 type、properties 和 geometry，不要误以为 ST_AsGeoJSON 会自动生成完整 Feature。

SRID 0 和 SRID 4326：先确认坐标的解释方式

同样的两个数字，可能代表没有指定空间参考系的平面坐标，也可能代表经纬度。GeoJSON 的坐标数组不会替你修正业务数据，所以排查时要把 SRID 和坐标顺序一起看。

-- SRID 0：只表达几何坐标，不附带地理参考系含义
SELECT ST_AsGeoJSON(
    ST_SRID(ST_GeomFromText('POINT(102 0)'), 0),
    6,
    0
) AS planar_geojson;

-- SRID 4326：明确把该点标记为常见地理坐标参考系
SELECT ST_AsGeoJSON(
    ST_SRID(ST_GeomFromText('POINT(102 0)'), 4326),
    6,
    2
) AS geographic_geojson;

官方文档特别提醒，坐标顺序会受 SRID 影响。不要只看 GeoJSON 文本里是否出现 coordinates 就判断它是经纬度；先检查源列的 SRID，再决定是否需要坐标转换或附加 CRS 信息。本文不展开空间参考系转换，重点是避免在序列化阶段把“坐标值”和“坐标含义”混为一谈。

常见误区和边界

把 max_dec_digits 当成存储精度

它是输出阶段的坐标小数位控制。若业务需要真正改变空间数据，应使用明确的空间数据变换或重新写入策略，而不是把查询结果的位数限制当成数据清洗。

把 options 当成枚举值

options 是位掩码。1、2、4 分别代表不同附加能力，可以组合；其中 4 表示长格式 CRS，并包含 CRS 相关选项。接口只需要基础几何时，保持 0 更简单。

期待函数直接生成 FeatureCollection

ST_AsGeoJSON 的职责是几何到 GeoJSON 的转换。要生成 Feature 或 FeatureCollection，仍需由 SQL 结果集或应用层组装属性和多个几何对象，不能用一个函数调用替代集合建模。

忽略 NULL 和无效输入

NULL 输入与非法非 NULL 参数的处理方式不同。空间列允许为空时，先在查询中保留 NULL 语义；输入格式不正确时，应把它当作数据问题处理，而不是在接口层静默拼接字符串。

最后的检查清单

可以按下面的顺序确认一条转换 SQL 是否适合上线：

1. 用一个已知 POINT 或 LINESTRING 确认输出包含正确的 type 和 coordinates。
2. 明确第二个参数是展示精度，不把它当成空间值的永久修改。
3. 只有消费者需要时才开启 bbox 或 CRS，并记录 options 的位含义。
4. 查询空间列时同时返回业务属性，Feature 结构由应用协议负责。
5. 检查源数据 SRID 和坐标顺序，再解释 GeoJSON 中的数值含义。

一句话总结：先用 ST_AsGeoJSON(g) 看清几何，再用 max_dec_digits 控制输出精度，最后按消费者需求选择 options；SRID 的语义则必须回到源空间数据本身确认。

相关问题

ST_AsGeoJSON 会修改表里的空间数据吗？

不会。它是在查询中生成 GeoJSON 表示，第二个参数也只是限制输出坐标的小数位。

什么时候应该设置 options？

当调用方明确需要 bbox 或 CRS 信息时设置；只画基础几何时通常使用默认值或 0。

ST_AsGeoJSON 能直接返回 GeoJSON Feature 吗？

它主要输出几何对象的 GeoJSON 表示。Feature 的 properties 和集合结构需要由查询结果或应用层负责组装。