地图绘制、编辑与测量
🎯 引言
学完本文,你能设计点、线、面的绘制编辑流程,把结果保存为 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 类型、点数、允许范围和业务字段。
🧪 小练习
- 设计一个“开始编辑、保存、取消”状态对象,并写出取消时的恢复逻辑。
- 监听线更新事件,计算距离并显示两位小数。
// 请在这里编写代码
🎉 恭喜你已经掌握地图绘制、编辑与测量流程啦!
