错误消息

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

本页面介绍了 Maps JavaScript API 可能会返回的错误消息。Maps JavaScript API 将错误和警告消息写入 JavaScript 控制台。系统也可能会发生某些错误情况,从而导致水印变暗。

API 密钥和结算错误

问题排查

在某些情况下,可能会显示暗色地图或“负面”街景图片,并带有“仅用于开发目的”的文字水印。如果出现此行为,通常说明存在 API 密钥或结算方面的问题。要使用 Google Maps Platform 产品,您必须为帐号启用结算功能,并且所有请求都必须包含有效的 API 密钥。如需有关如何查找错误消息的帮助,请参阅在浏览器中检查错误部分。

以下流程可帮助您排查问题。

面向开发者和网站所有者的 Maps JavaScript API 错误代码

下表列出了 Maps JavaScript API 可能返回的错误代码,以及相关原因以及如何解决问题。 如需有关如何查找错误消息的帮助,请参阅在浏览器中检查错误部分。

地图加载错误

如果您在加载 Maps JavaScript API 时遇到错误,请参阅下表,找到对错误代码的说明。

错误代码 消息 说明
NotLoadingAPIFromGoogleMapsError 必须直接从 Google 的服务器下载 Maps JavaScript API。

您的页面上未正确添加用于加载 Maps JavaScript API 的脚本元素。为使该 API 正常工作,必须直接从 https://maps.googleapis.com 加载它。

请参阅加载 Maps JavaScript API

TOSViolationMapError 此网站似乎违反了 Google Maps API 服务条款。 The Google Maps API has been disabled for this website.

由于多次电子邮件通知,您的应用违反了 Google Maps Platform 服务条款,因此已被屏蔽。如需对该屏蔽设置提出申诉并让我们审核您的实施情况,请填写此表单。您会在几个工作日内通过电子邮件收到回复。

如果您有 Google Maps Platform 高级计划许可,请使用您的 Google Maps Platform 高级计划凭据来解决此错误。请参阅有关高级计划身份验证的指南。

UnauthorizedURLForClientIdMapError 此网址未获得使用所提供的 Google 地图客户端 ID 的授权。

脚本加载中包含的高级计划或 Maps API for Work 客户端 ID 无效、已过期,或者加载 Maps JavaScript API 的当前地址尚未添加到已获授权的网址列表中。

请参阅注册授权网址

Maps JavaScript API 错误代码

如果您发现 Chrome JavaScript 控制台Firefox Web 控制台或浏览器上的任何其他等效工具出现错误,请参阅下表,了解错误代码说明。

Maps JavaScript API 会返回错误和警告。 错误表示加载 Maps JavaScript API 时发生严重问题。您的网页无法正确加载 API,因此该 API 无法在该网页上正常运行。 警告是有关 Maps JavaScript API 加载情况的补充消息。该警告会说明可能出现的错误原因,或指出加载 Maps JavaScript API 的代码存在潜在问题。 如果您只收到警告而没有收到任何错误,该 API 将可以在该页面上正常工作。不过,我们还是建议您解决这些问题。

开发者错误代码 类型 说明
ApiNotActivatedMapError 错误

您的 API 项目中未激活 Maps JavaScript API。 您可能需要在 Google Cloud Console 中的 API 下启用 Maps JavaScript API。

如需为您的项目激活 Maps JavaScript API,请点击下面的按钮。
了解具体方法

ApiTargetBlockedMapError 错误

此 API 密钥无权使用此服务或 API。请在 Google Cloud Console 中检查 API 密钥的 API 限制设置,以确保在已启用的 API 列表中正确指定了您需要使用的所有 API 和服务。

请参阅 Cloud Console 中的 API 密钥。如需了解详情,请参阅 API 安全性最佳做法

DeletedApiProjectMapError 错误

您的 API 项目可能已从 Cloud Console 中删除。请检查您为其生成 API 密钥的项目(包含在 JavaScript API 加载器中)。您可以在 Cloud Console 中创建新的 API 项目并获取新密钥。

如需创建新项目并获取项目的 API 密钥,请点击下面的按钮。
了解具体方法

ClientBillingNotEnabledMapError 错误

您尚未为项目启用结算功能。您必须在此处为与此客户端 ID 关联的 Google Cloud 项目启用结算功能。

BillingNotEnabledMapError 错误

您尚未为项目启用结算功能,导致此错误。 您必须在此处为 Google Cloud 项目启用结算功能。

了解详情

ExpiredKeyMapError 错误

用于加载 API 的脚本元素中包含的 API 密钥已过期或系统无法识别。如果您在创建新的 API 密钥并尝试在系统识别之前使用该密钥,则可能会遇到此错误。请等待几分钟,然后重试,或者您可能需要在 Cloud Console 中生成新的 API 密钥。

如需获取 API 密钥,请点击下方的按钮。
开始使用

InvalidClientIdMapError 错误

用于加载 API 的脚本元素中包含的客户端 ID 无效或已过期。请确保您正确使用了客户端 ID。客户端 ID 应以“gme-”前缀开头。如果正确使用客户端 ID 后仍然出现此错误,则说明客户端 ID 可能已过期。请与您的 Google 客户经理联系。

如果您没有高级计划许可或 Maps API for Work 许可,则需要将 key 参数与 API 密钥一起使用,而不是使用 client 参数。

请参阅有关高级计划身份验证的指南。

InvalidKeyMapError 错误

找不到加载 API 的脚本元素中包含的 API 密钥。请确保您使用的是正确的 API 密钥。您可以在 Cloud Console 中生成新的 API 密钥。

如需获取 API 密钥,请点击下方的按钮。
开始使用

MalformedCredentialsMapError 错误

您的应用使用了不受支持的 URI 架构。验证应用是否使用 RFC 3986 中定义的有效 URI 格式。

MissingKeyMapError 错误

加载 API 的脚本元素缺少必需的身份验证参数。

如果您使用的是标准 Maps JavaScript API,则必须将 key 参数与有效的 API 密钥结合使用。如需了解详情,请参阅 Google Maps Platform 使用入门

如果您是高级计划客户,则必须将 client 参数与您的客户端 ID 搭配使用,或将 key 参数与有效的 API 密钥搭配使用。如需了解详情,请参阅有关 API 密钥和客户端 ID 的指南。

如果您不是网站所有者,则无法采取任何措施来修复此错误。不过,如果可能的话,您最好通知网站所有者。

ProjectDeniedMapError 错误

您的请求尚未完成。您或许可以在 Cloud Console 中找到有关该错误的更多详细信息。

请参阅 Cloud Console

RefererDeniedMapError 错误

由于多次电子邮件通知,您的应用违反了 Google Maps Platform 服务条款,因此已被屏蔽。如需对该屏蔽设置提出申诉并让我们审核您的实施情况,请填写此表单。您会在几个工作日内通过电子邮件收到回复。

RefererNotAllowedMapError 错误

加载 Maps JavaScript API 的当前网址尚未添加到允许的引荐来源网址列表中。请在 Cloud Console 中检查 API 密钥的引荐来源网址设置。

请参阅 Maps JavaScript API 和获取 API 密钥

OverQuotaMapError 错误

请求数量已超过 Maps JavaScript API 的使用限制。应用的请求将在下一次每日配额重置后再次发挥作用。

如果您不是网站所有者,则无法采取任何措施来修复此错误。不过,如果可能的话,您最好通知网站所有者。

如需了解详情,请参阅使用限制指南。本页面还介绍了如何获得更高的用量限额。

ApiProjectMapError 错误

提供的 API 密钥或与其关联的 API 项目无法解析。此错误可能是暂时性的。如果此错误消息持续出现,您可能需要获取新的 API 密钥或创建新的 API 项目。

如需了解详情,请参阅 Google Maps Platform 使用入门

ClientIdLooksLikeCryptoKey 警告

您可能已经在 client 参数中提供了加密密钥。如果您有高级计划许可或 Maps API for Work 许可,请将您的客户端 ID 指定为 client 参数。对于 Maps JavaScript API,您无需使用加密密钥。

请参阅有关高级计划和 Maps API for Work 客户的客户端 ID 的指南。

ClientIdLooksLikeKey 警告

您可能已经在 client 参数中提供了一个 API 密钥。如果您有高级计划许可或 Maps API for Work 许可,请将您的客户端 ID 指定为 client 参数。如果您有 Google Maps Platform 高级计划,则可以使用 client 参数或 key 参数。如果您没有任何许可,则必须使用 key 参数,而不是 client 参数。

请参阅有关高级计划身份验证的指南。

InvalidChannel 警告

您提供的 channel 参数可能无效。渠道必须是 ASCII 字母数字字符串,可能包含英文句点 (.)、下划线 (_) 和连字符 (-)。请确保您指定的是有效的 channel 参数。

请参阅报告 | Google Maps Platform 高级计划

InvalidClientId 警告

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

请参阅有关高级计划身份验证的指南。

InvalidKey 警告

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

如需获取 API 密钥,请点击下方的按钮。
开始使用

InvalidVersion 警告

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

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

KeyLooksLikeClientId 警告 您可能已经以 key 参数的形式提供了一个客户端 ID。如果您有高级计划许可或 Maps API for Work 许可,请将您的客户端 ID 指定为 client 参数,而不是 key 参数。如果您有 Google Maps Platform 高级计划,则可以使用 client 参数或 key 参数。如果您没有任何许可,则必须使用 key 参数,而不是 client 参数。

请参阅有关高级计划身份验证的指南。

KeyLooksLikeCryptoKey 警告

您可能已经提供了加密密钥或签名密钥作为 key 参数。如果您有高级计划许可或 Maps API for Work 许可,请将您的客户端 ID 指定为 client 参数,并从脚本元素中移除 key 参数。Maps JavaScript API 不需要加密密钥。如果您有 Google Maps Platform 高级计划,则可以使用 client 参数或 key 参数。如果您没有任何许可,则可以在 Cloud Console 中获取 API 密钥。

请参阅有关在加载 API 时指定客户端 ID 的指南。

KeyLooksLikeProjectNumber 警告

您可能已经提供了项目编号作为 key 参数。请确保您使用的是正确的 API 密钥。您可以在 Cloud Console 中生成新的 API 密钥。

了解如何获取 API 密钥。

NoApiKeys 警告

加载 API 的脚本元素没有 API 密钥。请务必添加有效的 API 密钥作为 key 参数。您可以在 Cloud Console 中生成新的 API 密钥。

如需获取 API 密钥,请点击下方的按钮开始使用。
开始使用

如果您是从已弃用的 v2 路径加载 Maps JavaScript API,则会收到 NoApiKeys 警告,即使您指定了 key 参数也是如此。请查看 v2 到 v3 升级指南,并将您的应用迁移到 Maps JavaScript API v3。

RetiredVersion 警告

您可能在脚本元素中提供了一个退役版本。 请更新您的应用,使用其中一个可用版本。

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

SensorNotRequired 警告

Maps JavaScript API 不再需要 sensor 参数。这不会阻止 Maps JavaScript API 正常工作,但我们建议您从脚本元素中移除 sensor 参数。

SignatureNotRequired 警告

Maps JavaScript API 不需要 signature 参数。这不会阻止 Maps JavaScript API 正常运行,但可能会带来安全风险。请将其从脚本元素中移除。

SignedInNotSupported 警告

signed_in 参数已被弃用,您使用的 Maps JavaScript API 版本不支持该参数。这不会阻止 Maps JavaScript API 正常运行,但如果您依靠已登录的功能,应用的行为可能会发生变化。

UrlAuthenticationCommonError 错误

出现错误,该错误不属于此页面的其他类别。这可能是由暂时性问题导致的。请稍等片刻后重试请求。如果这无法解决问题,请参阅开发者指南,确保请求的格式正确无误。

在浏览器中检查错误

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

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

  1. 如需打开开发者工具,请依次选择菜单图标 > 更多工具 > 开发者工具。
  2. 如需打开 JavaScript 控制台,请按键盘上的 Esc 键。 按 ESC 键可切换 JavaScript 控制台。如果您关闭控制台,请再次按 ESC 键将其打开。

如果在加载 Maps JavaScript API 时发生任何错误或警告,这些错误或警告会在控制台中显示为一行或多行。 错误或警告消息采用以下格式:

Google Maps API error: [ERROR CODE] [Link to API document]

Google Maps API warning: [ERROR CODE] [Link to API document]

您可以查看上面的错误代码表,找到错误消息中的错误代码。您还可以在错误消息链接的 API 文档中找到有关错误消息的详细信息。

注意:您可以通过编程方式监听身份验证错误

处理不受支持的浏览器

确保 Maps JavaScript API 目前支持您使用的浏览器版本。

  • 如果您使用的是 Internet Explorer (IE),请升级至最新版 IE。鉴于不再支持较旧的 IE 版本,您还可以考虑使用 Maps JavaScript API 支持的备用浏览器
  • 如果您使用 Maps JavaScript API 支持的 Internet Explorer 版本在 WebView 中运行原生 Windows 应用,很可能是因为您的浏览器默认恢复到使用 Internet Explorer 7 的模式。您可以通过以下方式替换此默认行为:
    • 使用 IE X-UA-Compatible 元标头指定旧版文档模式(推荐解决方法)。
      <meta http-equiv="x-ua-compatible" content="IE=edge">
    • 更新注册表,以使用应用专用的 FEATURE_BROWSER_EMULATION 注册表项。

如果您的代码仍然无效

为帮助您让地图代码正常运行,Brendan Kenny 和 Mano Marks 在此视频中指出了一些常见错误及其解决方法。

  • 查找拼写错误。请注意,JavaScript 区分大小写。
  • 检查基本情况 - 一些最常见的问题都发生在初始地图创建中。例如:
    • 请确认您已经在地图选项中指定了 zoomcenter 属性。
    • 确保您已声明一个 div 元素,此地图将在屏幕上显示。
    • 确保地图的div元素具有高度。默认情况下,您创建的 div 元素的高度为 0,因此不可见。
    请参阅我们的示例,了解参考实现
  • 使用 JavaScript 调试程序(例如 Chrome 开发者工具中的调试程序)来帮助发现问题。首先在 JavaScript 控制台中查找错误。
  • 请将问题发布到 Stack Overflow 上。有关如何发布优质问题的指南,请参阅支持页面。