概览
Maps Platform Agentic UI 工具包 是一款专门为对话式 AI 时代设计的开发者工具包。它提供了一组 LLM 系统指令和一个 UI 组件库，可帮助大语言模型 (LLM) 和 AI 智能体为地理空间数据构建实时交互式视觉响应。
开发者无需对视觉元素进行硬编码，而是可以使用该工具包将 LLM 的“基于意图的指令”转换为动态的、感知上下文的地图和地点显示，让用户在聊天体验中保持参与度。
常见用例包括：
- AI 助理 ：为本地查询（例如酒店、餐厅）的文本响应添加视觉上下文。
- 旅行规划工具 ：内嵌显示地图、路线和地点详细信息。
- 低代码开发 ：减少手动编排多个 Maps API 的摩擦。
主要概念
1. 可用于智能体的界面
启用可扩缩的高质量视觉元素（例如地点卡片、沉浸式地图视图和路线预览），这些元素专为实时 LLM 支持的体验而设计。
2. 基于丰富的上下文信息的体验
让用户无需离开聊天即可发现和做出决定。提供丰富的内嵌地图上下文（例如照片库、评分或路线选项）可让用户保持参与度，并让他们有信心采取行动。
3. 智能组件
Agentic UI 工具包会自动处理复杂的地理空间逻辑，即时根据用户意图调整上下文和布局，同时进行样式设置，确保每次互动都与您的品牌相关联。
4. 与 LLM 无关
智能体 UI 工具包与您的 AI 技术栈不限模型。无论您使用的是 Gemini，还是 OpenAI 或 Anthropic 的模型，也无论您的接地数据源是什么，Agentic UI 工具包都会提供专用的呈现层来可视化位置数据。
使用入门
如需开始使用 Agentic UI 工具包，您需要使用单个 API 密钥对其进行初始化。这样可以抽象出底层 Maps 服务，因此您无需管理单独的 API。
如需了解详细说明，请参阅使用入门指南。
界面结果
Agentic UI 工具包提供了一套全面的专用界面功能，开箱即可使用。
- 地点详细信息（简洁）：简洁卡片中的特定 POI 信息。
- 内嵌地图：点或区域定位器。
- 内嵌地图 + 路线：导航或行程预览。
- 内嵌地图详细信息：使用丰富的图像显示位置氛围或上下文。
系统指令
Agentic UI 工具包提供“系统指令”，以指导宿主 LLM 何时以及如何构建界面。
指南
宿主模型必须了解：
哪个组件与哪个用户意图匹配（例如，使用内嵌地图进行方向查询）。
从自然语言到架构的参数映射（例如，如果用户要求“风景优美”，则将地图模式设置为卫星）。
工具使用架构
Agentic UI 工具包公开了与标准 LLM 工具使用架构（例如函数调用）兼容的定义目录。
政策和服务条款
此库使用 Google Maps Platform 服务。通过此库使用 Google Maps Platform 服务时，需遵守 Google Maps Platform 服务条款。 某些 API 和后端服务（例如 Grounding Lite 和 Grounding with Google Maps）有附加服务条款要求，您也必须满足这些要求。
此库不是 Google Maps Platform 核心服务。因此，Google Maps Platform 服务条款（例如技术支持服务、服务等级协议和服务终止政策）不适用于此库中的代码。
支持
此库通过开源许可提供。它不受 Google Maps Platform 支持技术支持服务准则、服务等级协议或 弃用政策的约束。不过，该库使用的任何 Google Maps Platform 服务仍需遵守 Google Maps Platform 服务条款。
Google 地图来源的版权归属要求
Agentic UI 工具包的每个工具响应都包含来源。在呈现使用该工具包提供的工具的结果时，您必须以符合以下要求的方式添加关联的 Google 地图来源：
- Google 地图来源必须紧随来源支持的生成内容。
- Google 地图来源必须在一次用户互动中可见。