Maps Static API может выдать ошибку или предупреждение, если что-то пойдет не так. В этом руководстве объясняется каждое сообщение об ошибке и предоставляются дополнительные инструкции по устранению ошибок.
Неверные запросы
В случае недопустимого запроса Maps Static API возвращает код состояния HTTP 4xx и сообщение с описанием проблемы. Ниже приведены примеры таких ошибок. Примечание. Это не полный список возможных ошибок. Пожалуйста, проверьте фактический код ошибки и сообщение, возвращаемое API, для получения подробной информации о конкретных проблемах.
| Пример состояния ошибки | Код состояния |
|---|---|
Запрос содержит недопустимый параметр или отсутствует обязательный параметр. Например, параметр size находится за пределами ожидаемого диапазона числовых значений или отсутствует в запросе. | 400 BAD REQUEST |
| Ключ API, включенный в запрос, недействителен. | 403 FORBIDDEN |
Ошибки, из-за которых карта не отображается
Если запрос действителен, но возникает другая ошибка, из-за которой карта не отображается, Maps Static API возвращает либо текст, либо изображение ошибки вместо карты, в зависимости от ошибки. Примером такой ошибки является ситуация, когда приложение превышает ограничения на использование . 
Ошибки, связанные с ключами API и биллингом
Если вы используете Maps Static API без ключа API или если в вашей учетной записи не включена оплата, на странице вместо карты отображается изображение ошибки со ссылкой, указывающей тип ошибки. Например, «g.co/staticmaperror/key».
| Бесключевые ошибки и решения | |
|---|---|
 | Вы используете Maps Static API без ключа API. Для решения необходимо: |
 | В вашем запросе отсутствует цифровая подпись (обязательно). Чтобы решить проблему, подпишите свой URL-адрес. |
Предупреждения
В случае некоторых ошибок API возвращает карту, но на карте может отсутствовать некоторая информация. В этом случае возникают два условия, информирующие вас о предупреждении.
- Во-первых, карта отображается, но с желтой полосой ошибок поверх карты и текстом «Ошибка карты: g.co/staticmaperror».
- Во-вторых, API возвращает предупреждение в виде HTTP-заголовка с именем
X-Staticmap-API-Warning.
Например, следующий URL-адрес содержит неожиданное значение параметра 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. Обратите внимание, что это ограничение применяется только к полилиниям, вершины которых указаны как удобочитаемые адреса, требующие геокодирования. Это не применяется к полилиниям, указанным в координатах широты и долготы. |
Вы можете увидеть предупреждения заголовков HTTP в консоли Chrome DevTools , веб-консоли Firefox или других аналогичных инструментах вашего браузера.
,Maps Static API может выдать ошибку или предупреждение, если что-то пойдет не так. В этом руководстве объясняется каждое сообщение об ошибке и предоставляются дополнительные инструкции по устранению ошибок.
Неверные запросы
В случае недопустимого запроса Maps Static API возвращает код состояния HTTP 4xx и сообщение с описанием проблемы. Ниже приведены примеры таких ошибок. Примечание. Это не полный список возможных ошибок. Пожалуйста, проверьте фактический код ошибки и сообщение, возвращаемое API, для получения подробной информации о конкретных проблемах.
| Пример состояния ошибки | Код состояния |
|---|---|
Запрос содержит недопустимый параметр или отсутствует обязательный параметр. Например, параметр size находится за пределами ожидаемого диапазона числовых значений или отсутствует в запросе. | 400 BAD REQUEST |
| Ключ API, включенный в запрос, недействителен. | 403 FORBIDDEN |
Ошибки, из-за которых карта не отображается
Если запрос действителен, но возникает другая ошибка, из-за которой карта не отображается, Maps Static API возвращает либо текст, либо изображение ошибки вместо карты, в зависимости от ошибки. Примером такой ошибки является ситуация, когда приложение превышает ограничения на использование .
Ошибки, связанные с ключами API и биллингом
Если вы используете Maps Static API без ключа API или если в вашей учетной записи не включена оплата, на странице вместо карты отображается изображение ошибки со ссылкой, указывающей тип ошибки. Например, «g.co/staticmaperror/key».
| Бесключевые ошибки и решения | |
|---|---|
| Вы используете Maps Static API без ключа API. Для решения необходимо: |
| В вашем запросе отсутствует цифровая подпись (обязательно). Чтобы решить проблему, подпишите свой URL-адрес. |
Предупреждения
В случае некоторых ошибок API возвращает карту, но на карте может отсутствовать некоторая информация. В этом случае возникают два условия, информирующие вас о предупреждении.
- Во-первых, карта отображается, но с желтой полосой ошибок поверх карты и текстом «Ошибка карты: g.co/staticmaperror».
- Во-вторых, API возвращает предупреждение в виде HTTP-заголовка с именем
X-Staticmap-API-Warning.
Например, следующий URL-адрес содержит неожиданное значение параметра 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. Обратите внимание, что это ограничение применяется только к полилиниям, вершины которых указаны как удобочитаемые адреса, требующие геокодирования. Это не применяется к полилиниям, указанным в координатах широты и долготы. |
Вы можете увидеть предупреждения заголовков HTTP в консоли Chrome DevTools , веб-консоли Firefox или других аналогичных инструментах вашего браузера.