地图
地图资源是租户侧外部提供方配置，用于 Soln 中需要地图渲染、搜索、地理编码、逆地理编码、路线规划或地图瓦片的页面。
打开 系统管理 > 资源管理，然后在资源菜单中选择 地图。
页面结构
地图页面每次展示一个提供方配置。
| 区域 | 用途 |
|---|---|
| 提供方切换 | 在 Mapbox、Google Maps 等可用提供方之间切换 |
| 凭据表单 | 保存提供方 API Key 和提供方专属凭据字段 |
| 摘要 | 展示提供方、资源 Key、密钥状态和资源状态 |
| 预览 | 凭据准备完成后展示地图预览 |
| 提供方资料 | 展示说明、官网地址、提供方编码、状态和更新时间 |
提供方切换
使用右上区域的提供方切换菜单，选择要配置的地图提供方。
| 提供方 | 说明 |
|---|---|
| Mapbox | 用于全球地图渲染、搜索和样式相关地图能力 |
| Google Maps | 用于全球地点、路线规划和地图瓦片能力 |
每个提供方都有独立的资源 Key、接口地址、能力和密钥配置。
凭据字段
| 字段 | 是否必填 | 说明 |
|---|---|---|
| API Key | 是 | 地图运行时调用和预览加载时使用的提供方凭据 |
| 安全 JS Code | 按提供方需要 | 浏览器侧安全校验值；只有需要该字段的提供方才会展示 |
如果当前提供方尚未创建，页面会展示提示。保存 API Key 时会先创建提供方资源，再保存密钥配置。
摘要
摘要区域用于确认当前提供方是否已经配置完成。
| 项目 | 说明 |
|---|---|
| 提供方 | 当前提供方名称和默认资源名称 |
| 资源 Key | 标识地图资源的稳定 Key |
| 密钥状态 | 必需密钥字段是否已配置 |
| 状态 | 资源状态，以及是否为当前默认提供方 |
预览
预览区域会使用当前凭据草稿加载提供方预览。输入或更新 API Key 后，可以通过预览确认凭据是否能初始化地图。
如果预览无法加载，需要检查提供方密钥、提供方账号限制、允许访问的域名，以及当前租户工作区是否使用了正确的提供方。
提供方资料
提供方资料展示当前提供方的元数据。
| 字段 | 说明 |
|---|---|
| 说明 | 默认提供方说明或已保存的资源说明 |
| 官网地址 | 提供方官网链接 |
| 提供方编码 | 资源中保存的提供方标识 |
| 状态 | 当前资源状态 |
| 更新时间 | 提供方资源最后更新时间 |
常见流程
- 打开 系统管理 > 资源管理 > 地图
- 从提供方切换菜单中选择提供方
- 输入 API Key 和提供方专属凭据字段
- 点击 保存配置
- 查看摘要，确认密钥状态已配置
- 使用预览确认提供方可以加载
- 需要重新读取服务端最新资源时，点击 刷新
注意事项
地图资源属于当前租户工作区。请在地图字段或地图相关运行时功能实际使用的租户中配置提供方。
提供方凭据轮换后，需要在当前页面更新 API Key，确保运行时页面继续使用最新密钥。