之前有一个很火的开源项目叫 mapcn,可惜无法再国内只用,因为在地图底图上不符合国内合规要求。
最近发现一个基于高德地图封装的 AI 友好的地图 amapcn,让中国地图开发合规且更简单。免费开源、开箱即用、可自定义的 React 地图组件。
零配置,一条命令即可开始。基于 高德地图(AMap),使用 Tailwind 样式体系,与 shadcn/ui 无缝协作。
🧩 配合 shadcn/ui 使用
使用 shadcn/ui CLI 将 amapcn 组件添加到你的项目中:
npx shadcn@latest add https://map.ling.pub/r/amap.json
import { Map, MapMarker } from "@/components/ui/map";
📦 使用 npm
直接安装 npm 包:
npm install amapcn
import { Map, MapMarker } from "amapcn";
🤖 配合 Claude Code 使用
将 amapcn skill 添加到 Claude Code,实现 AI 地图开发:
claude skill add https://github.com/hustcc/ai-map/tree/main/amapcn-skill
✨ 特性
-
🎨 主题感知 —— 自动适配明暗主题
-
🎯 零配置 —— 默认即可工作
-
📦 兼容 shadcn/ui —— 采用一致的组件与样式模式
-
🗺️ 基于高德地图 —— 完整接入高德地图能力
-
🧩 可组合 —— 用声明式组件构建复杂地图界面
-
📍 标记与弹窗 —— 丰富的 Marker、Popup、Tooltip 与 Label 支持
-
🛤️ 路线能力 —— 轻松绘制路线与轨迹
-
🎮 地图控件 —— 支持缩放、指北针、定位与全屏控件
📄 许可证
MIT License,商业产品随意使用。