地图绘制、编辑与测量

组织点线面绘制、顶点编辑、保存取消、距离面积测量和提交校验流程。

🎯 引言

学完本文,你能设计点、线、面的绘制编辑流程,把结果保存为 GeoJSON,并完成常用距离与面积测量。


🧱 绘制能力从哪里来

Mapbox GL JS 负责地图渲染和事件,不自带完整的顶点编辑器。项目通常接入 Mapbox GL Draw 一类绘制工具,再用 Turf 计算距离和面积。

下面示例基于 Node.js 22.9.0、mapbox-gl@3.14.0、@mapbox/mapbox-gl-draw@1.5.0 和 @turf/turf@7.2.0:

pnpm add @mapbox/mapbox-gl-draw@1.5.0 @turf/turf@7.2.0
import MapboxDraw from '@mapbox/mapbox-gl-draw'
import '@mapbox/mapbox-gl-draw/dist/mapbox-gl-draw.css'

const draw = new MapboxDraw({
    displayControlsDefault: false,
    controls: {
        point: true,
        line_string: true,
        polygon: true,
        trash: true,
    },
})

map.addControl(draw, 'top-right')

Point、LineString、Polygon 分别表示位置、路径和封闭区域。工具提供绘制、选择、移动顶点和删除 Geometry 的基础操作。


✏️ 切换绘制与编辑状态

作用:让用户创建点、线、面,并修改已经画好的位置或形状。

draw.changeMode('draw_point')
draw.changeMode('draw_line_string')
draw.changeMode('draw_polygon')
draw.changeMode('simple_select')
draw.changeMode('direct_select', { featureId })
draw.trash()

simple_select 选择和移动整个对象,direct_select 编辑单个对象的顶点。业务界面应明确显示当前模式,保存或取消后退出编辑状态。

下面的组件可以直接完成绘制和编辑:选择“画点”“画线”或“画面”后在地图上操作;画线和画面时双击结束。切回“选择 / 编辑”,选中线或面后再次点击,白色顶点出现后就能拖动并修改形状。

当前模式:选择 / 编辑当前还没有图形

画线或画面时双击结束。选择已有线或面后再次点击,拖动白色顶点即可修改形状。

组件下方会显示当前模式和图形数量。画完线或面后切换到“选择 / 编辑”,再次点击图形,白色顶点出现后就能拖动修改。


🔔 监听、保存与校验 GeoJSON

作用:随时取得地图上的最新草稿,并在用户点击保存或取消时正确处理数据。

let draftGeoJSON = draw.getAll()
let originalGeoJSON = structuredClone(draftGeoJSON)

function syncDraft() {
    draftGeoJSON = draw.getAll()
}

map.on('draw.create', syncDraft)
map.on('draw.update', syncDraft)
map.on('draw.delete', syncDraft)

async function saveDraft() {
    validate(draftGeoJSON)
    await saveGeometry(draftGeoJSON)
    originalGeoJSON = structuredClone(draftGeoJSON)
    draw.changeMode('simple_select')
}

function cancelEdit() {
    draw.set(originalGeoJSON)
    draw.changeMode('simple_select')
}

draftGeoJSON 保存当前草稿,originalGeoJSON 保存进入编辑前的数据,saveGeometry 表示项目自己的保存接口。编辑已有对象时,先从接口读取 GeoJSON,再调用 draw.set(featureCollection)。保存成功后更新原始副本;取消时用原始副本重新 draw.set,而不是继续保留被修改的数据。

提交前还要检查草稿是否满足要求:Point 必须有有效经纬度,LineString 至少有两个不同坐标,Polygon 必须形成有效的封闭区域。保存请求进行时还应禁用保存按钮,避免重复提交。


📏 距离与面积测量

作用:把用户画出的路径转换成距离,把封闭区域转换成面积。

import { area, length } from '@turf/turf'

const kilometers = length(lineFeature, { units: 'kilometers' })
const squareMeters = area(polygonFeature)

const distanceLabel = `${kilometers.toFixed(2)} km`
const areaLabel = `${Math.round(squareMeters)} ㎡`

距离测量流程是绘制 LineString、在变化事件中计算长度、更新结果标签;面积测量流程是绘制 Polygon、计算面积、展示单位并允许重新绘制。界面显示按业务精度格式化,提交时仍保存原始 Geometry。

下面选择“测距离”或“测面积”,在地图中依次点击并双击结束。完成后,上方会立即显示计算结果。

选择“测距离”或“测面积”,然后在地图上绘制

🧾 小节总结

  • Mapbox GL JS 本身不提供完整顶点编辑器,项目通常接入绘制工具。
  • 绘制模式用于创建点线面,选择模式用于移动对象或修改顶点。
  • draw.create、draw.update、draw.delete 用来同步草稿。
  • 绘制结果通过 GeoJSON 保存,已有数据可载入后继续编辑。
  • Turf 可根据 LineString 和 Polygon 计算距离与面积。
  • 保存前要校验 Geometry、范围、重复提交和版本冲突。

❓ 知识问答

Q1:为什么编辑状态不直接写回列表数据?

用户可能取消操作。保留原始副本和草稿,才能可靠恢复。

Q2:面积结果为什么要取整?

测量计算常产生很长的小数,界面应按业务精度格式化,避免无意义的小数位。

Q3:绘制工具生成的数据能直接提交吗?

还需要校验 Geometry 类型、点数、允许范围和业务字段。


🧪 小练习

  1. 设计一个“开始编辑、保存、取消”状态对象,并写出取消时的恢复逻辑。
  2. 监听线更新事件,计算距离并显示两位小数。
// 请在这里编写代码

🎉 恭喜你已经掌握地图绘制、编辑与测量流程啦!