运行中的任务
加载中…
数据资产状态
OSM 城市路网抓取进度新建任务
抓取 OSM 路网或预热瓦片缓存Overpass 为公共实例，间隔过小易被限流
仅预热国内
按访问热度分级（热→z+1/z+2，温→z+1，冷→跳过；需已积累访问记录，可叠加国内底座）
叠加静态底座（全球 z0-z5 + 国内到所选层级，首次分级预热建议勾选）
任务列表
加载中…
OSM 城市数据
就绪城市可直接在底图中显示街道级路网| 城市 | 状态 | 数据量 | 范围（bbox） | 操作 |
|---|---|---|---|---|
| 加载中… | ||||
瓦片缓存
磁盘缓存占用与命中基础| 瓦片源 | 瓦片数 | 占用 |
|---|---|---|
| 加载中… | ||
生成 API 密钥
用于外部调用本服务的坐标转换 / 地理搜索 / 瓦片接口✓ 密钥已生成 —— 仅此一次完整显示，请立即复制保存
—
密钥列表
| 名称 | 密钥 | 作用域 | 今日/总量 | 状态 | 最近调用 | 操作 |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
调用示例
在请求头带 X-API-Key 即可# 坐标转换
curl -H "X-API-Key: oms_live_xxxx" \
"http://127.0.0.1:8787/api/coord/all?lng=116.397&lat=39.909&from=WGS84"
# 地理搜索（scope: geocode）
curl -H "X-API-Key: oms_live_xxxx" \
"http://127.0.0.1:8787/api/geocode/search?q=天安门&limit=5"
# 瓦片（scope: tiles；可直接作为 XYZ 模板）
https://your-host/api/tiles/builtin/{z}/{x}/{y}.png?key=oms_live_xxxx
# 不带 key 仍可用（除非服务端设置 KEY_REQUIRED=on 强制校验）
七牛云配置
把渲染好的瓦片同步到七牛空间，通过 CDN 分发 —— 加载更快，服务器磁盘可只留热数据⚠️ SecretKey 需要明文参与上传签名（与密码不同，无法只存摘要），保存在服务端 data/auth/qiniu.json，请确保服务器磁盘访问受控。CDN 域名需在七牛控制台绑定到该空间。
同步瓦片
把本地已渲染的瓦片上传到七牛空间（后台任务，可暂停/取消，走「抓取任务」页看进度）IP 授权白名单
限制公开地图 / 检索接口的来源 IP，防止部署公网后被过度加载或盗刷
当前请求 IP：— ｜ 限流追踪中：— ｜
反向代理部署需设
⚠️ 开启白名单前务必把自己的 IP（或所在网段）加进列表，否则会把所有访问（包括你自己）挡在外面； 限流与白名单相互独立，填 0 表示不限流。生效范围：/api/tiles、/api/geocode、/api/coord、/api/staticmap、/api/markers。
TRUST_PROXY=on 才取 X-Forwarded-For 真实 IP
（确认前置代理会覆写该头再开，否则可被伪造）。⚠️ 开启白名单前务必把自己的 IP（或所在网段）加进列表，否则会把所有访问（包括你自己）挡在外面； 限流与白名单相互独立，填 0 表示不限流。生效范围：/api/tiles、/api/geocode、/api/coord、/api/staticmap、/api/markers。
静态地图
一个 <img> 直接出图，无需前端地图库 —— 适合报告、分享卡片、小程序# 基础用法
GET /api/staticmap?center=116.397,39.909&zoom=12&size=640x360
# 带标注 pin（分号分隔；#RRGGBB 颜色可省略，默认红色）
GET /api/staticmap?center=116.397,39.909&zoom=12&size=640x360&markers=116.397,39.909;116.45,39.92,#1a7f37
# 指定输入坐标系与瓦片源
GET /api/staticmap?center=116.397,39.909&crs=GCJ02&source=builtinDark&zoom=13&size=800x500
# 复杂场景先转坐标再拼 URL：GET /api/coord/convert?lng=&lat=&from=BD09&to=WGS84
瓦片缓存
关闭后不再读写 SQLite / 磁盘缓存，每次实时渲染或回源—
环境变量
TILE_CACHE=off 是运维级硬关闭，优先于此处设置；
开着它时这里改不动，需先去掉环境变量再重启服务。
底图源开关
关闭的源不会出现在 /api/tiles/sources，前端与 SDK 的下拉里都看不到，瓦片请求直接 404| 底图源 | 类型 | 状态 | 操作 |
|---|
⚠️ 关掉当前默认底图
builtin（自建矢量渲染）会让「离线可用」失效 ——
前端会退回列表里第一个可用源，若全部关闭则地图无底图。
把依赖外网的源关掉，可以彻底断掉这类出网请求。
保存
两项设置一起提交，保存后立即生效，无需重启商户认证审核
平台只做形式审核：名称与地址是否相符、类别是否恰当、内容是否合规申请列表
| 名称 | 类别 | 地址 | 提交人 | 状态 | 提交时间 | 操作 |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
商户详情
新建用户
viewer 仅可查看与执行任务，admin 可管理用户与删除密钥用户列表
| 用户名 | 显示名 | 角色 | 状态 | 最近登录 | 操作 |
|---|---|---|---|---|---|
| 加载中… | |||||
站点注册用户
门户注册的外部开发者 / 商户，不能登录本后台，与上面的管理员是两套账号用户列表
| 用户名 | 昵称 | 邮箱 | 注册时间 | 最近登录 | 状态 | 操作 |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
操作日志
登录、密钥、用户与任务操作留痕（最近 500 条）| 时间 | 操作者 | 动作 | 详情 | 来源 IP |
|---|---|---|---|---|
| 加载中… | ||||