发出请求后，您可能会收到包含错误详细信息的响应。
2D 图块和街景图像
以下列表详细介绍了您在使用 2D 图块和街景图片时可能会遇到的错误。
错误列表
以下列表详细介绍了您在使用 Map Tiles API 时可能会遇到的错误。
required- 您的请求缺少网址参数。请注意，错误消息会指明缺少哪个参数。
notFound，invalid您的
x、y或z值超出范围。对于常规地图图块，最大缩放级别取决于具体地图图块以及您请求的地图选项。
对于常规地图图块，x 坐标必须在 [0, (2^zoom)-1] 范围内。
对于常规地图图块，y 坐标必须在 [0, (2^(zoom-1))-1] 范围内。
对于街景图块，缩放级别必须介于 0 到 5 之间（包括这两个数值）。
对于街景图块，x 坐标和 y 坐标范围与常规地图图块相同，直到第五级缩放。此时，最大值为
imageHeight或imagewidth除以tileHeight或tileWidth。
forbidden：请求缺少有效的 API 密钥。
expired- 您的
session令牌已过期。会话令牌自创建之日起有效期为两周。请注意，此政策可能会在不另行通知的情况下发生变化。如果您收到此错误，则必须获取新的会话令牌，如使用会话令牌中所述。 badRequest您的请求格式不正确。导致出现此问题的常见原因包括：
您指定了
terrain地图类型，但未添加roadmap图层。您为非路线图地图类型添加了
styles数组。您在街景元数据请求中发送了经纬度值和全景图片 ID。
quotaExceeded，rateLimitExceeded您的应用已超出其允许的配额，或超出了每秒允许的查询次数。
错误示例
{
"error": {
"code": 403,
"message": "The request is missing a valid API key.",
"errors": [
{
"message": "The request is missing a valid API key.",
"domain": "global",
"reason": "forbidden"
}
],
"status": "PERMISSION_DENIED"
}
}
重试请求
当请求因 quotaExceeded 和 rateLimitExceeded 而失败时，您应重试请求，以免由于许多客户端尝试快速重试请求而导致中断的请求或大规模失败请求泛滥 Google 服务器。这意味着，在重试请求时，请使用指数退避算法。指数退避算法会迫使您及时分散请求，以便服务器有时间进行恢复。
例如，如果请求失败，则在一秒后重试。但是，如果该尝试也失败，请在两秒钟后再次重试请求。如果该请求也失败，请在 4 秒后重试。因此，只需将每个后续请求之间的时间长度翻倍，即可有效地延长每个后续请求的间隔时间。
3D 图块
您可能不会明显发现 Google 服务器上出现的错误，因为您是通过负责处理服务器错误的渲染程序来访问逼真的图块。
功能块渲染程序错误
例如，当发生服务器错误时，CesiumJS 渲染程序通常会静默失败，这可能会导致崩溃、空白屏幕，甚至特定图块无法加载。
您用于调试服务器错误的技术取决于您使用的特定呈现程序。对于 CesiumJS 等基于浏览器的渲染程序，您可以使用大多数浏览器内置的工具检查网络流量。例如，您可以使用 Chrome 开发者工具。
常见错误
以下列表详细介绍了您可能会遇到的最常见错误。
- 400：参数无效
- API 密钥、查询参数、图块/图块集 ID 无效，或会话令牌已过期。
- 403：权限被拒
- 缺少 API 密钥、缺少 SSL 连接，或者您的 API 密钥尚未添加到 3D 图块的许可名单中。请与 Google 支持团队联系，提供您的项目 ID，以便将您添加到 Map Tiles API 的 3D 图块功能的许可名单中。
- 429：请求过多
- 您的配额已用尽。请与 Google 支持团队联系，申请提高配额。