万象-地图合规检查
何时用
- 用户要在任何底图上落点、画线、画区域（区位图、路径、点位分布）。
- 用户要做地图类可视化（看板、报告插图、网页地图）。
- 用户提到具体底图平台，或反馈地图打不开/一片空白（→ §5 故障表）。
> 本技能是前置门：地图类产出先过 §3 自检，再交付。合规不是"交付后补一句免责"，它是出图条件。
§0 三条铁律
- 领土要素不容错画。 国界、中国台湾、南海诸岛等要素必须符合国家标准；错画、错标、漏标一律不得交付。这是硬约束，不因"示意图""仅内部使用"而豁免。
- 底图只用白名单内的服务，且优先走默认场景。 白名单外平台（境外地图服务）要先讲清风险，再主动替换为合规方案 —— 不直接拒绝，但也绝不留用。
- 涉密与个人位置信息不落地。 不标注军事禁区、涉密单位、未公开的敏感坐标；他人位置数据不采集、不存储、不公开。
§1 底图三档处置
| 档 | 触发 | 处置 |
|---|---|---|
| ① 默认场景 | 用户未指定平台，或指定腾讯地图且未要求用自己的密钥 | 用默认底图 + 代理模式，用户无需配置密钥；按 §2 九条执行 |
| ② 非默认场景 | 用户指定高德 / 百度 / 天地图，或明确要求用自己的密钥 | 用用户指定的平台；密钥写成显式占位符（写清"请到对应开放平台申请后替换此处"），并在产出里说明：申请入口 + 如何替换集成 |
| ③ 白名单外 | 用户指定境外地图服务 | 不直接拒绝：先讲风险 → 再讲具体不合规原因 → 再主动给出合规替代方案与完整可用代码（替代代码须落在 ① 或 ② 的规则上） |
> 档 ③ 的正确姿势是替换，不是"提醒一下然后照做"。给不出合规版就别交付。
§2 默认场景九条硬约束
| # | 约束 | 不遵守的后果 |
|---|---|---|
| 1 | 坐标系用 GCJ-02（火星坐标） | 与其他数据叠加时整体偏移 |
| 2 | 容器必须有固定高度（100vh 或具体像素） |
地图渲染不出来，flex 布局下尤其常见 |
| 3 | 运行期占位符（形如 __WB_HTTP_PORT__、__WB_TMAP_SECRET__）原样保留 |
平台替换不上，地图与接口全废 |
| 4 | 只用手册里有的 API / 属性 / 事件 | 编出来的接口不存在，静默失效 |
| 5 | 服务类能力需按需加载（在 SDK 地址上追加服务库参数） | 服务类构造函数不存在 |
| 6 | 路径策略用字符串（如 LEAST_TIME / LEAST_DISTANCE / AVOID_HIGHWAY / REAL_TRAFFIC），不要用常量对象 |
策略不生效或报错 |
| 7 | 服务调用必须走 SDK 的类（路径规划、地点检索等），不要手工拼服务地址 | 拼出来的地址参数错，出现坐标为 NaN 或 403 |
| 8 | 不要传自定义样式 id | 默认密钥不支持自定义样式，误用导致底图变成空白灰 |
| 9 | 图层类带 Multi 前缀、样式类不带；标注图标用内联 SVG / base64，不引用官方演示图路径 |
类名写错构造失败；引用演示图路径会失效 |
> 口诀：坐标对、高度给、占位符别动、接口别造、服务走 SDK、样式别自定义。
§3 产出前合规自检（硬门）
| 项 | 查什么 |
|---|---|
| 领土 | 国界、中国台湾、南海诸岛等要素符合国家标准；无错画、错标、漏标 |
| 涉密 | 无军事禁区、无涉密单位、无未公开的敏感坐标 |
| 个人信息 | 批量点位须符合个人信息保护要求：不收集、不存储、不公开他人位置数据；个人打点坐标仅本地私存 |
| 底图 | 落在白名单内，且走的是 §1 的正确档位 |
| 标注 | 无"以官方地图为准"这类用免责句替代合规的写法（免责句不解决错画） |
⚠️ 自检不过 = 不交付。确需带风险交付时，把风险点、决策人、时间写进交付说明，不留"以为没问题"。
§4 行业常用图型的落地判据（自有增量）
| 图型 | 要点 |
|---|---|
| 区位图 | 需要「区域大位置 + 场地小位置」两级视野；先定视野中心与缩放级别，再落标注；标注文字要留避让，否则密集点位会叠成一团 |
| 现状分析图 | 底图要低饱和（自绘要素才是主角）；若要压淡底图，优先用图层透明度，不要去改底图样式 id（§2 第 8 条） |
| 场地条件图 | 常需叠加多类要素（道路/水系/周边设施）⇒ 分图层管理，每类一个图层对象，便于单独显隐与导出 |
| 出图与网页两用 | 网页版可直接用 SDK；要进报告/图纸的静态图，须额外做截图或导出流程 —— 不要指望"我看见了就等于导出了" |
§5 常见故障对照（"地图不出来"先查这里）
| 现象 | 最可能的原因 |
|---|---|
| 容器有边框但里面全白 | 容器没有固定高度（§2 第 2 条） |
| 底图变空白灰 | 传了自定义样式 id（§2 第 8 条） |
| 坐标为 NaN / 请求 403 | 手工拼了服务地址，没走 SDK（§2 第 7 条） |
| 服务类构造报"不存在" | 没按需加载服务库（§2 第 5 条） |
| 地图整体偏移 | 坐标系不是 GCJ-02（§2 第 1 条） |
| 部分接口静默无效 | 用了手册里没有的 API（§2 第 4 条） |
| 标注图标不显示 | 引用了官方演示图路径（§2 第 9 条） |
§6 本机实测坑
- "能出图"和"能进口袋"是两回事：网页里看得见的地图，不等于已导出成文件；交付前确认产物已经在磁盘上。
- 免密钥 ≠ 不用管密钥：默认场景走代理确实不需要用户配 key，但占位符必须原样保留，一旦手改就全断。
- 别把地图当图片：地图产出是代码 + 运行时，交付形态（网页 / 截图 / PDF）要在开工前问清。
- 视野与缩放：只看经纬度不够，缩放级别决定"看得见什么"；密集点位在小级别下会糊成一团。
- 静态导出 ≠ 截图：要进报告的地图建议单独走导出流程，别用截屏凑。
§7 能力边界与反例
能做：底图三档判定、默认场景九条约束、产出前合规自检、故障对照、行业图型要点。
不做：
| 反例 | 正确去处 |
|---|---|
| 用境外地图服务"先做出来再说" | 讲清风险 → 替换为合规方案 |
| 只在页脚写一句"以官方地图为准" | 免责句替代不了合规自检 |
| 标注敏感单位或未公开坐标 | 禁止 |
| 把他人打卡坐标批量落到公开页面 | 禁止；个人位置仅本地私存 |
| 出静态分析图时靠截屏凑 | 走导出流程 |
| 示意图就"不用管领土细节" | 不成立 —— 领土要素无豁免 |
常见误用与常见问题（FAQ）
常见误用（反模式）
| 误用 | 后果 | 正解 |
|---|---|---|
| 把领土要素画错／错标／漏标 | 硬约束，一律不得交付 —— 且不因「示意图」「仅内部使用」而豁免 | 国界、中国台湾、南海诸岛等要素必须符合国家标准（§0 铁律一） |
| 手工拼服务地址 | 参数错，出现坐标为 NaN 或 403 | 服务调用必须走 SDK 的类（路径规划、地点检索等），不要手工拼服务地址 |
| 路径策略传常量对象 | 策略不生效或报错 | 路径策略用字符串（LEAST_TIME／LEAST_DISTANCE／AVOID_HIGHWAY／REAL_TRAFFIC） |
| 地图不出来时凭感觉改配置 | 排查方向乱 | 先查「§5 常见故障对照」 |
| 产出前不跑合规自检 | 可能交付违规件 | 必须过「§3 产出前合规自检（硬门）」 |
| 底图自选 | 可能踩不合规源 | 按「§1 底图三档处置」判定 |
常见问题
- Q：默认场景有哪些硬约束？ A：见「§2 默认场景九条硬约束」。
- Q：常见图型怎么落地？ A：见「§4 行业常用图型的落地判据」。
- Q：有哪些本机实测坑？ A：见「§6 本机实测坑」。
- Q：本技能不覆盖什么？ A：见「§7 能力边界与反例」。
附 · 来源交代
| 项 | 说明 |
|---|---|
| 版本 | 1.0.0 |
| 建立日期 | 2026-09-19 |
| 来源 | 自研（origin: own）。建立动机：平台内置的地图合规系统件覆盖了本域的判定面，但它只在特定触发下加载，且为版本目录结构、随平台升级整体替换；而地图漏在合规之外，后果是交付级的。故自研一部常驻版，只吸收白名单分档、约束类别与自检项，不复制其文本；§5 故障对照、§4 行业图型要点、§6 本机实测坑为自有增量。 |
| 与系统件的关系 | 并存，不替换。系统件仍负责默认场景的快速起步；本技能负责前置合规门与故障归因。 |
| 著作权 | 署名 zzzzzzzp，All Rights Reserved |
