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, ]* |
尝试对请求进行地理编码时出错。此消息有许多变体，具体取决于地理编码失败的元素（中心、标记、可见或路径）以及失败的元素数量。此警告的一个示例是 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 标头警告。