[][npm-pkg]

适用于 AI 的 Google Maps Platform 资源

说明

[!WARNING] Google Maps Platform Code Assist 的 npm 版本已弃用。该版本将于 2026 年 7 月 1 日起不再可用。请使用本 README 中记录的、安全托管的远程 MCP 版本作为主要连接方式。

此代码库包含 Google Maps Platform Code Assist 工具包，这是一个模型上下文协议（MCP）服务器，通过将用于 Google Maps Platform 应用开发的大语言模型（LLM）响应基于官方、最新的文档和代码示例进行 grounding，从而增强其响应效果。

Related MCP server: google-maps-mcp-server

🔧 可用的 MCP 工具 (gmp-code-assist)

您可以访问 gmp-code-assist MCP 服务器，其中包含以下基本工具：

• retrieve-google-maps-platform-docs：通过 RAG 搜索 Google Maps Platform 文档、代码示例、架构中心以及 GitHub 代码库。

  • 参数：llmQuery（必填的字符串查询），filter（可选的 API/产品领域筛选器），source（可选的字符串调用方标识符，最多 64 个字符）。

• retrieve-instructions：检索有关 Google Maps Platform 最佳实践的基础上下文。

  • 参数：name（必填字符串，预期格式仅为“instructions”）。

为 Gemini CLI 安装 Google Maps Platform Code Assist 扩展

1. 安装 Gemini CLI（其他安装方法）

npm install -g @google/gemini-cli

2. 安装 Google Maps Platform 扩展

   • 选项 1 - 将 Code Assist 作为 Gemini CLI 扩展安装（包括上下文提示、Code Assist MCP 工具和 Google Maps Platform CLI 主题）：

     gemini extensions install https://github.com/googlemaps/platform-ai.git

     • 通过运行 gemini mcp list 验证安装。

   • 选项 2 - 手动将 MCP 服务器配置添加到您的 ~/.gemini/settings.json 文件中，以安全地连接到 Google 托管的远程服务：

     {
       "mcpServers": {
        "gmp-code-assist": {
          "httpUrl": "https://mapscodeassist.googleapis.com/mcp"
        }
       }
     }

Google Maps Platform Agent 技能

要为您的 AI 代理配备专业、可移植的 Google Maps Platform 工作流和最佳实践，请查看官方的 Google Maps Platform Agent 技能代码库。

在 Gemini CLI 中安装代理技能：

gemini skills install https://github.com/googlemaps/agent-skills.git

为其他 MCP 客户端安装 Google Maps Platform Code Assist 工具包

有关在任何 MCP 客户端中安装和使用该工具包的信息以及使用条款，请参阅 Code Assist 工具包 README。

示例提示

使用以下示例提示开始使用 Code Assist MCP 服务器或受支持的 AI 代理：

• 向我展示如何在 React + Typescript 中使用 Routes API 并将其显示在地图上。

• 我正在将地图从 2D 升级到 3D 逼真效果 - 我有哪些选择？如何在我现有的代码库中实现？

• 将我的 Places API（新版）文本搜索 API 实现更改为使用 Places UI Kit。估算此更改将为每位用户节省多少成本。

• 解释地址验证和地理编码之间的区别。对于我当前的电子商务结账用例，我应该应用哪一个？为什么？

• 我需要一个 API 密钥 - 你能帮我获取一个并将其添加到我的应用环境密钥中吗？