概览
Maps Platform 智能体 UI 工具包是专为对话式 AI 时代设计的开发者工具包。它提供了一组 LLM 系统指令和一个界面组件库，可帮助大语言模型 (LLM) 和 AI 智能体针对地理空间数据构建实时交互式可视化回答。
您无需对视觉元素进行硬编码，而是可以使用该工具包将 LLM 的“基于意图的指令”转换为动态、情境感知型地图和地点显示，让用户在聊天体验中保持互动。
常见用例包括下列各项：
- AI 助理：为本地查询（例如酒店和餐厅）提供视觉背景信息，从而增强文字回答。
- 旅行规划工具：以内嵌方式显示地图、路线和地点详情。
- 低代码开发：减少在 Web 和移动接触点之间手动编排多个地图 API 的阻碍。
主要概念
1. 智能体就绪界面
创建可扩缩的高质量视觉内容（例如地点卡片、沉浸式地图视图和路线预览），这些内容专为由 LLM 提供支持的实时体验而设计。
2. 丰富的上下文体验
帮助用户在不离开聊天的情况下发现和决定。提供丰富的内嵌地图上下文（例如图库、评分或路线选项），以提高用户互动度并让他们有信心采取行动。
3. 智能组件
智能体 UI 工具包会自动处理复杂的地理空间逻辑，根据用户意图即时调整上下文和布局，同时进行样式设置，确保每次互动都与您的品牌紧密相连。
4. 不限定 LLM
智能体 UI 工具包不限模型，可与您的 AI 技术栈搭配使用。无论您使用的是 Gemini、OpenAI 还是 Anthropic 的模型，也无论您的接地数据源是什么，该工具包都提供了一个专用的呈现层来直观呈现位置数据。
5. 服务器端模板架构
服务器端模板架构通过在服务器端执行模板扩展和参数解析，加快了组件呈现速度。这可以缩短实时对话式体验的延迟时间。
开始使用
如需开始使用智能体 UI 工具包，您需要使用 Google Gemini API 密钥和 Google Maps Platform API 密钥对其进行初始化。
如需了解详情，请参阅开始使用。
界面结果
智能体 UI 工具包提供了一套全面的开箱即用型专用 UI 功能。这些组件可在 Web、Android 和 iOS 平台上使用。
- 地点详情（紧凑型）：在紧凑型卡片中显示特定地图注点 (POI) 信息
- 内嵌地图：地点或区域定位器
- 内嵌地图 + 路线：导航或行程预览
- 内嵌地图详情：使用丰富的图像呈现位置详情或背景信息
系统指令
智能体 UI 工具包提供“系统指令”，用于指导宿主 LLM 何时以及如何构建界面。
指南
宿主模型必须理解以下概念：
- 如何将组件与用户意图相匹配，例如使用内嵌地图来处理方向查询。
- 如何将自然语言中的参数映射到架构，例如，如果用户要求“风景优美”，则将地图模式设置为卫星。
工具调用架构
智能体 UI 工具包提供了一系列与标准 LLM 工具使用架构（例如函数调用）兼容的定义。
政策和服务条款
此库使用 Google Maps Platform 服务。通过此库使用 Google Maps Platform 服务时，需遵守 Google Maps Platform 服务条款。 某些 API 和后端服务（例如 Grounding Lite 和依托 Google 地图进行接地）还具有必须满足的其他服务条款要求。
此库不属于 Google Maps Platform 核心服务。因此，Google Maps Platform 服务条款（例如技术支持服务、服务等级协议和弃用政策）不适用于此库中的代码。
支持
此库通过开源许可提供。它不受 Google Maps Platform 技术支持服务准则、服务等级协议 (SLA) 或弃用政策的约束。不过，该库使用的任何 Google Maps Platform 服务仍需遵守 Google Maps Platform 服务条款。
Google 地图来源的标明出处要求
智能体 UI 工具包提供的每个工具回答都包含来源。在展示使用该工具包提供的工具生成的结果时，您必须以符合以下要求的方式注明相关的 Google 地图来源：
- Google 地图来源必须紧跟在这些来源支持的生成内容之后。
- Google 地图来源必须在一次用户互动中可见。
分享反馈
如需分享有关地图智能体 UI 工具包的反馈，请使用以下表单：