地图工具集

🧭

导航卡片嵌入

配置参数 → 实时预览 → 复制 iframe 代码嵌入到第三方页面

纬度

经度

坐标系

名称地址

电话缩放

🌐

多景区导航系统

上传路网数据、创建景区、路径规划、版本管理

多景区管理（创建/重命名/删除）
上传 OSM / GeoJSON 路网数据
节点与边的可视化编辑
跨景区路径规划与多点顺序规划
版本管理（历史快照 + 每日兜底备份）
多坐标系支持（WGS84 / GCJ-02 / BD-09）

打开系统

✏️

手绘地图校准

将手绘地图 / 园区导览图叠加到高德地图上进行配准校准

上传图片叠加到地图上
锁定比例缩放 + 手动输入尺寸
上下左右方向键微调位置
坐标系切换显示（GCJ-02 / WGS84 / BD-09）
导出配置 JSON 文件

打开工具

🔌

接口说明

系统提供的 RESTful API 接口文档

▲

基础地址

健康检查

GET /api/health

返回服务运行状态、运行时间、景区数量、Worker 数量

{
  "status": "ok",
  "uptime": 12345,
  "parks": 2,
  "workers": 4,
  "cacheSize": 0
}

景区管理

GET /api/parks

获取所有景区列表

GET /api/parks/:id

获取指定景区详情（含节点、边、图结构）

POST /api/parks

创建新景区，请求体 { "id": "park_001", "name": "景区名称", "bounds": {...}, "entrances": [...] }

PUT /api/parks/:id

重命名景区，请求体 { "name": "新名称" }

PUT /api/parks/:id/entrances

更新景区入口列表 { "entrances": [{ "nodeId": "n1", "lat": 31.2, "lng": 121.6, "name": "东门" }] }

PUT /api/parks/:id/graph

保存图编辑结果（节点、边），自动重建索引和计算范围

POST /api/parks/:id/recalc_bounds

根据实际节点坐标重新计算景区范围

DELETE /api/parks/:id/graph

清除景区路网数据（节点和边），保留景区名称和入口配置

DELETE /api/parks/:id

删除指定景区及关联数据（含版本数据）

版本管理

GET /api/parks/:id/versions

列出景区所有历史版本（含兜底备份），返回版本时间戳、文件大小、是否为兜底备份

GET /api/parks/:id/versions/:timestamp

获取指定版本的数据内容（节点、边、入口等完整数据）

POST /api/parks/:id/versions/:timestamp/restore

恢复指定版本（恢复前自动创建当前版本快照）

路网导入

POST /api/parks/:id/import_geojson

导入 GeoJSON 路网数据，Content-Type: application/json

POST /api/parks/:id/import_osm

导入 OSM XML 路网数据，Content-Type: application/xml

路径规划

GET /api/plan?startLat=&startLng=&endLat=&endLng=

两点之间路径规划
参数：startLat, startLng, endLat, endLng（必填）， coordType（可选，默认 WGS84，支持 gcj02 / bd09）， ignoreOneway（可选，忽略单行道限制）

POST /api/plan/multi

多点顺序路径规划，按顺序经过多个途经点
请求体：{ "waypoints": [{ "lat": 31.4, "lng": 121.7 }, ...], "coordType": "gcj02" }
同一景区内连续点自动批量优化（复用子图提取），规划失败自动降级为直线连接

▶ 返回字段说明

请求示例

同景区内路径规划（WGS84 坐标）：

使用 GCJ-02 坐标系：

🗺️ 地图工具集