Google Maps Platform 代理技能 (GitHub) 是可移植、独立的 Google Maps Platform 特有知识、说明和工作流模块。它们旨在帮助 AI 助理了解 Google Maps Platform 最佳实践,并以更高的准确性和更低的 token 成本执行复杂任务。
可用的技能
Google Maps Platform 为核心产品提供了一系列技能。我们即将推出适用于更多产品和功能的技能!
| 技能 | 说明 |
|---|---|
google-maps-platform |
一系列技能,涵盖使用 Google Maps Platform API 和 SDK 在 Web、Android、iOS 和 Web 服务 API 中构建和实现可用于生产用途的代码,适用于以下任一领域:地图、地点、地址、地理编码、路线/预计到达时间(包括环保路线)、附近搜索、3D/街景/静态地图、标记聚类器、自定义样式、绘图、地理围栏、热图或环境(空气质量/花粉/Solar/天气)。所有非简单代码均基于通过 Google Maps Platform Code Assist 服务新检索到的文档(不依赖于训练数据记忆)。 |
开始使用
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 - 在“Workspace 技能”下,依次点击添加 > 从 GitHub 导入。
- 粘贴
google-maps-platform主要技能的网址:
https://github.com/googlemaps/agent-skills/tree/main/skills/google-maps-platform
使用 Google Maps Platform 代理技能
自动触发或手动调用代理技能
AI 助理旨在只要它们检测到技能的说明与您当前的请求相符,就会自动使用技能。不过,也可以手动调用 skill。您通常可以在代理对话中输入 /,然后搜索技能名称来完成此操作。
例如,安装完成后,您可以在代理对话中输入以下内容,请求在您正在构建的应用中添加新功能:
/google-maps-platform Add a 3D map featuring a marker for the user's location
将技能与 Code Assist MCP 服务器搭配使用
代理技能旨在为 Code Assist MCP 服务器提供补充功能:
Google Maps Platform 代理技能:提供快速说明和推荐实践,通过节省 token 的逐步披露方式告知代理如何执行 Google Maps Platform 任务。它们会指导代理如何有效地使用 MCP 服务器工具。
Code Assist MCP 服务器:专为 AI 辅助开发工作流而设计,使 AI 助理能够以编程方式与您的 Google Maps Platform 项目、资源和数据进行交互。
添加“开发者知识”智能体技能
如需让 AI 助理同时搜索更广泛的 Google 官方开发者文档库(包括 developers.google.com 上的 Google Maps Platform 文档),请在安装 Google Maps Platform 智能体技能的同时,安装 retrieving-developer-knowledge 智能体技能。此技能会教您的助理如何查询开发者知识 MCP 服务器,以便跨 Google Maps Platform 和其他 Google 产品(例如 Firebase 或 Google Cloud)的回答可以利用官方文档,而不仅仅依赖于其训练数据。例如:
Using the official docs, compare Grounding with Google Maps in the Gemini API
with Maps Grounding Lite, then add the better fit to my Node.js agent
更新 Google Maps Platform 代理技能
您可以通过运行 update 命令来获取所有可用的更新并清理过时的技能:
Skills CLI
npx skills update google-maps-platform
Gemini CLI
gemini extensions update
技能的核心组件
每个代理技能都是一个专用软件包,可为 AI 助理提供以下组成部分:
- 专业说明:有关完成特定任务(例如实现地点自动补全或生成带有高级标记的地图)的详细指导信息。
- 最佳实践:内置的安全性和性能模式,可确保您的应用从一开始就遵循 Google Maps Platform 建议,包括费用优化。
- 自动化脚本:可执行代码,可让 AI 智能体自动执行本地环境设置或配置。
- 实际稳健性:直接从经过验证的开源代码库实现中提炼出的错误和异常处理模式。
使用技能的好处
使用代理技能可减少搜索文档所需的人工工作量,同时提高 AI 互动的效率。
降低了 token 费用
传统 AI 集成通常会预先加载大量文档,这会消耗大量 token 并增加会话费用。代理技能使用渐进式披露来最大限度地减少此开销:
- 智能体最初只会“扫描”简短的元数据,以了解技能是否相关。
- 只有当代理确定您的特定任务需要详细说明和资源时,才会加载这些内容。
AI 引导的实现
您可以用自然语言描述您的意图,而无需手动搜索文档。技能可引导 AI 助理执行以下任务:
- 在我的 Web 应用中添加带标记的地图。
- 实现地点自动补全功能,以便输入地址。
- 帮我生成静态地图图片。
如需查看 Google Maps Platform 代理技能的完整列表,请参阅可用的技能。