本页面介绍了 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 控制台,并确保您已提供有效的付款方式。
- 已超出您设定的每日上限。 了解如何查看或更改每日可结算限额。
- 请求缺少 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 控制台。