Google Maps JavaScript API 向 window.console 写入错误和警告消息。下表列出了 Google Maps JavaScript API 可能会返回的错误代码，并说明了问题原因以及解决方法。如需有关如何查找错误消息的帮助，请参阅在浏览器中检查错误部分。
Google Maps JavaScript API 错误代码
如果您在加载 Google Maps JavaScript API 时遇到错误，请参阅下表，找到对错误代码的说明。
| 错误代码 | 消息 | 说明 |
|---|---|---|
InvalidKeyOrUnauthorizedURLMapError
|
提供的 Google API 密钥无效，或者此站点未获得使用此密钥的授权。 |
用于加载 API 的脚本元素中包含的 API 密钥无效，或者加载 Google Maps JavaScript API 的当前 URL 尚未添加到允许的引用站点列表中。您可能需要在 Google API Console 中的 API 下启用 Google Maps JavaScript API。 请参阅获取 API 密钥。 |
NotLoadingAPIFromGoogleMapError
|
Google Maps JavaScript API 必须直接从 Google 的服务器下载。 |
您的页面中未正确包含用于加载 Google Maps JavaScript API 的脚本元素。为使 API 正常工作，必须直接从 https://maps.googleapis.com 加载它。 请参阅加载 Maps API。 |
TOSViolationMapError
|
此网站似乎违反了 Google Maps API 服务条款。The Google Maps API has been disabled for this website. |
您的应用因经过数次电子邮件通知后仍不符合 Google Maps APIs 服务条款的要求而被屏蔽。要对屏蔽进行申诉并让您的实现接受复审，请填写此表单。您将在几个工作日内收到电子邮件回复。 如果您有 Google Maps APIs Premium Plan 许可证，请使用您的 Google Maps APIs Premium Plan 凭据解决此错误。请参阅 API 密钥和客户端 ID 指南。 |
UnauthorizedURLForClientIdMapError
|
此 URL 未获得使用所提供的 Google 地图客户端 ID 的授权。 |
脚本加载中包含的 Premium Plan 或 Maps APIs for Work 客户端 ID 无效、已过期，或者加载 Google Maps JavaScript API 的当前地址尚未添加到已获授权的网址列表中。 请参阅注册已获授权的 URL。 |
面向开发者的 Google Maps JavaScript API 错误代码
如果您在 Chrome JavaScript Console 或 Firefox Web Console 或您浏览器上的任何其他同等工具中发现错误，请参阅下表，找到相应错误代码的说明。
错误代码分有 2 种类型：错误和警告。错误表示加载 Google Maps JavaScript API 时发生严重问题。您的页面无法正确加载 API，因为此 API 不能在该页面上工作。警告是有关 Google Maps JavaScript API 加载的补充消息。警告描述错误的可能原因，或表明您用于加载 Google Maps JavaScript API 的代码中存在潜在问题。如果您只收到警告而没有收到任何错误，API 将可以在该页面上正常工作。不过，我们建议您还是要修复潜在问题。
| 开发者错误代码 | 类型 | 说明 |
|---|---|---|
ApiNotActivatedMapError
|
错误 |
您的 API 项目中未激活 Google Maps JavaScript API。您可能需要在 Google API Console 中的 API 下启用 Google Maps JavaScript API。 请参阅获取 API 密钥。 |
DeletedApiProjectMapError
|
错误 |
您的 API 项目可能已从 Google API Console 中删除。请检查并确认您为其生成 API 密钥的项目已包含在 JavaScript API 加载器中。您可以创建一个新的 API 项目并在 Google API Console 上获取一个新的密钥。 请参阅获取 API 密钥。 |
ExpiredKeyMapError
|
错误 |
用于加载 API 的脚本元素中包含的 API 密钥已过期。您可能需要在 Google API Console 中生成一个新的 API 密钥。 请参阅获取 API 密钥。 |
InvalidClientIdMapError
|
错误 |
用于加载 API 的脚本元素中包含的客户端 ID 无效或已过期。请确保您使用的客户端 ID 正确。客户端 ID 应以前缀“gme-”开头。如果您在使用的客户端 ID 正确无误时仍看到此错误，则表示客户端 ID 可能已过期。请联系您的 Google 帐户管理员。
如果您没有 Premium Plan 或 Maps APIs for Work 许可证，则需要将 请参阅您的客户端 ID。 |
InvalidKeyMapError
|
错误 |
未找到用于加载 API 的脚本元素中所包含的 API 密钥。请确保您使用的 API 密钥正确。您可以在 Google API Console 上生成新的 API 密钥。 请参阅获取 API 密钥。 |
MissingKeyMapError
|
错误 |
加载 API 的脚本元素缺少必需的身份验证参数。如果您使用的是标准 Maps JavaScript API，则必须将 请参阅 API 密钥和客户端 ID 指南。 |
ProjectDeniedMapError
|
错误 |
您的请求尚未完成。您或许可以在 Google API Console 中找到有关错误的更多详细信息。 请参阅 Google API Console。 |
RefererDeniedMapError
|
错误 |
您的应用因经过数次电子邮件通知后仍不符合 Google Maps APIs 服务条款的要求而被屏蔽。要对屏蔽进行申诉并让您的实现接受复审，请填写此表单。您将在几个工作日内收到电子邮件回复。 |
RefererNotAllowedMapError
|
错误 |
加载 Google Maps JavaScript API 的当前 URL 尚未添加到允许的引用站点列表中。请在 Google API Console 上检查您的 API 密钥的引用站点设置。 请参阅 Google API Console 中的 API 密钥。如需了解详细信息，请参阅 API 密钥安全使用最佳实践。 |
OverQuotaMapError
|
错误 |
请求次数已超过 Google Maps JavaScript API 的使用限额。应用请求次数将在下一次每日配额重置时得到恢复。 如需了解更多详情，请参阅使用限额指南。该页面还说明了如何才能获得更高使用限额。 |
ClientIdLooksLikeCryptoKey
|
警告 |
您可能已经在 请参阅适用于 Premium Plan 和 Maps APIs for Work 客户的客户端 ID 指南。 |
ClientIdLooksLikeKey
|
警告 |
您可能已经在 请参阅客户端 ID 和 API 密钥指南。 |
InvalidChannel
|
警告 |
您提供的 |
InvalidClientId
|
警告 |
请参阅适用于 Premium Plan 或 Maps APIs for Work 客户的客户端 ID 指南。 |
InvalidKey
|
警告 |
用于加载 API 的脚本元素中包含的 API 密钥似乎不正确。请确保您使用的 API 密钥正确。您可以在 Google API Console 上生成新的 API 密钥。 请参阅获取 API 密钥。 |
InvalidVersion
|
警告 |
您在脚本元素中提供的版本号可能不正确。请确保您使用的版本号正确。 |
KeyLooksLikeClientId
|
警告 |
您可能已经以 key 参数形式提供了一个客户端 ID。如果您有 Premium Plan 或 Maps APIs for Work 许可证，请以 client 参数（而非 key 参数）形式指定您的客户端 ID。如果您有 Google Maps APIs Premium Plan，可以使用 client 参数或 key 参数。如果您没有任何许可证，则必须使用 key 参数，而非 client 参数。
请参阅客户端 ID 和 API 密钥指南。 |
KeyLooksLikeCryptoKey
|
警告 |
您可能已经以 请参阅客户端 ID 和 API 密钥指南。 |
KeyLooksLikeProjectNumber
|
警告 |
您可能已经以 请参阅获取 API 密钥。 |
NoApiKeys
|
警告 |
加载 API 的脚本元素不包含任何 API 密钥。请确保您以 请参阅获取 API 密钥。 |
RetiredVersion
|
警告 |
您在脚本元素中提供的版本可能已经退役。版本 3.0 - 3.24 已经退役，您可能会收到 3.25。请更新您的应用以使用一个可用版本。 |
SensorNotRequired
|
警告 |
Google Maps JavaScript API 不再需要 |
SignatureNotRequired
|
警告 |
Google Maps JavaScript API 不需要 |
SignedInDeprecated
|
警告 |
请检查您的应用，并参阅已登录地图 | Google Maps JavaScript API，详细了解即将到来的变更的相关信息。 |
UrlAuthenticationCommonError
|
错误 |
发生了不归属此页面上其他类别的错误。这可能是由临时问题所致。请稍等片刻后重试请求。如果这不能解决问题，请查阅开发者指南，确保请求的格式正确。 |
在浏览器中检查错误
Google Maps JavaScript API 会向 window.console 写入错误消息。此部分说明如何在 Google Chrome 中检查 window.console 输出。如果您使用的是任何其他浏览器，请查阅您的浏览器的开发者文档。以下列出了在一些其他浏览器中用于检查 window.console 输出的工具供您参考。
- Console：适用于 Internet Explorer。
- Web Console：适用于 Firefox。
- Remote debugging：适用于 Android。
- Web Inspector：适用于 iOS。
在 Chrome 中，可以使用 JavaScript 控制台按以下步骤检查 window.console 输出。
- 要打开开发者工具，选择菜单图标 > More Tools > Developer Tools。
- 要打开 JavaScript 控制台，按键盘上的 ESC 键。ESC 键用于开关 JavaScript 控制台。如果关闭了控制台，再次按 ESC 键可将其打开。
如果加载 Google Maps JavaScript API 时发生任何错误或警告，它们会以一行或多行形式出现在控制台中。错误或警告消息的格式如下：
Google Maps API 错误：[错误代码] [API 文档链接]
或
Google Maps API 警告：[错误代码] [API 文档链接]
可以通过查看上面的错误代码表找到错误消息中的错误代码。还可以在错误消息链接的 API 文档中找到有关该消息的详情。
注：可以通过编程方式侦听身份验证错误。
需要帮助？请访问我们的