# 周边地图页 PRD

版本：v0.3  
状态：当前正式需求

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 以地图、POI 和路线查询为主承载建立周边页。 |
| 2026-08-03 | v0.2 | 异常用例补充 | 补充路线失败后的继续浏览用例与地图不可用时的列表排序来源。 |
| 2026-08-03 | v0.3 | 合并旧 PRD / 重大范围确认 | 合并旧周边地图页的独立访问、页面装配、状态、响应式与验收；地图、POI 和路线细则仍以 Widget PRD 为准。 |

## 1. 目标与用户用例

顾客独立进入后，围绕固定项目位置探索已配置的周边 POI，选择 POI 后查看详情、路线、距离与时间参考。用户用例：筛选点位 → 查看详情 → 查询路线 → 返回地图；路线失败时仍可切换 POI、出行方式或继续浏览。

## 2. 页面内容与边界

| 层级 | 承载内容 | 页面规则 |
| --- | --- | --- |
| 页面框架 | 项目识别、页面导航、状态反馈 | 仅在访问许可后显示。 |
| 主内容 | 周边地图 Widget | 承担项目锚点、POI 分类、点位、详情、路线、距离与时间参考。 |
| 页尾 | 项目联系组件 | 位于主要内容之后。 |

- 页面不在 Widget 之外重复计算路线、距离、时间、POI 分类或推荐顺序。
- 地图、项目坐标与 POI 必须在受限页面完成登录和当前页授权后才加载。
- 不做项目间导航、用户位置追踪、常驻导航、地图数据编辑、路线结果承诺或页面内预约。

## 3. 核心流程、状态与响应式

1. 完成全页面通用访问判断后，加载地图与已发布 POI。
2. 顾客选择类别或点位，打开详情面板，并以项目为起点选择可用出行方式查询路线。
3. 路线失败时展示局部提示；顾客可保留当前 POI、改选方式或继续浏览。
4. 地图整体不可用而有可读 POI 列表时，展示列表并沿用 Widget 已配置的推荐顺序；不得基于不可用地图推算距离排序。

| 状态 | 页面处理 |
| --- | --- |
| 单类 POI / 路线失败 | 局部提示，地图和其他点位继续可用。 |
| 地图整体不可用 | 由 Widget 按可用列表或明确不可用提示降级；不进入 403/404。 |
| 页面无效或已登录无权 | 分别进入统一 404 / 403。 |

采用 **VISTA C 地图、右侧面板/详情面板、筛选与导航**：移动端须避免面板遮挡关键地图操作，PAD/PC 可扩展地图与面板并列范围。精确地图控件、详情面板位置和转场为 **待设计系统补充**。

## 4. 验收

| AC | Given | When | Then |
| --- | --- | --- | --- |
| AC-MAP-01 | 本页已发布且地图、POI 可用 | 顾客通过本页链接进入 | 无需经过项目概览即可查看项目位置与周边点位。 |
| AC-MAP-02 | 顾客切换分类并选择 POI | 打开详情并查询路线 | 地图、列表/详情和路线结果保持对应。 |
| AC-MAP-03 | 路线查询失败 | 顾客继续使用 | 只显示局部失败，可改选方式、点位或继续浏览。 |
| AC-MAP-04 | 地图整体不可用且有已发布 POI 列表 | 页面继续显示 | 列表沿用既有推荐顺序，不伪造距离排序。 |
| AC-MAP-05 | 320px 至 1440px | 顾客筛选、查看详情、查询路线 | 核心地图操作不被面板遮挡且可完成。 |
| AC-MAP-06 | 320px 至 1440px 且路线查询失败 | 顾客查看局部失败提示 | 提示不遮挡地图、POI 切换或出行方式调整。 |

## 5. 明确不做

- 不做用户定位追踪、跨项目路线、地图编辑、路线时间承诺、常驻导航、分享或页面内预约。
- 不在页面层复制地图 Widget 的点位、路线和距离规则。