接地精简版

Google Maps Platform Grounding Lite 是一项支持 Model Context Protocol (MCP) 的服务，可让您轻松地使用 Google 地图中可信的地理空间数据来接地 AI 应用。MCP 服务器提供的工具可让 LLM 访问地点、天气和路线功能。您可以在支持 MCP 服务器的任何工具中启用 Grounding Lite 来试用它。

工具

Grounding Lite 提供了一些工具，可让 LLM 访问以下 Google 地图功能：

  • 搜索地点：请求有关地点的信息，获取 AI 生成的地点数据摘要，以及摘要中包含的每个地点的地点 ID、纬度和经度坐标以及 Google 地图链接。您可以将返回的地点 ID 以及经纬度坐标与其他 Google Maps Platform API 搭配使用，以便在地图上显示地点。
  • 查询天气：请求天气信息，并返回当前天气状况、每小时预报和每日预报。

  • 计算路线：请求获取两个位置之间的驾车或步行路线信息，并返回路线距离和时长信息。

启用 Maps Grounding Lite MCP 服务器后，LLM 即可调用该服务器公开的新工具，以返回上述数据类型的其他基础信息。虽然 LLM 可以将这些额外信息用作上下文，但 LLM 最终生成的回答可能不会包含 MCP 服务器返回的确切信息。您应验证生成的回答是否准确。

试用 Grounding Lite 示例应用（在新标签页中打开）

结算和配额

在 Grounding Lite 处于实验阶段时，可免费使用。不过，以下配额适用于 Grounding Lite 提供的工具：

  • 搜索地点：每个项目每分钟 100 次查询。每个项目每天 1,000 次查询。
  • 查询天气：每个项目每分钟 300 次查询。
  • 计算路线：每个项目每分钟 300 次查询。

政策和服务条款

Grounding Lite 须遵守 Google Maps Platform 服务条款，包括本服务的服务专用条款。本部分介绍了 Grounding Lite 的其他服务使用要求，包括兼容的 LLM 和来源归因要求。

兼容 LLM 的要求

您只能将 Grounding Lite 与符合《Google Maps Platform 服务条款》的 LLM 搭配使用。

例如，您有责任确保您选择使用的 LLM 不会缓存、存储 Google 地图内容，也不会使用 Google 地图内容来改进自身。在使用 Grounding Lite 之前，您需要查看您打算与 Grounding Lite 搭配使用的任何模型的服务条款。您不得将 Grounding Lite 与任何使用输入到模型中的数据进行任何模型训练或改进的模型搭配使用。您有责任确保您对该模型的使用完全符合 Google Maps Platform 服务条款（包括特定于服务的条款）中有关 Google 地图内容的限制。

Google 地图来源的提供方说明要求

Grounding Lite 的每项工具响应都包含来源。在展示使用 Grounding Lite 提供的工具生成的结果时，您必须以符合以下要求的方式添加关联的 Google 地图来源：

  • Google 地图来源必须紧跟在来源支持的生成内容之后。此类生成的内容也称为接地输出。
  • Google 地图来源必须在一次用户互动中可见。

“搜索地点”工具的信息来源

search_places 工具的 places 字段提供了支持 summary 的来源。对于 places，系统会返回以下元数据：

  • place（资源名称）
  • id
  • location
  • googleMapsLinks

对于每个地点，您都必须生成符合以下要求的链接预览：

  • 请按照接地精简版文字提供方指南，将每项来源归属至 Google 地图。
  • 使用响应中的 places.googleMapsLinks.placeUrl 链接到来源。

配置 LLM 以使用 MCP 服务器

如要使用 Grounding Lite，您首先需要一个已启用 Maps Grounding Lite API 服务的 Google Cloud 项目，以及 API 密钥或 OAuth 客户端 ID。然后，您可以配置 LLM 以访问 MCP 服务器。Grounding Lite MCP 服务器使用可流式传输的 HTTP 传输。

在您的 Google Cloud 项目中启用 Maps Grounding Lite 服务

如需在项目中启用该 API，请执行以下操作：

  1. 在 Google Cloud 控制台中，选择要用于 Grounding Lite 的项目。
  2. 在 Google Cloud 控制台中为项目启用结算功能。
  3. 在顶部导航栏中，打开 Cloud Shell 终端。

  4. 运行以下命令以启用该服务和 MCP 端点：

    gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID

使用 API 密钥进行身份验证

您可以使用现有的 API 密钥搭配 Maps Grounding Lite，也可以创建新的 API 密钥，前提是您需要在 Google Cloud 项目和密钥中启用 Maps Grounding Lite API 服务。

如需使用 API 密钥进行身份验证，请执行以下操作：

  1. 按照 Google Maps Platform 使用入门中的步骤创建或配置 API 密钥。
  2. 使用 X-Goog-Api-Key 标头将密钥传递给 MCP 服务器。您需要在 LLM 的 MCP 工具配置中将此指定为自定义 HTTP 标头。

使用 OAuth 进行身份验证

您可以使用 OAuth 进行身份验证，方法是创建 OAuth 凭据并将其传递给 MCP 主机或 MCP 服务器应用。

如需使用 OAuth 进行身份验证，请执行以下操作：

  1. 在 Google Cloud 控制台中，选择要用于 Grounding Lite 的项目。
  2. 在 API 和服务菜单中，选择凭据。
  3. 在顶部菜单中，依次选择创建凭据 > OAuth 客户端 ID。
  4. 如果项目未配置同意屏幕，请点击配置同意屏幕，然后按照屏幕上的说明操作。
  5. 在指标部分中，点击创建 OAuth 客户端。
  6. 在创建 OAuth 客户端 ID 界面上，选择应用类型，然后输入客户端 ID 的名称。
  7. 指定与您的申请类型相关的其他详细信息。 例如，如果您要创建 Web 应用，请为浏览器和服务器请求添加授权 URI。
  8. 创建客户端后，请保存客户端 ID 和密钥。
  9. 在配置 MCP 主机或 MCP 服务器应用以访问 Grounding Lite 时，请传递您的 OAuth 客户端 ID 和密钥。

如需了解详情，请参阅使用 OAuth 2.0 访问 Google API。

配置 LLM 以访问 Grounding Lite MCP 服务器

如果您已拥有一个启用了 Maps Grounding Lite API 服务且凭据（例如 API 密钥或 OAuth 客户端 ID 和密钥）有效的 Google Cloud 项目，则可以按照相应的 MCP 配置文档，使用 Grounding Lite MCP 服务器网址 https://mapstools.googleapis.com/mcp 将 LLM 配置为访问 MCP 服务器。

如需了解详情，请参阅在 AI 应用中配置 MCP。

使用 Gemini CLI 配置 Grounding Lite

本部分提供了一个示例，说明如何使用 Gemini CLI 配置 Grounding Lite MCP 服务器。如需了解详情，请参阅将 MCP 服务器与 Gemini CLI 搭配使用。

  1. 安装 Gemini CLI 后，您可以使用 add 命令配置 Maps Grounding Lite MCP 服务器：

    gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp

    如果配置成功，您应该会看到一条确认消息，表明服务器已添加到您的用户设置中。

  2. 如需验证服务器是否正常运行，请运行 /mcp list 命令：

    > /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (3 tools)
Tools:
-   compute_routes
-   lookup_weather
-   search_places

  3. 开始使用 CLI 提出与 Google 地图相关的问题。例如，您可以尝试说“帮我推荐一些山景城的餐厅”，这应该会代表您调用 search_places 工具。

分享反馈

如需分享有关 Grounding Lite 的反馈，请使用以下表单：