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