错误消息

bookmark_border 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本页介绍了 Google 地图嵌入 API 可能会返回的错误消息。发生错误时，Google 地图嵌入 API 会显示错误消息文本，而不是地图。还可能会出现某些错误情况，导致显示暗色水印地图。

无效请求

如果请求无效，Google 地图嵌入 API 会返回 HTTP 4xx 状态代码和一条描述问题的消息。下面是此类错误情况的示例。注意：此处并未详尽列出所有可能出现的错误。如需了解具体问题的详细信息，请查看 API 返回的实际错误代码和消息。

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 控制台查看控制台输出，如下所示。

1. 依次选择菜单图标 > 更多工具 > 开发者工具，打开“开发者工具”。
2. 如需打开 JavaScript 控制台，请点击“开发者工具”窗口顶部的 Console（控制台）标签页。您还可以使用 ESC 键切换 JavaScript 控制台。