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