Сообщения об ошибках в Maps Static API,Сообщения об ошибках в Maps Static API

Maps Static API может выдать ошибку или предупреждение, если что-то пойдет не так. В этом руководстве объясняется каждое сообщение об ошибке и предоставляются дополнительные инструкции по устранению ошибок.

Неверные запросы

В случае недопустимого запроса Maps Static API возвращает код состояния HTTP 4xx и сообщение с описанием проблемы. Ниже приведены примеры таких ошибок. Примечание. Это не полный список возможных ошибок. Пожалуйста, проверьте фактический код ошибки и сообщение, возвращаемое API, для получения подробной информации о конкретных проблемах.

Пример состояния ошибки Код состояния
Запрос содержит недопустимый параметр или отсутствует обязательный параметр. Например, параметр size находится за пределами ожидаемого диапазона числовых значений или отсутствует в запросе. 400 BAD REQUEST
Ключ API, включенный в запрос, недействителен. 403 FORBIDDEN

Ошибки, из-за которых карта не отображается

Если запрос действителен, но возникает другая ошибка, из-за которой карта не отображается, Maps Static API возвращает либо текст, либо изображение ошибки вместо карты, в зависимости от ошибки. Примером такой ошибки является ситуация, когда приложение превышает ограничения на использование .

Вместо карты отображается изображение ошибки
Рис.: Вместо карты отображается изображение ошибки.

Если вы используете Maps Static API без ключа API или если в вашей учетной записи не включена оплата, на странице вместо карты отображается изображение ошибки со ссылкой, указывающей тип ошибки. Например, «g.co/staticmaperror/key».

Бесключевые ошибки и решения
Ошибка лимитов использования: превышен предусмотренный ежедневный лимит загрузки карты. Вы используете Maps Static API без ключа API. Для решения необходимо:
  1. Получить ключ API
  2. Включить биллинг
  3. Подпишите свой URL
Ошибка ограничения использования: в URL-адресах запросов отсутствует цифровая подпись. В вашем запросе отсутствует цифровая подпись (обязательно). Чтобы решить проблему, подпишите свой 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»:

Карта отображается, но с ошибкой карты: 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 или других аналогичных инструментах вашего браузера.