# 地图 VR 配置
> 为作品添加地图地理位置与导航展示，把各场景按坐标标注在地图上，开启后访问者可在地图与全景之间切换浏览。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「视角设置」中打开地图 VR 配置。先在「场景设置」中为各场景确认坐标（无定位信息时手动拖拽选择），再到「地图设置」中开启显示并调整地图参数。设置完成后点击「保存配置」。注意地图开启后不能与房产沙盘的地图模式同时使用。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 为各场景定位坐标并在地图上显示
- 开启或关闭地图显示
- 查看卫星地图、地图等级、地图中心等参数
- 开启缩放聚合并调整聚合间距

## 3. 业务说明

### 配置区域

面板顶部说明「地图VR功能可为您的全景作品添加地理位置和导航功能，支持场景定位和地图预览！」。标签页为「场景设置」「地图设置」（手机端还包含「地图预览」）。「场景设置」是场景位置列表；「地图设置」是地图参数配置。底部为「关闭配置」「保存配置」。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 场景位置设置 | 若原素材携带定位信息则自动显示在地图上，否则需手动拖拽选择坐标点 | 场景列表 | — |
| 坐标未设置 / 坐标 | 显示该场景在地图上的经纬度；未定位时显示「坐标未设置」 | 只读展示 | — |
| 开启显示 / 已显示 | 把该场景点位显示到地图上，可在地图上拖拽调整位置 | 按钮，点击切换 | — |
| 开启显示（地图设置） | 开启后前台打开会显示为地图，不可与全景沙盘的地图模式同时开启 | 开关 | 默认关闭 |
| 卫星地图 | 显示卫星地图状态 | 只读：已开启 / 已关闭 | — |
| 地图等级 | 当前地图缩放级别 | 只读展示，地图移动时更新 | 默认 12 |
| 地图中心 | 当前地图中心坐标 | 只读展示，地图移动时更新 | 有系统默认中心 |
| 缩放聚合 | 开启后相近的点位会自动聚合显示 | 开关 | 默认关闭 |
| 聚合间距 | 调整聚合判定的间距 | 滑块，1 到 200 | 默认 40 |

### 保存与生效

点击「保存配置」写入配置，提示「保存成功」。保存时若有已开启显示的场景仍未取到坐标，会中断并提示「地图位置信息获取失败, 请重新开启地图显示后再试」。保存后需重新发布作品，访问者才能看到地图。

## 4. 使用说明

1. 在编辑器左侧点击「视角设置」，打开地图 VR 配置
2. 在「场景设置」中为各场景确认坐标，无定位信息时点击「开启显示」后在地图上拖拽定位
3. 切换到「地图设置」，开启「开启显示」并按需设置缩放聚合与聚合间距
4. 点击「保存配置」，再回到编辑器发布入口重新发布作品

## 5. 规则与限制

- 地图开启后不能与全景沙盘的地图模式同时开启
- 已开启显示但未取到坐标的场景会导致保存被中断
- 坐标依赖原素材的定位信息，缺失时需要手动拖拽定位

## 6. 状态与异常

- 场景已定位时显示坐标，未定位时显示「坐标未设置」
- 点位已显示时按钮显示「已显示」，否则为「开启显示」
- 地图位置信息获取失败：提示「地图位置信息获取失败, 请重新开启地图显示后再试」

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [视角设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/view.md)
- [房产沙盘配置](https://9kvr.cn/site/tour/editor/config/view/propertySand.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云编辑器公开版本配置与真实界面
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验