深浅模式
地图与定位
功能说明
接入高德地图，为定位、距离筛选、外卖与跑腿派单等本地生活功能提供地理能力。
前置条件
- 已在 高德开放平台 创建应用，并开通 Web 端（JS API） 类型 Key。
- 2021 年后创建的应用须同时配置 安全密钥（securityJsCode）。
- 若使用外卖 / 跑腿模块，对应功能已在授权中开通。
管理后台配置步骤
路径：系统设置 → 系统配置 → 高德地图 Tab
| 配置项 | 说明 |
|---|---|
| Web 端 Key | 高德控制台 → 应用 → Key |
| 安全密钥 | 与 Key 同应用下的安全密钥 |
保存后无需重启；客户端下次加载地图组件时生效。
与站点区域的关系
路径：系统设置 → 系统配置 → 区域配置 Tab（或 区域管理 → 区域列表）
可设置 距离限制（米）：用户可见笔记、商家等内容的最大地理半径。与高德 Key 配合使用。
区域配置
| 菜单 | 作用 |
|---|---|
| 系统配置 → 区域配置 | 全站区域模式、默认距离限制 |
| 区域管理 → 区域列表 | 各区域中心点、半径等（如有） |
| 商户管理 → 外卖 → 区域外卖配置 | 外卖配送范围、起送价等 |
| 商户管理 → 跑腿 → 跑腿区域配置 | 跑腿服务范围与计价 |
地图 Key 为全站共用；业务半径按区域单独配置。
验证是否生效
- 客户端打开带地图的页面（如地址选择、附近内容），地图正常加载、可定位。
- 外卖：商家入驻后，用户端能看到符合配送范围的店铺；下单时距离计算合理。
- 跑腿：创建跑腿单时起点终点解析正常，费用与距离匹配。
常见问题
地图空白或报 INVALID_USER_KEY
- Key 类型须为 Web 端，不是 Android / iOS SDK Key。
- 安全密钥必须与 Key 配对填写；漏填会导致 JS API 报错。
定位偏差大
- 浏览器 / 小程序需用户授权位置；HTTPS 环境下定位更稳定。
- 检查 区域配置 中的距离限制是否过小，导致内容被过滤。
外卖派单找不到骑手