SpaceZephyr / map-motion

# map-motion · 地图动效视频 Skill
给 Claude Code 用的地图动画 skill：用一句话描述（或一份 JSON 镜头表），出一段**基于真实高德地图数据**的地图动效视频——竖屏/横屏 MP4，外加 GIF。
> 路线是高德真实的驾车/步行/骑行路线，边界是真实的行政区和公园轮廓，海拔是 SRTM 卫星高程，底图可以直接用高德标准地图或卫星图。
## 能做哪些视频
### 1. Vlog 片头「我在这里」
卫星地球俯冲 → 瞄准镜收缩锁定（LOCKED）→ 坐标卡：地名逐字打出、经纬度滚动到位、海拔、拍摄时间。10 秒，直接接你的 vlog 正片。
`assets/examples/vlog_locate.json` · `vlog_locate_night.json`
### 2. 徒步登山：路线 + 海拔剖面
镜头跟着人沿高德步行路线上山，底部的海拔曲线同步画出，实时显示海拔和累计爬升，山顶插旗。
深圳梧桐山，泰山涧 → 大梧桐：3.6 km，海拔 98 → 916 m，累计爬升 835 m。`hike_elevation.json`
### 3. 长途骑行 / 自驾：多站旅程
一次写完整趟行程：逐段路线、累计里程表、「DAY n · 日期 · km」、到站邮戳、照片拍立得、原路返程。
青海湖环湖骑行（高德骑行路线 365 km，海拔 3,200 m 上下）· 国庆自驾深圳 → 香格里拉往返 4,213 km。`cycling_trip.json` · `road_trip.json`
### 4. 介绍一个地方：公园、景区、校园
从地球或行政区推进到一个地块，描出轮廓、填色，再从地铁站步行过去、绕园一周。
上海徐汇区桂林公园。`park_locate.json` · `park_walk.json`
### 5. 航线、行政区、业务分布
城市间飞线（大圆航线，飞机沿弧飞）、行政区依次描边高亮、一个中心向多城辐射。
`showcase.json` · `flight.json` · `region.json` · `radiate.json`
### 6. 找机位：照片从地图上「咔嚓」翻出来（子 skill `photo-spot`）
给一张照片：卫星地球俯冲 → 相机图标落在拍照机位、被摄地落针 → 取景扇形扫过去 → 取景框对焦 → 快门声＋闪白 → 照片从机位处 3D 翻折立起，背景是照片自身的虚化；可加 iPhone Live Photo 播放效果（用真 MOV，或静态照片模拟）。照片带 GPS 时自动读出机位、朝向、焦距和参数。
富士山 × 新干线（境外，Esri 卫星）· 雨崩神瀑 → 卡瓦格博（Live Photo 模拟）· 香港钓鱼翁 → 布袋澳。`photo-spot/`（安装见下）· 示例 spec 在 `photo-spot/examples/`
### 7. 3D 地形：像 Google Earth 一样的立体轨迹（子 skill `map-3d`）
真实山体起伏（AWS 高程 + Esri 卫星，MapLibre GL 渲染）：卫星地球俯冲 → 整条路线 3D 鸟瞰 → 镜头贴着人/车沿路线走（走过的线变黄，里程、海拔、累计爬升、小地图、底部海拔剖面实时走，沿途弹照片）→ 拉回全景出总数据。路线可以是 GPX（两步路、六只脚、Strava、手表）、高德驾车/骑行/步行规划，或没有 GPX 时沿 OpenStreetMap 小路连途经点；也能只给一个地方，俯冲后绕着转一圈。
香格里拉 → 飞来寺自驾 171 km（高德驾车路线，预览 2 倍速）· 卡瓦格博单点环绕。`map-3d/`（安装见下）· 示例 spec 在 `map-3d/examples/`（另有雨崩神瀑徒步、泰山红门登顶）
### 8. 光线推演：几点日照金山、机位几点见光（`map-3d` 的 `"mode": "sun"`）
给山峰、机位、日期，按真实太阳位置（NOAA 算法）和周围山体遮挡（沿太阳方向在高程上找地平线）算出：天文日出、山顶受光（日照金山开始）、金色褪去、机位见光。画面上时间快进，山体明暗跟着真实太阳方位走，天空变色，顶部时钟 + 罗盘，底部关键时刻表到点打勾。
10 月 15 日飞来寺看卡瓦格博：07:21 峰顶受光（比天文日出早 4 分钟）、07:52 金色褪去，而飞来寺被身后山坡挡着，09:54 才见光。
### 9. 旅行 vlog：卡通小人沿路线走、到站拍照（子 skill `travel-vlog`）
一组旅行照片 → 按 GPS 和拍摄时间排出机位 → 沿真实步行/驾车路线连起来；用本人照片 AI 生成 Q 版形象（也有内置小人），小人一颠一颠地走，右上角里程累加，到站「咔嚓」拍照、照片弹出，最后照片墙 + 总里程。配原创欢快 BGM（程序合成，无版权问题）和脚步、快门、啵、叮音效，弹照片踩在拍点上。
西湖 5 个机位步行 8.8 km（演示用内置小人，预览 1.5 倍速、无声；成片带 BGM 和音效）。
也有独立仓库 SpaceZephyr/travel-vlog（自带引擎，单独安装即可用）。
## 14 种风格
同一份镜头表，改一个 `style` 字段就换风格。前 6 种直接用高德瓦片、`satellite-world` 用 Esri 卫星（能推到街道级），后 7 种用代码绘制矢量底图（全国到地级市尺度）。
| style | 名字 | 适合 |
|---|---|---|
| `amap` | 高德标准 | 通用、街道级路线 |
| `amap-dark` | 高德暗色 | 夜景、科技感 |
| `amap-gray` | 高德灰 | 数据可视化、新闻图解 |
| `amap-sepia` | 高德复古 | 怀旧、城市故事 |
| `amap-journal` | 高德手账（淡暖色 + 纸纹 + 手写字） | 旅行 vlog、citywalk |
| `satellite` | 卫星（地球也是真实卫星图） | 片头俯冲、户外、登山 |
| `satellite-world` | Esri 全球卫星 | **境外地点**（高德卫星境外推近无影像） |
| `dark` | 暗色科技 | 业务分布、数据大屏 |
| `light` | 极简白 | 区域介绍、信息图 |
| `journal` | 水彩手账 | 旅行复盘 |
| `vintage` | 复古纸 | 历史、怀旧 |
| `neon` | 赛博霓虹 | 潮流、音乐、夜生活 |
| `ink` | 国风水墨 | 文旅、历史路线 |
| `blueprint` | 工程蓝图 | 规划、工程、科普 |
## 14 种镜头
| type | 效果 |
|---|---|
| `globe` | 地球自转 → 俯冲到一个地点 |
| `locate` | 地球俯冲 → 瞄准镜锁定 → 坐标卡（vlog 片头） |
| `pins` | 一串地点依次落针、带涟漪 |
| `route` | 高德驾车/步行/骑行路线或自己的 GPX 描线；车/人沿线走、镜头跟随、里程表、海拔剖面、