通过将 Google Maps Platform 集成到 Google AI Studio (AIS) 中,开发者可以快速对 AI 驱动的 Web 应用进行原型设计和部署,这些应用具有交互式地图、真实世界地点数据和路线规划功能。
通过集成 Maps Demo Key,您可以在 AI Studio 中直接生成功能性、可感知位置信息的 AI 原型,而无需创建 Google Cloud 结算账号或离开开发环境。
主要特性
- 顺畅无阻的初始配置体验:直接在 AI Studio 中获取 Maps 演示密钥,无需输入信用卡信息或浏览 Google Cloud 控制台。
- 自动检测意图:AI Studio 会识别地理空间提示(例如搜索附近地点、显示互动式地图或计算路线),并自动配置 Google Maps Platform 建议和技能。
- 即时原型设计:系统会在后台自动预配演示凭据,以便您立即运行 AI 生成的代码。
- 无缝扩缩:当您的应用准备好扩缩时,请在 Google Cloud 控制台中升级您的账号,以移除所有配额限制。
了解演示密钥与标准密钥
在 AI Studio 中构建时,您的项目会使用在应用 Secret 设置中安全存储的自动配置的 Maps 演示密钥。
| 功能 | Maps Demo Key | 标准 Google Cloud API 密钥 |
|---|---|---|
| 结算设置 | 无需提供信用卡或 Google Cloud 结算账号 | 需要 Google Cloud Billing 账号 |
| API 覆盖范围 | 所有 Google Maps Platform API(路线优化、Solar 和 Nav Connect 除外) | Google Maps Platform API 产品组合的 100% |
| 主要限制 | 自动化流程内 Secret 管理 | 自定义 HTTP 引荐来源网址、IP 或应用限制 |
| 使用意图 | 原型设计、测试和 AI Studio Web 应用 | 正式版 Web 应用和移动应用 |
支持的 API 和功能
演示密钥支持几乎所有 Google Maps Platform API,可用于快速原型设计,包括:
| 产品/API | 主要功能 |
|---|---|
| Maps JavaScript API | 在 Web 应用中呈现动态的互动式地图、标记和信息窗口。 |
| Maps SDK for Android 和 iOS | 向移动应用添加互动式地图和位置信息功能。 |
| Places API | 搜索本地地点,检索地点详情、照片、用户评分和评价。 |
| Routes API 和 Compute Routes Matrix | 计算驾车和步行路线、计算距离并估算行程时间。 |
| 地理编码和地理定位 API | 将地址转换为坐标,并使用移动网络或 Wi-Fi 对设备位置进行三角定位。 |
| Address Validation API | 根据邮政数据验证实际地址和格式组成部分。 |
| 地图 Static API 和 街景 Static API | 嵌入静态地图图片或 360 度街景全景图片。 |
| 环境 API | 访问空气质量、花粉和天气状况的实时数据和历史数据。 |
| Aerial View API | 生成身临其境的影院级 3D 航拍视频。 |
问题排查和配额
通过 AI Studio 提供的演示密钥受每日请求次数限制,旨在用于交互式开发会话。每日请求限制为每个 API 每天 100 次调用。
“已超出配额”错误
如果您的应用在使用演示密钥时收到 RESOURCE_EXHAUSTED 或超出配额错误,请执行以下操作:
- 每日重置:演示密钥配额每 24 小时自动重置一次。您可以在重置周期结束后继续测试。
- 标准密钥配额重叠:如果您使用的是标准 API 密钥,并且遇到提及演示环境限制的配额错误消息,请在 Google Cloud 控制台的“配额”页面中验证项目的配额限制。
- 升级以提高容量:如果您的原型设计需求超出了每日演示限制,请升级为标准 Google Cloud 账号,以解锁完整的生产配额。
升级为正式版密钥
当您的应用准备好投入生产环境或需要更高的配额限制时,您可以通过 Google Cloud 控制台升级账号。您现有的演示版 API 密钥会继续正常发挥作用,因此无需更新应用代码。
提供有效的付款方式,升级您的账号。