claudeers.
// Claude Skills

map-motion

地图动效视频 Claude Code skill:基于高德地图真实路线/边界/卫星底图,做地球俯冲、vlog 我在这里、徒步海拔、骑行旅程、航线、行政区高亮等地图动画,12 种风格

// Claude Skills[ api ][ web ][ claude ]#claude#amap#claude-code#claude-skills#map-animation#travel-video#skills◷ NOASSERTION$open-sourceupdated about 1 month ago
Actively maintained
92/100
last commit about 1 month ago
last release none
releases 0
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up map-motion (claude-skill project) into my current project.
Found on https://claudeers.com/map-motion
Repo: https://github.com/SpaceZephyr/map-motion
Homepage/docs: —
Detected install method: claude-skill → # copy this skill into .claude/skills/map-motion/
Category: skills. Platforms: api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/map-motion/   (or ~/.claude/skills/map-motion/ for all projects)
// or clone
git clone https://github.com/SpaceZephyr/map-motion

// compatibility

Platformsapi, web
Operating systems—
AI compatibilityclaude
LicenseNOASSERTION
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

map-motion · 地图动效视频 Skill

给 Claude Code 用的地图动画 skill:用一句话描述(或一份 JSON 镜头表),出一段基于真实高德地图数据的地图动效视频——竖屏/横屏 MP4,外加 GIF。

路线是高德真实的驾车/步行/骑行路线,边界是真实的行政区和公园轮廓,海拔是 SRTM 卫星高程,底图可以直接用高德标准地图或卫星图。

Vlog 我在这里:大理双廊 徒步梧桐山 + 海拔剖面 卫星定位桂林公园 手账风自驾旅程

能做哪些视频

1. Vlog 片头「我在这里」

卫星地球俯冲 → 瞄准镜收缩锁定(LOCKED)→ 坐标卡:地名逐字打出、经纬度滚动到位、海拔、拍摄时间。10 秒,直接接你的 vlog 正片。

大理双廊 上海外滩夜

assets/examples/vlog_locate.json · vlog_locate_night.json

2. 徒步登山:路线 + 海拔剖面

镜头跟着人沿高德步行路线上山,底部的海拔曲线同步画出,实时显示海拔和累计爬升,山顶插旗。

梧桐山:泰山涧 → 大梧桐,爬升 835 m

深圳梧桐山,泰山涧 → 大梧桐:3.6 km,海拔 98 → 916 m,累计爬升 835 m。hike_elevation.json

3. 长途骑行 / 自驾:多站旅程

一次写完整趟行程:逐段路线、累计里程表、「DAY n · 日期 · km」、到站邮戳、照片拍立得、原路返程。

青海湖环湖骑行 365 km 深圳 → 香格里拉自驾往返

青海湖环湖骑行(高德骑行路线 365 km,海拔 3,200 m 上下)· 国庆自驾深圳 → 香格里拉往返 4,213 km。cycling_trip.json · road_trip.json

4. 介绍一个地方:公园、景区、校园

从地球或行政区推进到一个地块,描出轮廓、填色,再从地铁站步行过去、绕园一周。

卫星定位上海桂林公园 桂林路地铁站步行到桂林公园、绕园一周

上海徐汇区桂林公园。park_locate.json · park_walk.json

5. 航线、行政区、业务分布

城市间飞线(大圆航线,飞机沿弧飞)、行政区依次描边高亮、一个中心向多城辐射。

飞线 + 京津冀高亮 + 辐射 杭州辐射全国 12 城

showcase.json · flight.json · region.json · radiate.json

6. 找机位:照片从地图上「咔嚓」翻出来(子 skill photo-spot)

给一张照片:卫星地球俯冲 → 相机图标落在拍照机位、被摄地落针 → 取景扇形扫过去 → 取景框对焦 → 快门声+闪白 → 照片从机位处 3D 翻折立起,背景是照片自身的虚化;可加 iPhone Live Photo 播放效果(用真 MOV,或静态照片模拟)。照片带 GPS 时自动读出机位、朝向、焦距和参数。

富士山 × 新干线:机位揭秘 雨崩神瀑:Live Photo 效果 香港钓鱼翁俯瞰布袋澳

富士山 × 新干线(境外,Esri 卫星)· 雨崩神瀑 → 卡瓦格博(Live Photo 模拟)· 香港钓鱼翁 → 布袋澳。photo-spot/(安装见下)· 示例 spec 在 photo-spot/examples/

13 种风格

同一份镜头表,改一个 style 字段就换风格。前 5 种直接用高德瓦片、satellite-world 用 Esri 卫星(能推到街道级),后 7 种用代码绘制矢量底图(全国到地级市尺度)。

12 种风格:辐射飞线 12 种风格:地球

style名字适合
amap高德标准通用、街道级路线
amap-dark高德暗色夜景、科技感
amap-gray高德灰数据可视化、新闻图解
amap-sepia高德复古怀旧、城市故事
satellite卫星(地球也是真实卫星图)片头俯冲、户外、登山
satellite-worldEsri 全球卫星境外地点(高德卫星境外推近无影像)
dark暗色科技业务分布、数据大屏
light极简白区域介绍、信息图
journal水彩手账旅行复盘
vintage复古纸历史、怀旧
neon赛博霓虹潮流、音乐、夜生活
ink国风水墨文旅、历史路线
blueprint工程蓝图规划、工程、科普

13 种镜头

type效果
globe地球自转 → 俯冲到一个地点
locate地球俯冲 → 瞄准镜锁定 → 坐标卡(vlog 片头)
pins一串地点依次落针、带涟漪
route高德驾车/步行/骑行路线或自己的 GPX 描线;车/人沿线走、镜头跟随、里程表、海拔剖面、终点插旗
flight大圆航线,飞机沿拱起的弧线飞
region行政区(省/市/区县)描边 → 填色 → 写名
area公园/景区/校园等地块轮廓(OpenStreetMap),可绕行一圈
radiate一个中心向多点放射飞线
trip多站旅程:逐段路线、累计里程、邮戳、照片、返程
overview拉回全景,框住所有出现过的地点
title标题卡
snap机位揭秘:相机图标+取景扇形 → 对焦 → 咔嚓 → 照片 3D 翻折立起,可选 Live Photo(photo-spot 用的就是它)
guess「这张照片在哪拍的?」:整屏照片+提示+倒数,再接 locate 揭晓

镜头之间自动「飞过去」:远距离先拉远再推近,和 Mapbox flyTo 同一套公式,不用手写转场。完整参数见 references/spec.md。

快速开始

1. 安装

git clone https://github.com/SpaceZephyr/map-motion ~/.claude/skills/map-motion
uv run --with playwright playwright install chromium     # 首次:无头浏览器

依赖:uv、ffmpeg。

要用「找机位」子 skill,再链接一下(它复用 map-motion 的渲染引擎):

ln -s ~/.claude/skills/map-motion/photo-spot ~/.claude/skills/photo-spot

2. 配高德 key(高德开放平台 → 应用管理 → 添加「Web服务」类型 key,免费)

mkdir -p ~/.config/map-motion && echo '你的key' > ~/.config/map-motion/amap_key && chmod 600 ~/.config/map-motion/amap_key

3. 用

在 Claude Code 里直接说:

帮我做一个 vlog 片头,我在大理双廊,10 月 3 号早上 7 点 42

把我这次爬梧桐山的路线做成带海拔的动画

做一个从杭州辐射到全国 12 个城市的地图动画,暗色风格

或者自己写镜头表:

{"size": "portrait", "style": "satellite",
 "shots": [
  {"type": "locate", "to": "双廊古镇", "zoom": 15.6, "name": "大理 · 双廊", "sub": "洱海东岸 · DAY 3", "date": "2026.10.03  07:42"}
 ]}
~/.claude/skills/map-motion/scripts/make.sh 片头.json 片头.mp4 --gif 片头.gif
~/.claude/skills/map-motion/scripts/make.sh 片头.json 静帧/ --stills 2,6,9      # 先抽几帧看构图

编译时会打印每个地点被高德解析成了什么,请逐行核对——同名地点会解析错(实测过「香格里拉」→ 某家酒店、「青海湖」→ 乌鲁木齐一个同名小区)。

怎么做出来的

镜头表 spec.json
   │  compile.py  ── 高德:地名→坐标、驾车/步行/骑行路线、行政区边界
   │              ── OpenStreetMap:公园/景区轮廓    OpenTopoData:SRTM 海拔
   │              ── 算每个镜头的取景、镜头之间的飞行、图层出现/消失时间
   ▼
timeline.json
   │  render.py   ── 本地服务(运行时 + 高德瓦片代理缓存)→ 无头 Chromium 逐帧画 → ffmpeg
   ▼
成片.mp4 / .gif
  • 地球:正射投影逐像素反投影取纹理(卫星样式的纹理就是高德卫星瓦片拼出来的),缩放到 3–3.6 级时和平面地图交叉淡化,所以能从太空一路推到街道。
  • 平面:Web 墨卡托,512px 高清瓦片;矢量底图用多边形裁剪防止推近时破面。
  • 坐标:全程 GCJ-02(高德坐标),GPS/照片/GPX/OSM 的 WGS-84 坐标自动转换;查海拔时再转回 WGS-84。
  • 确定性:同一份时间轴两次渲染逐帧一致;瓦片、API、海拔全部本地缓存,改了重渲不再消耗配额。

参考了哪些 skill 和方法

Skill

  • huashu-art-motion(花叔):借鉴了它的工作方法——风格先在同一帧上出多个方向让人挑、所有渲染确定性可复现、交付前抽静帧逐帧检查、派独立 agent 只看成片审片、把踩过的坑写回 skill(本 skill 的 SKILL.md 末尾也保留了「踩过的坑」)。
  • Anthropic skill-creator:skill 的组织方式——SKILL.md 只放流程和选择指南,参数细节放 references/,可执行部分放 scripts/,按需加载。

产品与灵感

  • Mult.dev、TravelAnimator:旅行地图视频的常见镜头(航线、自驾、照片插入)。
  • Google Earth Studio:从地球俯冲到地点的片头语言。
  • Mapbox flyTo:镜头飞行的手感。

算法

  • van Wijk & Nuij, Smooth and efficient zooming and panning(2003):镜头先拉远再推近的最优路径。
  • 正射投影与逐像素反投影;大圆插值(球面线性插值)画航线。
  • Douglas–Peucker 折线抽稀;Sutherland–Hodgman 多边形裁剪。
  • WGS-84 ↔ GCJ-02 坐标转换。

数据

使用边界

  • 高德瓦片:渲染时直接取高德瓦片,属于非官方用法。个人视频、学习交流可用,成片右下角保留「© 高德地图」署名;商业投放需要高德的商业授权,或改用 7 种矢量风格。satellite-world 的 Esri 影像同理:个人非商业可用并保留署名,商用需 Esri 授权。
  • 地图合规:中国边界按内置数据绘制(含台湾、南海诸岛与九段线),请勿删改;对外商用的地图内容在国内受《地图管理条例》约束。
  • 海拔:SRTM 是约 30 米网格的平均高程,山顶会比实际略低(梧桐山顶实测 944 m,SRTM 916 m)。
  • 公园轮廓:来自 OSM 志愿者绘制,精度不一,有的只有几个点。
  • 示例里的日期(青海湖骑行、vlog 拍摄时间)是示意,路线、里程、海拔是真实数据。

License

代码 MIT。字体(思源黑体、霞鹜文楷、Anton)为 SIL OFL 1.1,见 assets/fonts/。地图数据遵循各自来源的条款(见上)。

// faq

What is map-motion?

地图动效视频 Claude Code skill:基于高德地图真实路线/边界/卫星底图,做地球俯冲、vlog 我在这里、徒步海拔、骑行旅程、航线、行政区高亮等地图动画,12 种风格. It is open-source on GitHub.

Is map-motion free to use?

map-motion is open-source under the NOASSERTION license, so it is free to use.

What category does map-motion belong to?

map-motion is listed under skills in the Claudeers registry of Claude-compatible tools.

60 views
★ 114 stars
unclaimed
updated about 1 month ago

// embed badge

map-motion on Claudeers
[![Claudeers](https://claudeers.com/api/badge/map-motion.svg)](https://claudeers.com/map-motion)

// retro hit counter

map-motion hit counter
[![Hits](https://claudeers.com/api/counter/map-motion.svg)](https://claudeers.com/map-motion)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how map-motion connects across the ecosystem