Google Maps Platform Code Assist 工具包(实验性)

Google Maps Platform Code Assist 工具包是一个 Model Context Protocol (MCP) 服务器,可增强用于通过 Google Maps Platform 开发应用的大语言模型 (LLM) 的回答。它会根据官方最新文档和代码示例来提供回答。

由于 MCP 服务器会在模型收到提示时访问内容,因此 LLM 关于 Google Maps Platform 的上下文不必局限于模型训练日期时的可用数据。

MCP 服务器可以访问的 Google Maps Platform 资源包括:

  • Google Maps Platform 文档
  • Google Maps Platform 服务条款
  • Google Maps Platform 信任中心
  • Google Maps Platform 官方 GitHub 组织中的代码库

工具

Maps Code Assist 提供的工具可让 LLM 访问以下功能:

  • retrieve-instructions:客户端使用的辅助工具,用于获取有关如何最好地推断用户意图并对 retrieve-google-maps-platform-docs 工具进行有效调用的关键系统指令。
  • retrieve-google-maps-platform-docs:主要工具。它接受自然语言查询,并将其提交到托管的检索增强生成 (RAG) 引擎。RAG 引擎会搜索最新版本的 Google Maps Platform 官方文档、教程和代码示例,并将相关上下文返回给 LLM,以便其生成准确的回答。

结算

在实验阶段,使用 Maps Code Assist 无需付费。

政策和服务条款

Maps Code Assist 须遵守《Google Maps Platform 服务条款》,包括此服务的服务专用条款。本部分介绍了 Maps Code Assist 的附加服务使用要求,包括兼容的大语言模型和标明出处要求。

兼容 LLM 的要求

您只能将 Maps Code Assist 与符合《Google Maps Platform 服务条款》的大语言模型搭配使用。

例如,您有责任确保您选择使用的 LLM 不会缓存、存储或使用 Google 地图内容来改进自身。在使用 Maps Code Assist 之前,您需要查看您打算与 Maps Code Assist 搭配使用的任何模型的服务条款。您不得将 Maps Code Assist 与任何使用输入到模型中的数据进行模型训练或改进的模型搭配使用。您有责任确保您对模型的使用完全符合《Google Maps Platform 服务条款》(包括服务专用条款)中对 Google 地图内容的限制。

Google 地图来源的标明出处要求

在展示使用 Maps Code Assist 提供的工具生成的结果时,您必须注明相关的 Google 地图来源。

将 LLM 配置为访问 Maps Code Assist MCP 服务器

您可以按照相应的 MCP 配置文档,将 LLM 配置为访问 MCP 服务器,并使用 Code Assist MCP 服务器端点:https://mapscodeassist.googleapis.com/mcp。

Maps Code Assist MCP 服务器使用 Streamable HTTP 传输。 如需了解详情,请参阅在 AI 应用中配置 MCP。

应用场景示例

配置完成后,您就可以向 LLM 询问有关 Google Maps Platform 的问题。 下面是一些示例提示:

  • “如何向 Android 应用添加地图?”
  • “在 iOS 中,在地图上获取用户当前位置的最佳方式是什么?”
  • “提供一个在 Maps JavaScript API 中使用路线服务的示例。”

与开发者知识 MCP 服务器配对

开发者知识 MCP 服务器是一个远程 MCP 服务器,可搜索 Google 开发者网站(包括 Google Maps Platform、Firebase、Google Cloud 和 Android)上的官方文档,以便 AI 助理能够根据最新文档提供答案。它提供 search_documents、get_documents 和 answer_query 工具,这些工具是对 Maps Code Assist 工具的补充,而非替代。Maps Code Assist 专为 Google Maps Platform 而打造,因此当您的项目还使用其他 Google 产品时,将两者搭配使用最为有用。

如需将其与 Maps Code Assist 一起添加到 AI 应用中,请按照配置 IDE 或编码智能体中的说明操作,然后选择您的客户端。为了帮助助理决定何时搜索文档,请同时安装 retrieving-developer-knowledge 智能体技能。配置好这两个服务器后,您就可以提出跨产品问题,例如:

  • “查找 Places API(新版)自动补全请求格式和 Cloud Functions for Firebase 文档,然后编写一个可调用函数,使用我的受限 API 密钥代理自动补全请求。”

可用工具

如需查看 Maps Code Assist MCP 服务器的可用 MCP 工具的详细信息及其说明,请参阅 Maps Code Assist MCP 参考文档。

使用 HTTP 请求列出工具

如需验证服务器是否正常运行并查看可用工具列表,您可以直接向 Maps Code Assist 远程 MCP 服务器发送 tools/list HTTP 请求。tools/list 方法不需要进行身份验证。

curl -X POST https://mapscodeassist.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

替换以下内容:

  • TOOLSET_ENDPOINT:服务名称后面的 MCP 端点的其余部分。对于 Maps Code Assist,此值为 mcp。
  • MCP_PROTOCOL_VERSION:MCP 协议版本。例如 2026-07-28。

分享反馈

如需分享有关 Maps Code Assist 的反馈,请使用以下表单: