当请求失败时，Maps Static API 会发出错误或警告。 本指南将说明这些错误消息，并提供有关如何解决这些错误的说明。
无效请求
对于无效请求，Maps Static API 会返回 HTTP 4xx 状态代码和一条描述问题的消息，如下所示。请查看 API 返回的实际错误代码和消息，了解具体问题的详细信息。
- 请求包含无效的参数，或者缺少必需的参数。例如，
size参数不在预期的数值范围内，或者请求中缺少该参数。 400 BAD REQUEST- 请求中包括的 API 密钥无效。
403 FORBIDDEN
导致地图无法显示的错误
如果请求有效，但发生其他错误导致无法显示地图，则 Maps Static API 会返回文本或错误图片，而不是地图。例如，当应用超出其用量限额时，会发生错误。
与 API 密钥和结算相关的错误
如果您在未使用 API 密钥的情况下使用 Maps Static API，或者您的账号未启用结算功能，则页面会显示错误图片而不是地图，并提供一个指示错误类型的链接。例如，“g.co/staticmaperror/key”。
| 无钥匙错误和解决方案 | |
|---|---|
 |
您正在使用 Maps Static API，但未提供 API 密钥。如需解决此错误，请完成以下步骤： |
 |
您的请求缺少必需的数字签名。如需解决此错误，请 对您的网址进行签名。 |
警告
对于某些错误情况，API 会返回地图，但地图中可能会缺少某些信息。发生这种情况时，您可以使用以下条件来识别警告：
- 地图上叠加显示一个黄色错误栏，其中包含“地图错误：g.co/staticmaperror”字样。
- 该 API 会以名为
X-Staticmap-API-Warning的 HTTP 标头的形式返回警告。
例如，以下网址的 markers 参数中包含意外值：
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
API 返回地图，但显示一个叠加在图片上的黄色错误栏，其中包含“地图错误：g.co/staticmaperror”字样：
API 也会返回以下 HTTP 标头：
X-Staticmap-API-Warning:Error geocoding: marker 1
下表介绍了 API 可以作为 HTTP 标头发出的警告：
X-Staticmap-API-Warning 标头中的警告
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
尝试对请求进行地理编码时出错。此消息有多种变体，具体取决于地理编码失败的元素（例如 center、marker、visible 或 path）以及失败元素的数量。此警告的一个示例是 X-Staticmap-API-Warning:Error geocoding: marker 1，如上例所示。 |
Too many geocoded markers requested (max is 15). |
相应请求指定了超出允许的最大数量的具有人类可读地址的标记。最大值为 15。此限制仅适用于指定为直观易懂的地址且需要进行地理编码的标记。它不适用于使用纬度和经度坐标指定的标记。 |
Too many geocoded polyline vertices requested (max is 15). |
相应请求指定了超出允许上限的折线数，且包含人类可读的地址。最大值为 15。此限制仅适用于顶点指定为直观易懂的地址（需要进行地理编码）的多段线。不适用于使用纬度和经度坐标指定的多段线。 |
您可以在 Chrome 开发者工具控制台、Firefox Web 控制台或浏览器中的其他同类工具中查看 HTTP 标头警告。