總覽
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. 伺服器端範本架構
伺服器端範本架構會在伺服器端執行範本展開和參數解析，加快元件轉譯速度。這可縮短即時對話式體驗的延遲時間。
開始使用
如要開始使用代理 UI 工具包，您必須使用 Google Gemini API 金鑰和 Google Maps Platform API 金鑰進行初始化。
詳情請參閱「開始使用」。
UI 成果
代理 UI 工具包提供一套完善的專用 UI 功能，可立即使用。這些元件適用於網頁、Android 和 iOS。
- 地點詳細資料 (精簡)：在精簡資訊卡中顯示特定搜尋點 (POI) 資訊
- 內嵌地圖：點或區域定位器
- 內嵌地圖 + 路線：導航或行程預覽
- 內嵌地圖詳細資料：使用豐富圖像呈現地點詳細資料或背景資訊
系統指示
代理 UI 工具包提供「系統指令」，引導主機 LLM 何時及如何建構 UI。
規範
主機模型必須瞭解下列概念：
- 如何根據使用者意圖比對元件，例如使用內嵌地圖進行方向查詢。
- 如何將自然語言的參數對應至結構定義，例如使用者要求「風景」時，將地圖模式設為衛星。
工具使用結構定義
Agentic UI 工具包提供定義目錄，與標準 LLM 工具使用結構定義 (例如函式呼叫) 相容。
政策和服務條款
這個程式庫使用 Google 地圖平台服務。透過這個程式庫使用 Google 地圖平台服務時，須遵守 Google 地圖平台《服務條款》。部分 API 和後端服務 (例如 Grounding Lite 和利用 Google 地圖建立基準) 另有附加服務條款，您也必須遵守。
這個程式庫並非 Google Maps Platform 核心服務。因此，Google Maps Platform 服務條款 (例如技術支援服務、服務水準協議和廢止政策) 不適用於這個程式庫中的程式碼。
支援
這個程式庫是透過開放原始碼授權提供。不受《Google 地圖平台技術支援服務指南》、服務水準協議或淘汰政策規範。不過，程式庫使用的任何 Google 地圖平台服務，仍須遵守《Google 地圖平台服務條款》。
Google 地圖來源的作者資訊相關規定
代理 UI 工具包的每項工具回覆都會附上來源。呈現使用工具包所提供工具的結果時，您必須按照下列規定，加入相關的 Google 地圖來源：
- Google 地圖來源必須緊接在支援的生成內容之後。
- Google 地圖來源必須在一次使用者互動中可供查看。
提供意見
如要提供地圖代理 UI 工具包的意見回饋，請使用下列