当请求失败时,Street View Static API 会返回错误或警告。 本指南将说明这些错误消息,并提供有关如何解决这些错误的说明。
无效请求
对于无效请求,Street View Static API 会返回 HTTP 4xx 状态代码以及描述问题的消息。下表列出了此类错误情况的示例,但并未详尽列出所有可能的错误。您可以查看 API 返回的实际错误代码和消息,了解具体问题的详细信息。
| 错误状况示例 | 状态代码 |
|---|---|
请求包含无效参数,或缺少必需参数。例如,size 参数不在预期的数值范围内,或者请求中缺少该参数。 |
400 BAD REQUEST |
| 请求中包括的 API 密钥无效。 | 403 FORBIDDEN |
导致街景图像无法显示的错误
如果请求有效,但发生其他错误导致无法显示街景图片,Street View Static API 会返回文本或错误图片(而非街景图片),具体取决于错误类型。此类错误情况的一个示例是应用超出其使用限制。
与 API 密钥和结算相关的错误
如果您在未使用 API 密钥的情况下使用 Street View Static API,或者您的账号未启用结算功能,则网页会显示错误图片,而不是街景图片,并提供一个指示错误类型的链接。例如,“g.co/streetviewerror/key”。
| 无钥匙错误和解决方案 | |
|---|---|
![]() |
您正在使用街景静态 API,但未提供 API 密钥。如需解决此错误,请完成以下步骤: |
![]() |
您的请求缺少必需的数字签名。如需解决此错误,请 对您的网址进行签名。 |

