广州地铁：首期站点、入口与资料精度
核查日期：2026-10-09。首期给已有客村、广州塔与琶洲街区接入五个地铁站，用于入口交互、站厅体验和线路传送。完整矢量线网图用于查看；可传送站点仍是可玩街区子集，没有把所有站点的街区与出入口标成已完成。新港东、琶洲等站在当前地图东界之外，需随街区扩建后接入。
首期范围与实际线路
| 站点 | ID | 实际线路 | 首期有坐标的入口 | 资料限制 |
|---|---|---|---|---|
| 客村 | kecun | 3、8 | A、B、C、D | C、D 与商业地下空间的具体接驳尚未按竣工图重建 |
| 广州塔 | canton-tower | 3、APM | A、B | 仅采用已核查的两处 OSM 地面入口；没有把未核查的 APM 通道另建成入口 |
| 赤岗塔 | chigang-pagoda | 12 | A、B | 与广州塔是两个不同站；不创建 APM 或 3 号线的虚构直接换乘 |
| 赤岗 | chigang | 8、12 | C1、C2 | 现实已开放 B、D、E；首期缺少这三处可靠坐标，暂不生成 |
| 磨碟沙 | modiesha | 8、18 | B、C、E1、E2、H、J1、J2 | 8、18 号线实际站体分开；站厅、长换乘通道的尺寸尚未取得竣工资料 |
首期传送拓扑：3 号线为广州塔—客村；8 号线为客村—赤岗—磨碟沙；12 号线为赤岗塔—赤岗。APM 与 18 号线在已有街区各覆盖一站，没有虚构到未建街区的落点。线路图展示完整线网；可传送目的地仍对应上述已有街区。
GTA 风格矢量线网与交互精修
2026-10-09 改用独立绘制的 SVG 完整线网。深色地图底、细线路、紧凑中文站名与换乘标记延续游戏的 GTA V 菜单方向；当前站、所选目的站和可玩行程单独强调。缩小时减少站名拥挤，放大后显示更多站名。地图支持适应全图、缩放、拖动、双指缩放、展开及定位当前／所选站点。
官方线网图用于核对站序、换乘与图上布局，不再显示或分发其 PNG、标识、图例、字体和版式素材。SVG 由游戏组件自行绘制；完整结构化数据保存在 assets/maps/guangzhou-metro-source.json，图上坐标与游戏世界的入口坐标分开。该数据不提供实测站体尺寸，也不把图示坐标当作街区米制位置。
站序和站点图示坐标取自广州地铁公开接口：POST https://apis.gzmtr.com/app-map/metroweb/linestation、POST https://apis.gzmtr.com/app-map/station/getByNameOrCode/{站名或站码}。采集日期、响应校验值与覆盖范围保存在数据的 source 记录中。它是固定采集快照，不是运行时查询的运营状态；站点 open 只反映接口快照。程序保留 3 / 14 号线分支、12 号线两段以及 11 号线闭环，不把不相连的区段直接接起来。
当前快照为 503 个站点、31 条线路、34 个区段，包含广州／佛山地铁、城际与有轨电车；独立绘制后为 568 条去重相邻站边，画布 1600 × 1450。31 不是广州地铁线路数量的单独统计。机场南未出现在本次接口返回的区段中，不补成可用站点；未知站或未来线路同样不臆造为已开放。
| 核查内容 | 采集时间（UTC） | SHA-256 |
|---|---|---|
官方 linestation 原始响应 | 2026-10-08T16:34:36.604Z | 15f98db3a401cd03a02c4cc45beabd08f71d435b9be712c4be490e3d75ef03ad |
| 503 份站点详情按源站名排序的 JSON 集合 | 采集完成于 2026-10-08T16:42:43.816Z | 65810d29682700f43c31bc524922c2a9cf0f102fc943dfae76066f3280cc2040 |
人工显式更新可运行 node scripts/import-metro-network.mjs；脚本匿名读取公开接口，使用临时缓存、合理并发、完整性校验和原子写入，不包含令牌。--refresh 重新读取当日接口。更新后需要复核线网、统计和测试，不在游戏启动时自动刷新。
这些官方站名、线路和图示坐标的来源与 OSM 入口数据分别记录。接口没有明确提供数据开放许可证，本文不为官方资料另行声明 ODbL 或 MPL 授权。此次没有引用 RMP 图库的 GPL 几何／代码，也没有引入 OpenMetro 库代码或地理坐标数据。官方资料是事实核查依据，地图的 SVG、界面样式及交互由本项目实现。
metroVectorNetwork.ts 将完整线网数据转换为节点、多段线路、相邻站边和可玩站点热点；图形、站名与热点使用同一坐标系。行程高亮只沿真实相邻站边绘制，不在图上直接连起起点与终点。换乘站保留各条线路的关联；广州塔的地铁站与同名有轨电车站依据来源身份分别处理。
官方原图的既有核查资料：2026-06-05 南方+ 发布稿、花都区交通运输局转载。原 PNG 已从媒体清单和 public/maps/ 中移除；轻量数据随线路弹层按需打包，游戏和离线客户端均不访问地铁 API 或新闻 CDN。
共享导视数据的五条可玩线路颜色保留此前核查值：3 号线 #ee9d4a，8 号线 #00848b，12 号线 #505812，18 号线 #0046b5，APM #00b9e2。这些值来自参考图色条采样，不宣称是运营方提供的印刷色彩规范；完整矢量图的其余线路以来源数据记录的颜色为依据。UI 面板、文字、焦点、选中与行程颜色使用共享 token。
实际线路核查依据
- 广州市委网信办的广交会地铁出行说明，2023-10-13：8 号线在客村换乘 3 号线，在磨碟沙换乘 18 号线。本次未采用其历史运营时刻表。
- 广州市政府：海珠有轨电车启用新广州塔站，2025-07-01：明确地铁 3 号线广州塔站 A 口、APM 线广州塔站 2 号通道。文中的有轨电车广州塔站与地下地铁站分开处理。
- 广州市民政局的 12 号线东段站名意见说明：明确广州塔附近的新站与既有 3 号线广州塔站不是换乘站，赤岗站与 8 号线同名换乘。该文件为命名意见材料，结合开通记录使用。
- 广州市发改委：12 号线赤岗站开通后线网票价复函，2026-01-22；广州日报的开通报道，2026-02-13，报道直接引述广州地铁并由通讯员供稿：赤岗自 2026-02-13 起提供 12 号线服务并换乘 8 号线。不能继续按 2025 年开通前的资料标成仅有 8 号线。
地理坐标与许可
metroNetwork.ts 将 OSM WGS84 节点投影到现有原点 [113.3196, 23.0995]，东西方向为 X、北向为负 Z。入口坐标独立于道路筛选数据，保留原始入口位置，不把地铁站的地下中心点或路网吸附点当作实际入口。运行时只显示已加载地图包围盒内的入口。
这些坐标沿用 © OpenStreetMap contributors / ODbL。下列节点编号在入口 source 中保留可追溯链接。数字精度反映源数据的小数位数，不意味着经过测绘；入口有的编辑时间较旧，不能仅因抓取于 2026 年就称为当日实景。
| 站点／入口 | OSM 节点 | 经度、纬度（WGS84） | 节点最后编辑日期 |
|---|---|---|---|
| 客村 A | 7177074159 | 113.3157668, 23.0991690 | 2026-03-13 |
| 客村 B | 7177074160 | 113.3141849, 23.0992179 | 2021-09-29 |
| 客村 C | 7177074180 | 113.3144886, 23.0984278 | 2021-09-29 |
| 客村 D | 7177074179 | 113.3155421, 23.0984764 | 2022-01-17 |
| 广州塔 A | 3039025449 | 113.3176082, 23.1095114 | 2021-08-30 |
| 广州塔 B | 2915880715 | 113.3175081, 23.1083949 | 2021-08-30 |
| 赤岗塔 A | 13403171830 | 113.3185766, 23.1044840 | 2026-03-19 |
| 赤岗塔 B | 13661357608 | 113.3195352, 23.1043319 | 2026-03-19 |
| 赤岗 C1 | 5071075309 | 113.3285342, 23.0982961 | 2026-03-13 |
| 赤岗 C2 | 4019937562 | 113.3292293, 23.0987906 | 2021-09-14 |
| 磨碟沙 B | 4019922609 | 113.3358501, 23.1014828 | 2021-10-02 |
| 磨碟沙 C | 4019922608 | 113.3356586, 23.1008355 | 2021-10-02 |
| 磨碟沙 H | 9139889972 | 113.3380451, 23.1046351 | 2022-02-06 |
| 磨碟沙 E1 | 9451979693 | 113.3386347, 23.1020876 | 2022-01-27 |
| 磨碟沙 E2 | 9451979691 | 113.3386334, 23.1022150 | 2022-01-27 |
| 磨碟沙 J1 | 9451979689 | 113.3381446, 23.1020984 | 2022-01-27 |
| 磨碟沙 J2 | 9451979687 | 113.3381443, 23.1022233 | 2022-01-27 |
赤岗旧 D2 节点 4019937561 仍在源响应中，但当前开通报道列出的五个口是 B、C1、C2、D、E；首期排除旧 D2，不用它冒充新的 D 口。广州塔的 OSM old_name 含历史“赤岗塔”，也不因此将现有 12 号线赤岗塔合并成同一站。
站点标记采用 OSM 站节点：客村 5594210092、广州塔 5594226424、赤岗塔 12961547201、赤岗 8541171536、磨碟沙 8 号线 9225232063。磨碟沙 18 号线节点 9110804367 另处于海洲路，首期将其线路归入同一换乘站，不在地图上伪造第二个“磨碟沙”目的站。
原始 API 读取记录（响应含每个要素的版本，不含统一测绘日期）：
| 读取 URL | 获取时间（UTC） | SHA-256 |
|---|---|---|
| 客村原始响应 | 既有立交提取，2026-10-08 | c7b011ba24e6bebde7ff893de12d6c24a33e70d38ff89da52a1c4c3bf7ddbe7c |
| 赤岗／磨碟沙原始响应 | 2026-10-07T08:09:11.033Z | 183a580f512532ca0ecc584240606b243abc59d3e1f4329cdd672f3b78f6dbf3 |
| 广州塔／赤岗塔原始响应 | 2026-10-08T12:57:08.667Z | cc9f1297800bec7a8801ed4f42e43d2b376618b0f79daa31ff724347f5200593 |
前两份复用已有本机 /tmp/interchanges-osm/kecun.json、/tmp/pazhou-osm/map.json；第三份保存于 /tmp/dayun-metro-tower-osm.json。临时文件不是发布依赖，游戏不在线请求地图接口。API 将来可能更新，上述哈希只对应本次读取的响应。
外观参考与尚未精细还原的部分
首期入口、台阶、栏杆、雨篷和站厅为程序模型。位置有 OSM 依据；入口朝向、净宽、雨篷形状、台阶数量、材质、站厅尺寸和布局是游戏近似。MetroPortal.approximation 显式为 true。进入站厅与通过线路图传送是游戏功能，没有据此宣称所有车站已按街景或施工图精细还原。
withMetroEntrances(map) 在运行时替换客村 A、广州塔 B、赤岗 C1/C2 所在的四个小体量无名轮廓 977852353 / 977852351 / 983078541 / 983078542，避免通用挤出盒与新入口重叠。依据是入口节点落在对应小轮廓内，轮廓尺度符合入口亭，属于场景构件判断；OSM 的 building=yes 没有直接命名这些入口亭。替换还检查无名、节点重合及尺寸上限，不删除附近普通建筑，不改原始地图 JSON。丽影广场 B/C 区整体保留。
客村 C/D 的源节点处于商场内部，不能直接作为骑行传送落点。按现有丽影轮廓计算，C 源点 (-523.3813, 119.3573) 到北侧外墙 (-523.4171, 113.4353) 为约 5.92 m；D 源点 (-415.5083, 113.9472) 到北侧外墙 (-415.5697, 107.3855) 为约 6.56 m。入口外的站立与交互位置可沿对应朝外方向再移约 2 m，并继续检查道路、碰撞与水域；这是游戏落点近似，不修改原始入口坐标，也不称为精确门口。独立入口亭的可用位置同样需保留碰撞净距。
本次站内状态不单独持久化。玩家在站厅中存档后恢复到站外对应原入口，地面恢复位置使用同一套安全落点规则；后续按各站实际平面与楼层结构扩展时再记录室内区域与楼层。
可继续精修的公开资料：
| 资料 | 可核对内容 | 使用边界 |
|---|---|---|
| 广州市规划和自然资源局：12 号线赤岗站附属工程，2026-01-13 | 项目位置、附属工程正式名称及许可办理记录 | 此次可读页面为受理公示，未取得带比例尺的入口竣工图，不将它记成已取得 CAD／BIM |
| 广州地铁通讯员提供的赤岗站站厅与 B 口实景，2026-02-13 | 开通时 B 口外观与站厅设施、B/D/E 与 C1/C2 的入口名单 | 新闻原始摄影用于观察；尚未配准 B 口坐标及尺寸，不将新闻图片打包为贴图 |
| 广州市规划和自然资源局：18 号线磨碟沙站 III 号出入口，2025-05-23；广州国际文化中心合建区调整说明，2025-06-24 | 海洲路北侧、与文化中心合建区的工程关系 | “III 号”是工程名称，不能未经核对改成运营字母口；公示、审批及在建说明不能当作已经开放 |
| 广州地铁无障碍设施信息，2025 年 1 月版 | 客村、广州塔、磨碟沙等站的入口设施记录 | 为政府站点公开的运营方 PDF；本次检索可读设施索引，正文 PDF 抓取未成功。它早于 12 号线赤岗开通，不用于补全 2026 年入口状态 |
本次尚未取得各站可靠的出入口平面图，因此没有宣称已核查其所有运营站点图。后续按站收集运营方出入口图、用户拍摄街景及原始设计方公开图纸，以实景方位、多个已知道路点和图示比例尺配准；商业街景的观察与图片分发许可分别记录。通用站厅模型不替代实测车站平面图。
数据与后续扩展
MetroStop 保存站 ID、中文名、所属线路、米制站点标记与入口数组；每个 MetroPortal 保存稳定 ID、口名、米制位置、弧度朝向、节点来源与近似标记。METRO_LINES 中的 stations 只记录可玩的连续子区间。若将来加入某线路中间缺站，不能简单连接两端并显示成相邻站，需先补全真实拓扑。
findMetroRoute(from, to) 优先少换乘，再少经过站。返回 stations 为依次经过的站 ID，lines 为每段所用线路 ID（比站数少一项），transfers 为换线次数。同站返回零段；未知站返回 null。此结果用于游戏传送，不是票价、运营时刻或真实乘车时间查询。
后续分批扩展：先补赤岗 B/D/E 与广州塔 APM 通道的坐标和近期外观，再精修客村、赤岗塔、磨碟沙各自的入口形态及站厅；随着东侧道路、地面与建筑加载范围扩大，增加新港东、琶洲和 11 号线。完整矢量线网保存完整站序、分支、换乘和资料快照，仍仅对已有街区开放落点；全广州行程与出入口需要随街区扩建继续核实。入口与站内模型按站或区域延迟加载，继续遵守街区整帧及发布性能预算。
metroNetwork.test.ts 检查真实入口投影、17 个稳定入口 ID、旧 D2 排除、当前地图范围裁剪、仅替换四个小入口亭及保留丽影商业体、广州塔与赤岗塔分离，以及双向行程、换乘次数和非法站点。metroDiagram.test.ts 与 metroVectorNetwork.test.ts 检查完整数据、图示坐标、相邻站边、分支／闭环、来源快照和热点覆盖；useMetroDiagramView.test.ts 检查全图适应、锚点缩放、双指中点和拖动边界。浏览器回归覆盖完整 SVG 按需加载、矢量热点对齐与行程高亮、屏外热点排除菜单焦点、热点起手双指缩放、展开 Esc／B 焦点恢复、开发入口不遮挡对话框，以及桌面／手机的进站、传送和存档恢复。