街景静态 API 中的错误消息

当请求失败时,Street View Static 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”。

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