Maps Experiments 代理工具版本資訊

本頁列出地圖體驗代理工具 (舊稱 Maps Grounding Lite) 的版本資訊。

2026 年 11 月 11 日

正式發布版和 REST

• Pro 選項已正式發布，適用於所有 Google Cloud 專案。search_places 和 compute_routes 的 Pro 選項不再需要將專案加入許可清單。詳情請參閱「Essentials 和 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 計費。

定價

• 發布 Maps Grounding Pro SKU 的 SKU 詳細資料和大量定價 (9A04-4753-07E4 全球；AE33-0324-9314 印度)。
• 更新 Maps Grounding Essentials SKU 的用量定價級別。如要查看價格，請參閱主要價目表和印度價目表。

2026 年 10 月 28 日

• Maps Grounding Lite 重新命名為 Maps Experience 代理工具，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) 的專業選項 (受限正式發布版)，以及 BICYCLE 和 TRANSIT 交通模式、departure_time 和 arrival_time、compute_alternative_routes、include_polyline 和 location_bias。
• 推出代理資料視覺化權杖 (預先發布版)，在 contentToken 中傳回，以便在 Maps JavaScript API 中使用 Places UI Kit 顯示有根據的地點，不需額外付費。