地图底图瓦片源

验证状态:已源码核验、未联调(第三方瓦片服务器不在本工作区);适用基线:源码归纳 @ 2026-09-14

用途与场景

App/Web 地图底图的瓦片 HTTP 源集合。中心服务不参与:浏览器按 Leaflet 瓦片模板直连第三方瓦片服务器。本页是 11 个瓦片操作的正本,实时监看等使用地图的域应链接本页,不重复定义。

使用位置

页面/功能 角色或空间分支
瓦片源模板定义(7 提供商全集) 登录用户地图页
底图图层装配(5 视图类型) 同上
视图类型选择(URL mapViewType 参数,zh 偏好 baidu/gao-de/tencent,en 偏好 google/open-street-map) 同上
消费页面(单机直播地图、回放 GPS 轨迹等) 同上

端点

GET {瓦片 URL 模板}(浏览器 → 第三方瓦片服务器直连,无中心代理、无鉴权头;模板与 {s}/{x}/{y}/{z} 由 Leaflet 填充)— 地图底图瓦片拉取。

11 个瓦片模板(百度/高德/谷歌/OSM/腾讯的普通图与卫星图变体)的完整 URL 模板表已随事实块删除,权威定义以 app/.client/lib/leaflet.ChineseTmsProviders.js 为准(模板属前端部署资产,非中心契约);可选视图集合由部署时 VITE_MAP_VIEW_TYPE_LIST 决定。该地址属外部地图服务(非本站端点,allowlist 豁免登记),无清单层条目。 坐标系注意:百度 BD-09、高德/腾讯 GCJ-02、OSM/Google WGS-84——跨底图混用坐标而不做纠正会导致点位偏移(Web 以 leaflet.mapCorrection.js 纠正)。

动线与完成判据

瓦片图块渲染可见即成功;单瓦片失败无重试/降级的装配证据(Leaflet 默认 errorTileUrl 为空)。

错误与边界

第三方服务无 SLA 承诺;配额、限流、服务条款变更、域名可达性均不在本仓库控制内。百度模板中的 udt=20230105、腾讯 version=376 为写死的时点参数,第三方升级后行为可能漂移。关键缺口:第三方瓦片服务器行为无本工作区证据,接入方需自行评估可用性与合规。

调用关系与资源清理

浏览器按需并发请求瓦片,地图销毁时由 Leaflet 释放图层。实时监看域对本页的引用挂接由整合票完成(票 13 handoff 记录)。

已知缺口

第三方瓦片服务器行为无本工作区证据(SLA、配额、限流、服务条款、域名可达性),百度 udt=20230105、腾讯 version=376 等写死时点参数可能随第三方升级漂移;按责任端归并统计见未发布正本与保留项「第三方服务边界」。未执行真实瓦片请求联调。