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