错误消息

本页面介绍了 Maps Embed API 可能会返回的错误消息。发生错误时,Maps Embed API 会代替地图显示错误消息文本。还可能会出现某些错误情况,导致显示暗色水印地图。

无效请求

如果请求无效,Maps Embed API 会返回 HTTP 4xx 状态代码和一条描述问题的消息。以下是此类错误情况的示例。注意:以上并未列出所有可能的错误。请查看 API 返回的实际错误代码和消息,了解有关特定问题的详细信息。

错误状况示例 状态代码
请求包含无效参数,或缺少必需的参数。例如,zoom 参数不在预期的数值范围内,或者请求中缺少某个必需的参数。 400 BAD REQUEST
请求中包括的 API 密钥无效。 403 FORBIDDEN

API 密钥和 QPS 错误

API 密钥和 QPS 错误均被视为无效请求。可能的原因包括:

结算和 HTTP 引荐来源网址错误

满足以下任一条件时,会返回带有“仅用于开发目的”水印的暗色地图或“负片”街景图像:

在浏览器中查看错误

对于结算和 HTTP 引荐来源网址错误,Maps Embed API 会将错误消息写入 window.console。对于无效请求(包括 API 密钥和 QPS 错误),控制台中仅报告 HTTP 4xx 状态代码。本部分介绍了如何在 Google Chrome 中查看控制台输出。如果您使用的是任何其他浏览器,请查看相应浏览器的开发者文档。下面列出了一些其他浏览器中用于检查控制台输出的工具,供您参考。

在 Chrome 中,您可以使用 JavaScript 控制台查看控制台输出,如下所示。

  1. 要打开开发者工具,请依次选择菜单图标 > 更多工具 > 开发者工具
  2. 要打开 JavaScript 控制台,请点击“开发者工具”窗口顶部的 Console 标签页。您也可以使用 ESC 键来开启/关闭 JavaScript 控制台。