總覽
Maps Platform 代理 UI 工具包是專為對話式 AI 時代設計的開發人員工具包，這項工具提供一組 LLM 系統指令和 UI 元件庫，可協助大型語言模型 (LLM) 和 AI 代理，針對地理空間資料建構即時互動式視覺回覆。
您可以使用工具包，將 LLM 的「意圖指令」轉譯為動態、內容感知的地圖和地點螢幕，而不必硬式編碼視覺元素，讓使用者持續參與即時通訊體驗。
常見用途包括：
- AI 助理：為飯店和餐廳等當地查詢，提供文字回覆和視覺背景資訊。
- 旅遊規劃工具：內嵌地圖、路線和地點詳細資料。
- 低程式碼開發：減少在網頁和行動裝置接觸點手動調度多個 Maps API 的阻礙。
核心概念
1. 支援代理的 UI
建立可擴充的高品質視覺效果，例如地點資訊卡、沉浸式地圖檢視和路線預覽，專為即時 LLM 輔助體驗設計。
2. 情境豐富的體驗
使用者不必離開對話，就能探索及決定。提供豐富的內嵌地圖背景資訊，例如相片庫、評分或路線選項，讓使用者持續參與，並有信心採取行動。
3. 智慧型元件
代理 UI 工具包會自動處理複雜的地理空間邏輯，根據使用者意圖即時調整情境和版面配置，並套用樣式，確保每次互動都與品牌形象一致。
4. 不受特定 LLM 限制
代理 UI 工具包不受特定模型限制，可與您的 AI 堆疊搭配使用。無論您使用 Gemini、OpenAI 或 Anthropic 的模型，也無論基準資料來源為何，這套工具包都提供專屬的呈現層，可視覺化呈現位置資料。
5. 伺服器端範本架構
伺服器端範本架構會在伺服器端執行範本展開和參數解析，加快元件算繪速度。這可縮短即時對話式體驗的延遲時間。
開始使用
如要開始使用 Agentic UI 工具包，請先使用 Google Gemini API 金鑰和 Google Maps Platform API 金鑰進行初始化。
詳情請參閱「開始使用」。
UI 成果
代理 UI 工具包提供一套完善的專用 UI 功能，可立即使用。這些元件適用於網頁、Android 和 iOS。
- 地點詳細資料 (精簡版)：在精簡資訊卡中顯示特定搜尋點 (POI) 資訊
- 內嵌地圖：點或區域定位器
- 內嵌地圖 + 路線：導航或行程預覽
- 內嵌地圖詳細資料：使用豐富圖像呈現地點詳細資料或背景資訊
系統指示
代理 UI 工具包提供「系統指示」，引導主機 LLM 何時及如何建構 UI。
規範
主機模型必須瞭解下列概念：
- 如何根據使用者意圖比對元件，例如使用內嵌地圖進行方向查詢。
- 如何將自然語言參數對應至結構定義，例如使用者要求「風景」時，將地圖模式設為衛星。
工具使用結構定義
Agentic UI 工具包提供定義目錄，與標準 LLM 工具使用結構定義相容，例如函式呼叫。
政策和服務條款
這個程式庫使用 Google 地圖平台服務。透過這個程式庫使用 Google Maps Platform 服務時，須遵守 Google Maps Platform 服務條款。部分 API 和後端服務 (例如 Grounding Lite 和利用 Google 地圖建立基準) 另有附加服務條款，您也必須遵守。
這個程式庫並非 Google Maps Platform 核心服務。因此，Google Maps Platform 服務條款 (例如技術支援服務、服務水準協議和廢止政策) 不適用於這個程式庫中的程式碼。
支援
這個程式庫是透過開放原始碼授權提供。不受《Google 地圖平台技術支援服務指南》、服務水準協議或淘汰政策規範。不過，程式庫使用的任何 Google Maps Platform 服務，仍須遵守《Google Maps Platform 服務條款》。
Google 地圖來源的出處標示規定
代理 UI 工具包的每項工具回覆都會附上來源。呈現使用工具包所提供工具的結果時，您必須按照下列規定，加入相關的 Google 地圖來源：
- Google 地圖來源必須緊接在支援的生成內容之後。
- Google 地圖來源必須在一次使用者互動中可供查看。
提供意見
如要提供地圖代理 UI 工具包的意見回饋，請使用下列