Если запрос не удается выполнить, 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, ]* |
Ошибка возникла во время попытки геокодирования запроса. Существует множество вариантов этого сообщения в зависимости от элемента, для которого не удалось выполнить геокодирование (например, 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. Это ограничение применяется только к ломаным линиям с вершинами, заданными в виде адресов, которые требуют геокодирования. Это не относится к ломаным линиям, заданным с помощью координат широты и долготы. |
Предупреждения в заголовках HTTP можно посмотреть в консоли инструментов разработчика Chrome, веб-консоли Firefox или других аналогичных инструментах браузера.