一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Maps JavaScript API

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Maps JavaScript API 及相关服务
  3. 创建相应密钥
继续

错误消息


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 ConsoleFirefox 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 许可证,则需要将 key 参数搭配您的 API 密钥使用,而不使用 client 参数。

请参阅您的客户端 ID

InvalidKeyMapError 错误

未找到用于加载 API 的脚本元素中所包含的 API 密钥。请确保您使用的 API 密钥正确。您可以在 Google API Console 上生成新的 API 密钥。

请参阅获取 API 密钥

MissingKeyMapError 错误

加载 API 的脚本元素缺少必需的身份验证参数。如果您使用的是标准 Maps JavaScript API,则必须将 key 参数搭配有效的 API 密钥使用。如果您是 Premium Plan 客户,则必须将 client 参数搭配您的客户端 ID 使用,或将 key 参数搭配有效的 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 警告

您可能已经在 client 参数中提供了一个加密密钥。如果您有 Premium Plan 或 Maps APIs for Work 许可证,请以 client 参数形式指定您的客户端 ID。您不需要为您的 Google Maps JavaScript API 使用您的加密密钥。

请参阅适用于 Premium Plan 和 Maps APIs for Work 客户的客户端 ID 指南。

ClientIdLooksLikeKey 警告

您可能已经在 client 参数中提供了一个 API 密钥。如果您有 Premium Plan 或 Maps APIs for Work 许可证,请以 client 参数形式指定您的客户端 ID。如果您有 Google Maps APIs Premium Plan,可以使用 client 参数或 key 参数。如果您没有任何许可证,则必须使用 key 参数,而非 client 参数。

请参阅客户端 ID 和 API 密钥指南。

InvalidChannel 警告

您提供的 channel 参数可能无效。该参数必须是一个 ASCII 字母数字字符串,其中可包含点号 (.)、下划线 (_) 和连字号 (-)。请确保您指定的 channel 参数有效。

请参阅报告 | Google Maps APIs Premium Plan

InvalidClientId 警告

client 参数包含的客户端 ID 似乎不正确。客户端 ID 应以“gme-”开头。

请参阅适用于 Premium Plan 或 Maps APIs for Work 客户的客户端 ID 指南。

InvalidKey 警告

用于加载 API 的脚本元素中包含的 API 密钥似乎不正确。请确保您使用的 API 密钥正确。您可以在 Google API Console 上生成新的 API 密钥。

请参阅获取 API 密钥

InvalidVersion 警告

您在脚本元素中提供的版本号可能不正确。请确保您使用的版本号正确。

请参阅版本控制 | Google Maps JavaScript API

KeyLooksLikeClientId 警告 您可能已经以 key 参数形式提供了一个客户端 ID。如果您有 Premium Plan 或 Maps APIs for Work 许可证,请以 client 参数(而非 key 参数)形式指定您的客户端 ID。如果您有 Google Maps APIs Premium Plan,可以使用 client 参数或 key 参数。如果您没有任何许可证,则必须使用 key 参数,而非 client 参数。

请参阅客户端 ID 和 API 密钥指南。

KeyLooksLikeCryptoKey 警告

您可能已经以 key 参数形式提供了一个加密密钥。如果您有 Premium Plan 或 Maps APIs for Work 许可证,请以 client 参数形式指定您的客户端 ID,并从脚本元素中移除 key 参数。Google Maps JavaScript API 不需要加密密钥。如果您有 Google Maps APIs Premium Plan,可以使用 client 参数或 key 参数。如果您没有任何许可证,您可以从 Google API Console 获取一个免费的 API 密钥。

请参阅客户端 ID 和 API 密钥指南。

KeyLooksLikeProjectNumber 警告

您可能已经以 key 参数形式提供了一个项目编号。请确保您使用的 API 密钥正确。您可以在 Google API Console 上生成新的 API 密钥。

请参阅获取 API 密钥

NoApiKeys 警告

加载 API 的脚本元素不包含任何 API 密钥。请确保您以 key 参数形式加入的 API 密钥有效。您可以在 Google API Console 上生成新的 API 密钥。

请参阅获取 API 密钥

RetiredVersion 警告

您在脚本元素中提供的版本可能已经退役。版本 3.0 - 3.24 已经退役,您可能会收到 3.25。请更新您的应用以使用一个可用版本。

请参阅版本控制 | Google Maps JavaScript API

SensorNotRequired 警告

Google Maps JavaScript API 不再需要 sensor 参数。sensor 参数不会妨碍 Google Maps JavaScript API 正常工作,不过我们还是建议您从脚本元素中删除它。

SignatureNotRequired 警告

Google Maps JavaScript API 不需要 signature 参数。虽然它不会妨碍 Google Maps JavaScript API 正常工作,但可能会引入安全风险。请从您的脚本元素中删除它。

SignedInDeprecated 警告

signed_in 参数已弃用,将在 Google Maps JavaScript API 的未来版本中被忽略。已登录模式退役后它并不会阻止 Google Maps JavaScript API 发挥作用,但如果您依赖现有已登录功能,应用的行为可能会发生变化。

请检查您的应用,并参阅已登录地图 | Google Maps JavaScript API,详细了解即将到来的变更的相关信息。

UrlAuthenticationCommonError 错误

发生了不归属此页面上其他类别的错误。这可能是由临时问题所致。请稍等片刻后重试请求。如果这不能解决问题,请查阅开发者指南,确保请求的格式正确。

在浏览器中检查错误

Google Maps JavaScript API 会向 window.console 写入错误消息。此部分说明如何在 Google Chrome 中检查 window.console 输出。如果您使用的是任何其他浏览器,请查阅您的浏览器的开发者文档。以下列出了在一些其他浏览器中用于检查 window.console 输出的工具供您参考。

在 Chrome 中,可以使用 JavaScript 控制台按以下步骤检查 window.console 输出。

  1. 要打开开发者工具,选择菜单图标 > More Tools > Developer Tools。
  2. 要打开 JavaScript 控制台,按键盘上的 ESC 键。ESC 键用于开关 JavaScript 控制台。如果关闭了控制台,再次按 ESC 键可将其打开。

如果加载 Google Maps JavaScript API 时发生任何错误或警告,它们会以一行或多行形式出现在控制台中。错误或警告消息的格式如下:

Google Maps API 错误:[错误代码] [API 文档链接]

Google Maps API 警告:[错误代码] [API 文档链接]

可以通过查看上面的错误代码表找到错误消息中的错误代码。还可以在错误消息链接的 API 文档中找到有关该消息的详情。

:可以通过编程方式侦听身份验证错误

发送以下问题的反馈:

此网页
Google Maps JavaScript API
Google Maps JavaScript API
需要帮助?请访问我们的支持页面