Google Maps Platform 代理技能 (GitHub) 是可移植、独立的 Google Maps Platform 特有知识、说明和工作流模块。它们旨在帮助 AI 助理了解 Google Maps Platform 最佳实践，并以更高的准确性和更低的 token 成本执行复杂任务。
可用的技能
Google Maps Platform 为核心产品提供了一系列技能。我们即将推出适用于更多产品和功能的技能！
| Skill | 说明 |
|---|---|
google-maps-platform |
一系列技能，可用于使用 Google Maps Platform API 和 SDK 在 Web、Android、iOS 和 Web 服务 API 中设计和实现可用于生产用途的代码，以实现以下任一功能：地图、地点、地址、地理编码、路线/预计到达时间（包括环保路线）、附近搜索、3D/街景/静态地图、标记聚类、自定义样式、绘制、地理围栏、热图或环境（空气质量/花粉/Solar/天气）。 |
开始使用
Google Maps Platform 代理技能可与支持技能的任何 AI 助理搭配使用，包括 Gemini、Cursor、Windsurf、Copilot 和 Claude。
安装 Google Maps Platform 代理技能
在大多数情况下，您只需使用一个命令即可安装 Google Maps Platform 代理技能：
Skills CLI
对于大多数热门的 AI 辅助工具，您可以使用 skills CLI 安装 Google Maps Platform 代理技能。在项目的根目录中运行以下命令：
npx skills add googlemaps/agent-skills
此方法已在以下环境中作为终端命令或自然语言提示对智能体进行了测试：
- AI Studio
- Antigravity
- Claude Code
- Replit（替代说明：使用项目编辑器界面）
Gemini CLI
此代码库配置为 Gemini CLI 扩展程序。您可以使用 Gemini CLI 添加该扩展程序：
gemini extensions install https://github.com/googlemaps/agent-skills
Lovable
在 Lovable 中使用“技能”设置界面安装 Google Maps Platform 代理技能：
- 访问
https://lovable.dev/settings/skills - 在“工作区技能”下，依次点击添加 > 从 GitHub 导入。
- 粘贴
google-maps-platform主要技能的网址：
https://github.com/googlemaps/agent-skills/tree/main/skills/google-maps-platform
更新 Google Maps Platform 代理技能
您可以通过运行 update 命令来获取所有可用的更新并清理过时的技能：
Skills CLI
npx skills update
Gemini CLI
gemini extensions update
使用 Google Maps Platform 代理技能
AI 助理旨在只要它们检测到技能的说明与您当前的请求相符，就会自动使用技能。不过，技能也可以手动调用。您通常可以在代理对话中输入 /，然后搜索技能名称来完成此操作。
技能的核心组件
每个代理技能都是一个专用软件包，可为 AI 助理提供以下组成部分：
- 专业说明：有关完成特定任务（例如实现地点自动补全或生成带有高级标记的地图）的详细指导信息。
- 最佳实践：内置的安全性和性能模式，可确保您的应用从一开始就遵循 Google Maps Platform 建议，包括费用优化。
- 自动化脚本：可执行代码，可让 AI 代理自动执行本地环境设置或配置。
- 真实世界中的鲁棒性：直接从经过验证的开源代码库实现中提取的错误和异常处理模式。
使用技能的好处
使用代理技能可减少搜索文档所需的人工工作量，同时提高 AI 互动的效率。
降低了 token 费用
传统 AI 集成通常会预先加载大量文档，这会消耗大量 token 并增加会话费用。代理技能使用渐进式披露来最大限度地减少此开销：
- 代理最初只会“扫描”简短的元数据，以了解技能是否相关。
- 只有当代理确定您的特定任务需要详细说明和资源时，才会加载这些内容。
AI 引导的实现
您可以用自然语言描述您的意图，而无需手动搜索文档。技能可引导 AI 助理执行以下任务：
- 向我的 Web 应用添加带标记的地图。
- 为地址输入实现地点自动补全功能。
- 帮我生成静态地图图片。 如需查看 Google Maps Platform 代理技能的完整列表，请参阅可用的技能。
将技能与 Code Assist MCP 服务器搭配使用
代理技能旨在为 Code Assist MCP 服务器提供补充功能：
Google Maps Platform 代理技能：提供快速说明和推荐实践，通过节省 token 的逐步披露方式告知代理如何执行 Google Maps Platform 任务。它们会指导代理如何有效地使用 MCP 服务器工具。
Code Assist MCP 服务器：专为 AI 辅助开发工作流而设计，使 AI 助理能够以编程方式与您的 Google Maps Platform 项目、资源和数据进行交互。