Google AI Studio (AIS) 中集成了 Google Maps Platform，让开发者能够快速设计原型并部署 AI 驱动的 Web 应用，这些应用具有交互式地图、真实世界地点数据和路线规划功能。
通过Maps Demo Key集成，您可以直接在 AI Studio 中生成具有位置感知功能的功能性 AI 原型，而无需创建 Google Cloud 结算账号或离开开发环境。如果您已在使用 Google Cloud，则可以关联一个已启用结算功能的项目，以便访问所有 Google Maps Platform 产品，而不受每日演示配额限制；也可以先使用地图演示密钥，然后在准备好扩容时关联项目。
主要特性
- 零摩擦入门：无论您是 Google Cloud 新手还是已有云项目，都无需输入信用卡信息或浏览 Google Cloud 控制台，即可直接在 AI Studio 中获取 Maps Demo Key。
- 自动意图检测：AI Studio 可识别地理空间提示（例如搜索附近的地点、显示交互式地图或计算路线），并自动配置 Google Maps Platform 建议和技能。
- 即时原型设计：系统会在后台自动预配演示凭据，以便 AI 生成的代码立即运行。
- 无缝扩缩：当您的应用准备好扩缩时，请关联 Cloud Billing 账号或连接现有的已结算云项目，以移除任何配额限制。
如何开始使用
AI Studio 会预配 Google Maps Platform 凭据，并将其安全地存储在应用的 Secret 设置中。如何开始使用取决于您是否是 Google Cloud 新手：
- Google Cloud 新用户：AI Studio 会创建一个免费项目和一个地图演示密钥，供您开始使用。
- 现有 Google Cloud 用户：您可以选择使用 Maps Demo Key（具有部分 API 和每日配额限制）进行免费原型设计，也可以通过关联现有的已结算云项目来获得具有生产级配额的完整访问权限。
Maps Demo Key 受地图演示项目服务条款约束。
| 功能 | 新用户 | 现有用户（免费原型设计） | 现有用户（连接已付费的云项目） |
|---|---|---|---|
| 凭据类型 | Maps Demo Key | Maps Demo Key | 标准 Google Cloud API 密钥 |
| 结算设置 | 无需提供信用卡或 Google Cloud 结算账号 | 无需提供信用卡或 Google Cloud 结算账号 | 需要 Google Cloud Billing 账号 |
| API 覆盖范围 |
所有 Google Maps Platform API（Route Optimization、Solar 和 Nav Connect 除外），包括：
|
常用的原型设计 API（请参阅支持的功能）：
|
100% 的 Google Maps Platform API 产品组合（包括 Route Optimization、Solar 和 Nav Connect） |
| 每日限额 | 每个 API 每天 100 次调用 | 每个 API 每天 100 次调用 | 标准配额和每月免费用量 |
| 密钥限制 | 自动化流程内 Secret 管理 | 自动化流程内 Secret 管理 | 自定义 HTTP 引荐来源网址、IP 或应用限制 |
| 使用意图 | 原型设计、测试和 AI Studio Web 应用 | 原型设计、测试和 AI Studio Web 应用 | 正式版 Web 应用和移动应用 |
| 投产路径 | 将 Cloud Billing 账号与项目相关联；您的密钥会继续有效 | 在 AI Studio 中关联已结算的 Cloud 项目 | 已可用于生产用途 |
问题排查和配额
通过 AI Studio 提供的演示密钥在每日请求限制下运行，这些限制专为交互式开发会话而设计。每日请求上限为每个 API 每天 100 次调用。
“已超出配额”错误
如果您的应用在使用演示密钥时收到 RESOURCE_EXHAUSTED 或超出配额错误，请执行以下操作：
- 每日重置：演示密钥配额每 24 小时自动重置一次。您可以在重置周期后恢复测试。
- 标准密钥配额重叠：如果您使用的是标准 API 密钥，并且遇到提及演示环境限制的配额错误消息，请在 Google Cloud 控制台配额页面中验证项目的配额限制。
- 升级以获得更高用量：如果您的原型设计需求超出了每日演示限制，请升级到标准 Google Cloud 账号，以解锁完整的生产配额。
“API 不可用”错误
如果您是现有 Google Cloud 用户，正在使用 Maps Demo Key 进行原型设计，并且请求因 API 密钥限制错误（例如 Maps JavaScript API 中的 ApiTargetBlockedMapError）而失败，则表示该 API 不在相应密钥的受支持 API 列表中。请关联已结算的 Cloud 项目，以便使用该项目。
升级到正式版密钥
当您的应用准备好投入生产或需要更高的配额限制时，请在 Google Cloud 控制台中关联 Cloud Billing 账号，以升级您的项目。您现有的演示版 API 密钥会继续有效，因此您无需更新应用代码。
如果您已有 Cloud Billing 账号，也可以跳过演示密钥：在 AI Studio 中启用 Google Maps Platform 时，选择一个已设置结算信息的云项目，即可从一开始就获得一个标准 API 密钥，该密钥具有完整的 API 覆盖范围和标准配额。
相关资源
- 获取并使用 Maps Demo Key
- Google Maps Platform 智能体技能
- Maps Grounding Lite (MCP)
- Google Maps Platform Code Assist