发出请求后，您可能会收到包含错误详细信息的响应。
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 坐标范围与常规地图图块的范围相同，最大缩放级别为 5。在缩放级别为 5 时，最大值为
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 支持团队联系，申请提高配额。