升级到 Pro SKU，即可使用更多 Maps Experience 代理工具功能！与销售人员联系以获取访问权限。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

地图体验智能体工具

Maps Experience 智能体工具（以前称为 Maps Grounding Lite）是一项 Google Maps Platform 服务，支持 Model Context Protocol (MCP)，可使用来自 Google 地图的可信地理空间数据为 AI 应用提供接地。MCP 服务器提供工具，让 LLM 能够访问地点、天气和路线数据。其他工具会将地点名称和 Google 地图网址解析为地点 ID。您可以在任何支持 MCP 服务器的工具中启用地图体验智能体工具，从而试用这些工具。

Maps Experience 智能体工具是一款产品，包含两个 SKU：Essentials 和 Pro。除非使用 Pro 选项，否则每个请求都会按 Essentials 计费。专业版选项增加了扩展的地点详情、每次搜索可返回更多地点、每条路线可包含更多中间经停点，以及可根据实时路况规划路线。在受限正式版期间，Pro 选项仅适用于 Pro 许可清单中的项目。这两个 SKU 使用相同的 MCP 服务器、工具和凭证。如需了解详情，请参阅基本功能版和专业版。

工具

借助地图体验智能体工具，LLM 可以访问以下 Google 地图功能：

搜索地点：请求获取地点信息，并获取 AI 生成的摘要。响应还包括摘要中每个地点的地点 ID、坐标和 Google 地图链接。您可以将地点 ID 和坐标与其他 Google Maps Platform API 搭配使用，以便在地图上显示地点。借助 Pro，您可以请求扩展的地点详情（例如评价中的数据分析），每次请求最多可获取 10 个地点。
查询天气：请求获取天气信息，并返回当前天气状况、逐小时预报和每日预报。
计算路线：请求起点和终点之间的路线（可选择经过中间停靠点），并返回路线的距离和时长。借助 Pro，路线可以考虑实时路况信息，并包含更多中间经停点。

注意： Maps Experience 代理工具不提供精细导航或导航信息。在不使用 Pro 选项的情况下计算的路线不会考虑实时路况。
解析名称和解析 Google 地图网址：将地点名称、地址和 Google 地图网址解析为地点 ID。如需了解详情，请参阅 Resolution API。

启用 MCP 服务器后，LLM 可以调用其工具来获取这些数据类型的接地信息。LLM 可以使用这些信息作为上下文。不过，其最终回答可能不包含 MCP 服务器返回的确切信息。您应验证生成的回答是否准确。

Essentials 和 Pro

Essentials 和 Pro 是同一产品的两个 SKU，而不是单独的产品或方案。如果请求使用 Pro 选项，则会按 Pro 计费。其他所有请求均按 Essentials 计费。Pro 选项是工具请求中的普通字段，因此 LLM 可以代表您使用这些选项。代理还可以在同一对话中使用这两个 SKU。例如，智能体可能会使用 Essentials 查找地标附近的咖啡店。然后，它可能会使用 Pro 来回答有关其招牌饮品和座位的后续问题。Pro 版没有单独的 MCP 服务器、端点或凭证。

比较基本功能版、专业版和 Grounding with Google Maps

Grounding with Google Maps 是一款单独的产品。它已内置于 Gemini API、Google AI Studio 和 Gemini Enterprise Agent Platform 中的 Gemini 模型中。模型会决定何时查询 Google 地图，并返回带有引用的接地回答。如果您在 Gemini 上构建应用，并希望模型处理 Grounding with Google Maps，请选择 Grounding with Google Maps。如果您使用的是其他模型或代理框架，或者希望直接控制每个工具调用，请选择 Maps Experience 代理工具。

	地图体验智能体工具		依托 Google 地图进行接地
	基本功能版 SKU （以前称为“依托 Google 地图接地精简版”）	Pro SKU	依托 Google 地图进行接地
请求的结算方式	每个不使用 Pro 选项的工具请求	每个使用 Pro 选项的工具请求： `include_extended_details`、`page_size` 大于 5、`ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` 或超过 10 个中间航点	每个 Google 地图查询或接地提示，具体取决于平台和模型
模型和平台	支持 MCP 的任何模型或智能体框架。一个 MCP 服务器、一组工具，以及两个 SKU 的相同凭证		Gemini API、Google AI Studio 和 Gemini Enterprise Agent Platform 中的 Gemini 模型
工具返回的内容	核心事实：每次搜索最多可提供 5 个地点的地点详情、不含实时路况的路线距离和时长，以及当前天气和天气预报	包含 Essentials 中的所有功能，以及扩展的地点详情（例如评价中的数据分析）、每次搜索最多 10 个地点、包含实时路况的路线，以及最多 25 个中间航点	地点详情、评价中的数据洞见以及包含实时路况的路线信息
示例请求	事实和物流问题：查找商店或商家、营业时间、地址以及距离或行程时间估算	主观或宽泛的问题：氛围、招牌菜、游客提示、6 到 10 个地点的比较，以及当前路况下的行程时间	Gemini 中的对话式搜索、行程规划和本地探索
Places UI Kit 可视化	包含在智能体数据可视化令牌（预览版）中，无需额外付费		单独计费
每月免费用量	10,000 次请求	5,000 次请求	取决于平台和型号。例如，在 Gemini API 中，Gemini 3 及更新的模型每月包含 5,000 次免费搜索查询。超出后，搜索查询费用为每 1,000 次 14 美元。
随用随付价格	每 1,000 次请求 7.00 美元，提供批量折扣	每 1,000 个请求 14.00 美元。如需了解批量定价，请与销售人员联系。
订阅即可省钱	包含在基础版和 Pro 版方案中	未包含	不可用
开始使用	两个 SKU 采用相同的设置：请参阅配置 LLM 以使用 MCP 服务器。在受限正式版阶段，Pro 选项还需要项目位于 Pro 许可清单中。		Gemini API 或 Agent Platform

这些选项在两种 SKU 下的工作方式相同：出行方式、出发和到达时间、备选路线、路线多段线、天气查询和 Resolution API。它们不会更改请求的结算 SKU。

Pro SKU 下的结算内容

工具	能力	基本功能版	Pro
搜索地点	每个请求的地点数	最多 5 个	6 到 10（`page_size`，从 6 到 10）
搜索地点	搜索摘要中的扩展地点详情（评价中的数据分析、菜单亮点、氛围、地点繁忙程度、访客提示，以及邻近查询的距离或行程时间）	不可用	`include_extended_details`提供
计算路线	路线偏好设置	不考虑实时路况	考虑实时路况或公交路线的实时公交数据，使用 `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL`
计算路线	每条路线的中间航点数	最多 10 个	11 到 25（超过 10 个`intermediate_waypoints`）
Lookup weather 和 Resolution API	没有 Pro 选项。所有请求均按 Essentials SKU 结算。

如需了解启用各项功能的请求选项，请参阅搜索地点和计算路线。

Pro 方案在受限正式版阶段的选项

在受限正式版期间，Pro 选项仅适用于 Pro 许可清单中的 Google Cloud 项目。请与销售人员联系，申请访问权限。项目列入许可清单后，其中的每个 API 密钥和 OAuth 客户端都可以使用 Pro 选项。

如果您的项目尚未列入许可清单，则使用 Pro 选项的请求将按如下方式处理：

搜索地点：include_extended_details 会被忽略，并且即使您将 page_size 设置为更高的值，回答中最多也只会包含 5 个地点。该请求将按 Essentials SKU 结算。
计算路线：ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL 被视为 ROUTING_PREFERENCE_TRAFFIC_UNAWARE，请求按基本功能版 SKU 计费。如果请求包含超过 10 个中间航点，则会返回 INVALID_ARGUMENT 错误。

如需检查您的项目是否在许可清单中，请发送 search_places 请求，并将 page_size 设置为 10。使用宽泛的查询，例如 restaurants in Chicago。许可清单中的项目可以返回 5 个以上的地点，并按 Pro SKU 计费。其他项目最多返回 5 个地点。

控制 Pro 用量

Pro 选项默认处于关闭状态。当用户的请求需要这些参数，并且工具架构或您的指令允许时，LLM 会设置这些参数。工具架构描述了最多 5 个 page_size 值和最多 10 个中间航点。因此，只有当您的指令要求使用 Pro 模型时，模型才会使用更高的 Pro 限额。如需管理费用，请执行以下操作：

告诉模型何时适合使用 Pro 选项。例如：“仅当用户询问评价、菜单或氛围时，才设置 include_extended_details。”或者：“仅当用户询问当前行程时间时，才使用 ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL。”
如需让代理继续使用 Essentials SKU，请指示模型一律不使用 Pro 选项。Pro 选项包括 include_extended_details、page_size（超过 5 个）、ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL，以及超过 10 个中间航点。如果您的 MCP 客户端可以限制工具参数，您也可以在其工具配置中屏蔽这些值。
在结算报告中监控用量，并设置预算提醒。

Resolution API

Maps Experience 代理工具提供 Resolution API。它可将自由形式的位置文本和网址解析为结构化的 Google 地图地点标识符。Resolution API 可作为 REST 方法和 MCP 服务器上的工具使用：

解析名称（REST、MCP）：将一批地点名称或地址解析为 Google 地图上的特定地点实体。这对于将非结构化用户查询接地到稳定的地点 ID 非常有用。
解析地图网址（REST、MCP）：将一批 Google 地图网址解析为特定地点实体。支持的格式包括标准地点网址和短网址。

您可以将返回的地点 ID 与其他 Google Maps Platform API 搭配使用。每个回答还包含一个链接，用于将解析出的地点保存为 Google 地图中的列表。

如需了解详情，请参阅 Maps Tools Resolution API。

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

结算和配额

结算方式

在 Google Maps Platform 随用随付定价模式下，地图体验代理工具的使用量是按请求计算的。每个请求代表一个结算事件。用量按产品 SKU 进行跟踪。除了总费用之外，您的账单还会显示每个 SKU 的订单项。如需了解详情，请参阅报告概览。

每个“搜索地点”“计算路线”或“查询天气”请求都仅按一个 SKU（Essentials 或 Pro）计费。使用任何 Pro 选项的请求都会按 Pro SKU 结算。系统绝不会同时按这两个 SKU 结算，并且 Pro 选项的数量不会改变费用。以下选项决定了 SKU：

工具	基本功能版	Pro
`search_places`	任何不含 Pro 选项的请求：`page_size` 为 5 或更少，且 `include_extended_details` 未设置或为 `false`	`include_extended_details` 设置为 `true`，或 `page_size` 为 6 到 10
`compute_routes`	任何不含 Pro 选项的请求：`routing_preference` 未设置或 `ROUTING_PREFERENCE_TRAFFIC_UNAWARE`，且中间航点不超过 10 个，采用任何出行方式	`routing_preference` 设置为 `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL`，或 11 到 25 个中间航点
`lookup_weather`	每个请求	—

如需了解基本功能版的价格，请参阅基本功能版 SKU 详情。 Pro 请求在每月前 5,000 个请求之后，按每 1,000 个请求 $14.00 的价格计费。如需了解批量定价，请与销售人员联系。

在受限正式版阶段，Pro 选项仅对 Pro 许可清单中的项目生效。如需了解详情，请参阅受限正式版期间的 Pro 选项。

如需了解价格详情，请参阅主价格表和印度价格表。

解析 API 请求（ResolveNames 和 ResolveMapsUrls）按 Places API 文本搜索基本功能版（仅 ID） SKU 免费结算。

基本功能版 SKU 的用量也包含在基本功能版和专业版订阅即享优惠套餐中。Pro SKU 不包含在“订阅省钱”套餐中。

配额

以下配额适用于 Maps Experience 代理工具提供的工具和 API：

搜索地点：每个项目每分钟 300 次查询。
查询天气：每个项目每分钟 300 次查询。
计算路线：每个项目每分钟 300 次查询。
解析名称：每个项目每分钟 600 次查询。
解析地图网址：每个项目每分钟 600 次查询。

配额按工具计算，并由基本功能版和专业版 SKU 共享。Pro 请求与对同一工具的 Essentials 请求消耗相同的配额。

每个 Resolution API 请求都算作一个查询，无论其中包含多少项。

政策和服务条款

Maps Experience 代理工具须遵守 Google Maps Platform 服务条款，包括服务专用条款。本部分介绍了地图体验智能体工具的其他使用要求，包括兼容的 LLM 和来源归因。这些要求适用于所有结果，无论请求按哪个 SKU 计费。

兼容 LLM 的要求

您只能将地图体验智能体工具与符合《Google Maps Platform 服务条款》的大语言模型搭配使用。

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

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

Maps Experience 代理工具的每个工具回答都包含来源。当您展示 Maps Experience 代理工具的结果时，必须包含关联的 Google 地图来源，并满足以下要求：

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

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

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

place（资源名称）
id
location
googleMapsLinks

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

请按照地图体验代理工具文字提供方指南，将每项来源归属至 Google 地图。
使用响应中的 places.googleMapsLinks.placeUrl 链接到来源。

这些要求也适用于包含 Pro 版扩展地点详情（例如评价中的数据分析）的摘要。summary 使用从零开始的索引（例如 [0]）引用每个地点，该索引会映射到 places 中的条目。每个地点还包含 googleMapsLinks.reviewsUrl，用于链接到 Google 地图上该地点的评价。用户可以点击该链接，查看数据洞见背后的评价。

语音优先界面

如果您的应用通过语音呈现 Maps Experience 智能体工具结果，您还必须满足语音优先界面的要求。总结：

来源：在随播界面中显示 Google 地图来源，该界面会显示语音对话的逐字历史记录。
主动披露：在互动时，告知用户 AI 生成的内容可能包含来自 Google 地图的信息。同时告诉他们，详细来源可在配套界面中找到。您可以在屏幕上或通过语音执行此操作。
持续披露：在语音设置菜单等位置持续显示说明，告知用户 AI 生成的内容可能包含 Google 地图内容。
用户询问：准确回答用户关于内容来源的问题，并引导他们前往配套界面了解详情。

将 LLM 配置为使用 MCP 服务器

如需使用 Maps Experience 代理工具，您需要有一个 Google Cloud 项目，并且该项目已启用 Maps Experience 代理工具 API 服务。您还需要 API 密钥或 OAuth 客户端 ID。然后，您可以配置 LLM 以访问 MCP 服务器。MCP 服务器使用可流式传输的 HTTP 传输。

在 Google Cloud 项目中启用地图体验代理工具

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

在 Google Cloud 控制台中，选择要用于 Maps Experience 代理工具的项目。
在 Google Cloud 控制台中为项目启用结算功能。
在 Google Cloud 控制台 API 库中启用 Maps Experience 代理工具。

使用 API 密钥进行身份验证

您可以将现有 API 密钥与 Maps Experience 代理工具搭配使用，也可以创建新的 API 密钥。无论采用哪种方式，都请在 Google Cloud 项目和密钥上启用 Maps Experience agent tools API 服务。

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

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

使用 OAuth 进行身份验证

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

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

在 Google Cloud 控制台中，选择要用于 Maps Experience 代理工具的项目。
在 API 和服务菜单中，选择凭证。
在顶部菜单中，依次选择创建凭据 > OAuth 客户端 ID。
如果项目没有配置的权限请求页面，请点击配置权限请求页面，然后按照屏幕上的说明操作。
在指标部分中，点击创建 OAuth 客户端。
在创建 OAuth 客户端 ID 界面上，选择应用类型并输入客户端 ID 的名称。
指定与您的应用类型相关的其他详细信息。例如，如果您要创建 Web 应用，请为浏览器和服务器请求添加授权 URI。
创建客户端后，请保存客户端 ID 和密钥。
配置 MCP 主机或 MCP 服务器应用时，请传递您的 OAuth 客户端 ID 和密钥。您还必须请求以下范围：https://www.googleapis.com/auth/maps-platform.mapstools。

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

配置 LLM 以访问 Maps Experience 智能体工具 MCP 服务器

启用 Maps Experience Agent Tools 服务并创建凭证后，您可以配置 LLM 以访问 MCP 服务器。请按照 LLM 的 MCP 配置文档操作，并使用 MCP 服务器网址：https://mapstools.googleapis.com/mcp

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

使用 Gemini CLI 配置地图实验专区智能体工具

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

安装 Gemini CLI 后，运行 gemini mcp add 以配置 MCP 服务器：
```
gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-experience-agent-tools-mcp https://mapstools.googleapis.com/mcp
```
如果配置成功，您应该会看到一条确认消息，表明服务器已添加到您的用户设置中。

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

> /mcp list

Configured MCP servers:

maps-experience-agent-tools-mcp - Ready (5 tools)
Tools:
-   compute_routes
-   lookup_weather
-   resolve_maps_urls
-   resolve_names
-   search_places

开始使用 CLI 问问地图相关问题。例如，您可以尝试输入“Recommend me some restaurants in Mountain View”（向我推荐山景城的一些餐厅），这应该会代表您调用 search_places 工具。

使用智能体开发套件 (ADK) 配置 Maps Experience 智能体工具

本部分介绍了如何使用 Python、Java 或 TypeScript 中的智能体开发套件 (ADK) 配置 MCP 服务器。

Python

您可以在 GitHub 上的 adk-samples 代码库中找到此示例的完整实现。

第 1 步：使用 `McpToolset` 为地图实验专区智能体工具定义智能体

修改 agent.py 文件。将 YOUR_GOOGLE_MAPS_API_KEY 替换为您的实际 API 密钥。

# ./adk_agent_samples/mcp_agent/agent.py
import os
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

# Retrieve the API key from an environment variable or directly insert it.
GOOGLE_MAPS_API_KEY = os.getenv("GOOGLE_MAPS_API_KEY")
if not GOOGLE_MAPS_API_KEY:
    GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY_HERE"

if GOOGLE_MAPS_API_KEY == "YOUR_GOOGLE_MAPS_API_KEY_HERE":
    print("WARNING: GOOGLE_MAPS_API_KEY is not set.")

root_agent = Agent(
    model='gemini-flash-latest',
    name='travel_planner_agent',
    description='A helpful assistant for planning travel routes.',
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mapstools.googleapis.com/mcp",
                headers={
                    "X-Goog-Api-Key": GOOGLE_MAPS_API_KEY,
                    "Content-Type": "application/json",
                    "Accept": "application/json, text/event-stream"
                }
            )
        )
    ]
)

第 2 步：确保 `init.py` 存在

确保 __init__.py 与 agent.py 位于同一目录中：

from . import agent

第 3 步：运行 `adk web` 并进行互动

设置环境变量：
在终端中将 Google 地图 API 密钥设置为环境变量：
```
export GOOGLE_MAPS_API_KEY="YOUR_ACTUAL_GOOGLE_MAPS_API_KEY"
        
```
运行 adk web：
运行以下命令以启动 ADK 网页界面：
```
adk web
        
```
在界面中互动：
- 选择相应的 travel_planner_agent。
- 尝试使用以下提示：
  - “我明天要去旧金山。天气怎么样？”
  - “查找金门公园附近的咖啡馆。”
  - “查询从 GooglePlex 到旧金山国际机场的路线。”

Java

定义一个在 Java 中初始化 McpToolset 的代理。如果您不使用环境变量，请将 YOUR_GOOGLE_MAPS_API_KEY_HERE 替换为您获取的实际 API 密钥。

package agents;

import com.google.adk.agents.LlmAgent;
import com.google.adk.runner.InMemoryRunner;
import com.google.adk.sessions.SessionKey;
import com.google.adk.tools.mcp.McpToolset;
import com.google.adk.tools.mcp.StreamableHttpServerParameters;
import com.google.genai.types.Content;
import com.google.genai.types.Part;
import java.util.HashMap;
import java.util.Map;

public class MapsAgentCreator {
    public static void main(String[] args) {
        String googleMapsApiKey = System.getenv("GOOGLE_MAPS_API_KEY");
        if (googleMapsApiKey == null || googleMapsApiKey.trim().isEmpty()) {
            googleMapsApiKey = "YOUR_GOOGLE_MAPS_API_KEY_HERE";
            if ("YOUR_GOOGLE_MAPS_API_KEY_HERE".equals(googleMapsApiKey)) {
                System.out.println("WARNING: GOOGLE_MAPS_API_KEY is not set.");
            }
        }

        Map<String, String> headers = new HashMap<>();
        headers.put("X-Goog-Api-Key", googleMapsApiKey);
        headers.put("Content-Type", "application/json");
        headers.put("Accept", "application/json, text/event-stream");

        StreamableHttpServerParameters serverParams =
                StreamableHttpServerParameters.builder("https://mapstools.googleapis.com/mcp")
                        .headers(headers)
                        .build();

        try (McpToolset toolset = new McpToolset(serverParams)) {
            LlmAgent agent = LlmAgent.builder()
                    .model("gemini-flash-latest")
                    .name("travel_planner_agent")
                    .description("A helpful assistant for planning travel routes.")
                    .tools(toolset)
                    .build();

            System.out.println("Agent created: " + agent.name());

            InMemoryRunner runner = new InMemoryRunner(agent);
            String userId = "maps-user-" + System.currentTimeMillis();
            String sessionId = "maps-session-" + System.currentTimeMillis();
            String promptText =
                    "Please give me directions to the nearest pharmacy to Madison Square Garden.";

            SessionKey sessionKey = runner.sessionService()
                    .createSession(runner.appName(), userId, null, sessionId)
                    .blockingGet()
                    .sessionKey();
            System.out.println("Session created: " + sessionId + " for user: " + userId);

            Content promptContent = Content.fromParts(Part.fromText(promptText));
            System.out.println("\nSending prompt: \"" + promptText + "\" to agent...\n");

            runner.runAsync(sessionKey, promptContent)
                    .blockingForEach(event -> {
                        System.out.println("Event received: " + event.toJson());
                    });
        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

TypeScript

定义一个在 TypeScript 中初始化 MCPToolset 的智能体：

import 'dotenv/config';
import {LlmAgent, MCPToolset} from "@google/adk";

const googleMapsApiKey = process.env.GOOGLE_MAPS_API_KEY;
if (!googleMapsApiKey) {
    console.warn("WARNING: GOOGLE_MAPS_API_KEY is not set.");
    throw new Error(
        'GOOGLE_MAPS_API_KEY is not provided, please run "export GOOGLE_MAPS_API_KEY=YOUR_ACTUAL_KEY" to add that.'
    );
}

export const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "travel_planner_agent",
    description: "A helpful assistant for planning travel.",
    tools: [
        new MCPToolset({
            type: "SseConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            headers: {
                "X-Goog-Api-Key": googleMapsApiKey,
                "Content-Type": "application/json",
                "Accept": "application/json, text/event-stream"
            }
        })
    ],
});

分享反馈

如需分享有关地图体验代理工具的反馈，请使用以下表单：