街景静态 API 中的错误消息

当请求失败时，街景静态 API 会返回错误或警告。本指南介绍了出错提示，并提供了解决这些出错提示的说明。

无效请求

对于无效请求，Street View Static API 会返回 HTTP 4xx 状态代码和描述问题的消息。下表列出了此类错误情况的示例，但并未详尽列出所有可能的错误。您可以查看 API 返回的实际错误代码和消息，了解具体问题的详细信息。

错误状况示例 状态代码
请求包含无效参数，或缺少必需参数。例如，size 参数不在预期的数值范围内，或者请求中缺少该参数。 400 BAD REQUEST
请求中包括的 API 密钥无效。 403 FORBIDDEN

导致街景图片无法显示的错误

如果请求有效，但发生了其他错误，导致无法显示街景图像，则 Street View Static API 会根据错误返回文本或错误图片，而不是街景图像。此类错误条件的一个示例是应用超出其用量限额。

显示错误图片，而不是街景图像
图：显示错误图片，而不是街景图片

如果您在未使用 API 密钥的情况下使用 Street View Static API，或者您的账号未启用结算功能，则页面会显示错误图片（而非街景图片），并显示一个指示错误类型的链接。例如，“g.co/streetviewerror/key”。

Keyless 错误和解决方案
用量限额错误：超出了提供的每日地图加载次数限额 您正在使用街景静态 API，但没有 API 密钥。如需解决此错误，请完成以下步骤：
  1. 获取 API 密钥
  2. 启用结算功能
  3. 对网址进行签名
用量限额错误：请求网址缺少数字签名 您的请求缺少必需的数字签名。如需解决此错误，请 为网址签名。