本页介绍了 Maps Embed API 可能返回的错误消息。发生错误时，Maps Embed API 会显示错误消息文本来替代地图。系统也可能会发生某些错误，从而导致水印变暗。
无效请求
如果请求无效，Maps Embed API 会返回 HTTP 4xx 状态代码以及一条描述问题的消息。以下是此类错误情况的示例。注意：以上并未列出可能出现的错误。请查看 API 返回的实际错误代码和消息，了解具体问题的详细信息。
| 错误状况示例 | 状态代码 |
|---|---|
请求包含无效参数，或缺少必需的参数。例如，zoom 参数不在预期的数值范围内，或者请求中缺少必需参数。 |
400 BAD REQUEST |
| 请求中包括的 API 密钥无效。 | 403 FORBIDDEN |
API 密钥和 QPS 错误
API 密钥和 QPS 错误被视为无效请求。可能的原因包括：
- API 密钥缺失或无效。如需解决此错误，请确保您的请求包含有效的 API 密钥。获取 API 密钥。
- 您的项目未启用 Maps Embed API。了解如何启用和停用 API。
- API 密钥存在限制限制。详细了解 API 密钥最佳做法。
结算和 HTTP 引荐来源网址错误
当满足以下任何条件时，系统会返回暗色地图，即带有“仅供开发用”水印的“负”街景图片：
- 您的帐号尚未启用结算功能。启用结算功能。
- 提供的结算方式无效（例如信用卡已过期）。要解决此问题，请访问 Google Cloud Console，并确保您提供了有效的付款方式。
- 超出了您自行设定的每日上限。 了解如何查看或更改每日可结算限制。
- 请求缺少 HTTP 引荐来源网址，并且您使用的是引荐来源网址受限的 API 密钥。详细了解如何添加引荐来源。
在浏览器中检查错误
对于结算和 HTTP 引荐来源网址错误，Maps Embed API 会将错误消息写入 window.console。对于无效请求（包括 API 密钥和 QPS 错误），控制台中仅报告 HTTP 4xx 状态代码。本部分介绍如何在 Google Chrome 中检查控制台输出。如果您使用的是任何其他浏览器，请查看您所用浏览器的开发者文档。以下列出了在一些其他浏览器中用于检查控制台输出的工具，供您参考。
- 适用于 Internet Explorer 的控制台。
- Web 控制台：适用于 Firefox。
- 远程调试（适用于 Android）。
- Web Inspector：适用于 iOS。
在 Chrome 中，您可以使用 JavaScript 控制台检查控制台输出，如下所示。
- 如需打开“开发者工具”，请依次选择菜单图标 > 更多工具 > 开发者工具。
- 如需打开 JavaScript 控制台，请点击“开发者工具”窗口顶部的 Console 标签页。您还可以使用 ESC 键切换 JavaScript 控制台。