概览
Maps Platform 智能体界面工具包是一款专门为对话式 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 密钥对其进行初始化。
如需了解详情，请参阅使用入门。
界面结果
Agentic 界面工具包提供了一套全面的专业界面功能，可开箱即用。这些组件可在网页、Android 和 iOS 上使用。
- 地点详情，紧凑型：紧凑型卡片中的特定地图注点 (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 地图来源必须在一次用户互动中可见。
分享反馈
如要针对地图智能体界面工具包分享反馈，请使用以下表单：