Сообщения об ошибках в 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 Console , веб-консоли Firefox или других эквивалентных инструментах в вашем браузере.