地图实验专区智能体工具版本说明

本页面列出了地图体验智能体工具（以前称为 Maps Grounding Lite）的版本说明。

2026 年 11 月 11 日

正式版和 REST

  • Pro 选项已正式发布，适用于所有 Google Cloud 项目。search_places 和 compute_routes 的 Pro 选项不再需要将项目列入许可清单。如需了解详情，请参阅基本功能版和专业版。
  • 为每个工具添加了 REST 方法，例如为 search_places 添加了 POST https://mapstools.googleapis.com/v1:searchText。如需了解详情，请参阅使用 REST 调用工具。

沿路线搜索 (search_along_route)

  • 添加了 search_along_route 工具，用于根据自然语言查询查找沿途地点。
    • 使用先前 compute_routes 调用的 retrieval_token、route_endpoints（origin 和 destination）或 encoded_polyline 指定路线。
    • 返回 AI 生成的 summary、一个排好序的 results[] 列表（其中每个 place 均与其 detourSummary [localizedDetourDistance 和 detourDuration] 配对），以及一个 contentToken（用于通过 Places UI Kit 显示地点，无需额外付费）。
    • 支持 DRIVE、WALK 和 BICYCLE 出行方式、路况感知路线规划 (ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL) 以及扩展的地点详情 (include_extended_details)。
  • 更新了 compute_routes，以便在 DRIVE 路由上返回 retrievalToken（有效期为 10 分钟），从而使代理可以链接 compute_routes 和 search_along_route。
  • 每个 search_along_route 请求都会按 Maps Grounding Pro SKU 计费。

lookup_weather 中的环境功能

  • 扩展了 lookup_weather，以通过 capabilities 参数（WEATHER、AIR_QUALITY 和 POLLEN）支持跨天气、空气质量和花粉的多领域环境查询：
    • 天气 (WEATHER)：添加最多 24 小时的每小时天气历史记录（同时设置 date 和 hour 时），以及当前天气状况和最多 10 天的每小时和每日天气预报，外加 weather_options.units_system 和 language_code。按 Maps Grounding Essentials SKU 结算。
    • 空气质量 (AIR_QUALITY)：返回每小时空气质量指数 (AQI) 值（使用 air_quality_options.index_region_code 的通用 AQI 和本地 AQI）、可选污染物浓度 (air_quality_options.include_pollutant_concentration) 以及健康建议。当前天气状况和最多 4 天（96 小时）的每小时天气预报按 Maps Grounding Essentials SKU 计费。过去最多 30 天（720 小时）的历史空气质量数据属于 Pro 选项，按 Maps Grounding Pro SKU 计费。
    • 花粉 (POLLEN)：返回从今天开始最多 5 天的每日花粉预报，包括Tree、Grass和Weed类别指数、健康建议以及致敏植物物种详情。按 Maps Grounding Pro SKU 结算。

价格

2026 年 10 月 28 日

  • 将 Maps Grounding Lite 重命名为地图体验智能体工具，并将 Maps Grounding Lite SKU 重命名为 Maps Grounding Essentials。
  • 为 search_places（include_extended_details 和 page_size，6 到 10）和 compute_routes（ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL 和 11 到 25 intermediate_waypoints）引入了专业版选项（受限 GA），以及 BICYCLE 和 TRANSIT 出行方式、departure_time 和 arrival_time、compute_alternative_routes、include_polyline 和 location_bias。
  • 推出了智能体数据可视化令牌（预览版），该令牌在 contentToken 中返回，用于在 Maps JavaScript API 中使用 Places UI Kit 显示有依据的地点，无需额外付费。