地图帮地图动画（AE 插件）
地图帮地图动画使用手册
适用于 1.0.0。安装包与安装步骤见产品页。首次启动直接进入地图工作区；更多菜单中的使用帮助可随时打开或关闭。
0. 安装与会员
安装包 dtb-geolayers-1.0.0.zxp 是标准 Adobe ZXP 扩展包，用 ZXP 安装器打开，或改名 .zip 解压到 CEP 扩展目录 com.dtbgis.geolayers，然后完全退出并重启 After Effects，在「窗口 → 扩展 → 地图帮地图动画」打开面板。
插件的制图工具全部免费，不登录也能用；地图帮自己提供的服务需要普通会员（高级 / 企业会员同样可用）：
| 免费（不登录即可用） | 普通会员起可用 |
|---|---|
| 全部原生制图工具：地图合成、标签、面样式、固定图层等 | 地图帮行政数据来源：省市区县检索与完整边界面 |
| 开源数据来源（Natural Earth / OSM / MapTiler）与自定义 XYZ 底图 | 地址 / POI 检索与精确定位、国内路线规划（按流量豆计量） |
| 高清图片导出（高 / 中 / 低质量） | 城市数据图层（按数据豆计量） |
| 百宝箱工具 | 地图帮底图样式（国内瓦片） |
| 场景动画预设浏览与效果预览 | 星球所标签模板与面样式；场景动画预设创建 |
点到会员服务时插件会弹出引导：未登录给「微信扫码登录」，已登录但还不是会员给「开通普通会员 / 我已开通，刷新会员状态 / 查看会员权益说明」。开通后点刷新即可继续，不用重启 AE。桌面端、在线平台与插件共用同一个账号和会员身份，权益口径见会员权益。
1. 顶部操作
第一排是地图帮品牌账户、创建或管理地图、当前地图、导出和最终渲染。品牌账户菜单包含扫码登录、会员状态、流量豆/数据豆余额及刷新入口，不再单独展示一排商业按钮。
第二排是单行地图环境状态：行政数据来源、语言、地图样式、数据图层和更多。窄窗口会把低频项移到更多，原功能仍可使用。
第三排从左到右是场景动画、百宝箱，然后沿用原生工具：对象工具、标签模板、面样式。窄窗口必要时可横向滚动这排工具，不改变地图与 Favorite Features 布局。
2. 行政数据来源
默认选择 地图帮。搜索“中国”或“中华人民共和国”指向同一国家边界；省市区县支持名称与 adcode。选择行政区结果应显示完整面，不只是中心点。地图帮来源是会员服务：未登录或非会员时检索返回空结果并提示一次，不会报错打断操作。
选择 开源数据继续使用原生 Natural Earth / OSM 等能力，不需要登录，保留英文检索并适配已有中文国家名；不承诺所有全球地名的中文检索都有结果。首次切换会提醒核验中国国界及行政区划表达。
来源切换会清理旧搜索结果，失败不会静默换源。用户自配底图不会仅因行政来源切换被替换。检索语言、地图标注语言与行政来源不是同一设置。
3. 登录、路线与数据图层
公开地图浏览不要求先登录。需要账户的服务可从品牌菜单扫码登录；普通用户不使用开发令牌。会员资格与用量计价由服务端判定，插件不另建账本。
国内路线保留驾车、步行、骑行，是会员服务；点击时若不满足会先弹引导，放弃则静默结束。开源路线提供方可能需要 API 凭据；缺失时在“偏好设置 → 路线 API”配置后重试，不会自动切换行政来源。
数据图层为地图帮提供的城市/行业能力，是会员服务。开源来源下会说明原因并提供显式切换入口。城市数据导入表单按 区县 adcode → 行业小类 → 年份 → 确认操作；留空年份取服务端最新值。目录条目只有携带实际导入字段时才预填，完整主题或大批量数据通过在线平台入口处理。
4. 标签、样式与动画
地图样式菜单提供星球所标签和面样式安装入口（会员服务）；窄窗口从更多进入。安装期间避免重复操作，完成后查看新建、更新、保留和失败汇总；用户修改的样式不应被自动覆盖。
非会员新建地图时默认使用原生开源底图；显式选择地图帮底图样式时会提示一次会员说明。
从场景动画选择预设、时长、强度和冲突策略，在当前时间生成可编辑关键帧。浏览与预览免费，「创建动画」是会员服务，不满足时状态行会说明原因。保护已有关键帧是默认策略。请以 AE 时间线上的实际秒数/帧数核对时长，尤其是外层合成和已有动画的工程。
5. 百宝箱
场景动画右侧的「百宝箱」收纳地图制作常用的 AE 小工具，免费使用。首个工具「路径生成空白对象」作用于时间轴里选中的形状「路径」或蒙版「蒙版路径」属性：
- 点跟随空白（AE 原名「空白后接点」）：每个顶点建一个空白对象并让路径跟随它们，拖空白对象即可改路线走向。
- 空白跟随点（AE 原名「点后接空白」）：每个顶点建一个跟随顶点移动的空白对象，可把标注、图标钉在路径上。
- 追踪路径：建一个沿路径运动并自动朝向前进方向的空白对象，带进度与循环控制，把图标或车辆图层的父级设为它即可沿路线移动。
空白对象建在源图层上方，命名为「图层名: 路径名 [层级.顶点序号]」，重复点击不重复创建；每个动作是一步撤销。
6. 导出
打开“导出”设置高/中/低质量与默认存储目录。保存后点击导出高清图直接输出，不需要每次选择保存位置。首次配置、目录不可写或取消时按面板提示处理，已有同名文件不应被覆盖。
导出的是合成视图里当前激活的合成：看外层合成就导出含边界、标注、路线的完整画面；看地图合成本体就只导底图。没有激活合成时退回导出所选地图的外层合成。32 bpc 工程下导出图不再整体偏暗。
最终渲染与导出图片是不同动作：最终渲染完成地图素材生成，图片导出输出当前帧。
7. 自检与支持
更多菜单中的瓦片自检使用面板内表单，不再连弹原生输入框；失败可改地址重试。一次请求结果只能说明观测状态，不足以单独归因。
复制诊断只包含版本、宿主、来源和状态，不含工程、令牌、检索文本或私有地理数据；复制不等于上传。若剪贴板不可用，可手动选择文本。
更新检查需要手动触发。检查中、已最新、有新版、本地较新、检查失败分别提示；404、超时或非法清单不能显示为“已最新”。