本页面介绍了 Maps Embed API。发生错误时， Maps Embed API 会在地图的位置显示错误消息文本。 还可能会发生某些错误情况，从而导致 暗色水印地图。
无效请求
如果请求无效，Maps Embed API 会返回
一个 HTTP 4xx 状态代码，以及一条描述
问题。以下是此类错误情况的示例。注意：这并非
可能出现的错误的完整列表。请检查实际错误代码
以及 API 返回的错误消息。
| 错误状况示例 | 状态代码 |
|---|---|
请求包含无效参数，或者必需参数是
缺失。例如，zoom 参数并不在
期望的数值范围，或者以下字段中缺少某个必需参数：
请求。 |
400 BAD REQUEST |
| 请求中包括的 API 密钥无效。 | 403 FORBIDDEN |
API 密钥和配额错误
API 密钥和配额错误将被视为无效请求。可能的原因 包括：
- API 密钥缺失或无效。要解决此错误，请确保您的 请求包含有效的 API 密钥。<ph type="x-smartling-placeholder"></ph> 获取 API 密钥。
- 您的项目未启用 Maps Embed API。了解 启用和停用 API。
- API 密钥违反了限制。阅读 了解有关 API 密钥最佳做法的详情。
结算和 HTTP 引荐来源网址错误
暗色地图或“负”街景图片，带有“ ”的水印 仅用于开发目的”当以下任意情况为 true 时，系统将返回 ：
- 您的账号尚未启用结算功能。启用结算功能。
- 提供的结算方式无效（例如赠金过期） 卡片）。要解决此问题，请访问 Google Cloud 控制台，并确保您提供的付款方式有效。
- 您已超出自己设定的每日上限。<ph type="x-smartling-placeholder"></ph> 了解如何查看或更改每日可结算限额。
- 请求缺少 HTTP 引荐来源网址，而您使用的是 有引荐来源网址限制的 API 密钥。学习 详细了解如何添加引荐来源网址。
在浏览器中查看错误
对于结算和 HTTP 引荐来源网址错误，Maps Embed API 会写入
错误消息发送到 window.console。对于无效请求（包括
API 密钥和配额错误），系统仅会报告 HTTP 4xx 状态代码
。本部分介绍如何在
Google Chrome。如果您使用的是任何其他浏览器，请与开发者联系
文档。以下为供您参考的工具列表，
在其他浏览器中检查控制台输出。
- 控制台，适用于 Internet Explorer。
- Web 控制台，适用于 Firefox。
- 远程调试，适用于 Android。
- Web Inspector，适用于 iOS。
在 Chrome 中，您可以使用 JavaScript 控制台 按如下方式检查控制台输出。
- 要打开开发者工具，请选择菜单图标 >更多工具 > 开发者工具。
- 如需打开 JavaScript 控制台，请点击顶部的控制台标签页 “开发者工具”窗口中您还可以使用 ESC 键 JavaScript 控制台。