Сообщения об ошибках

На этой странице описаны сообщения об ошибках, которые может возвращать Maps Embed API. При возникновении ошибки Maps Embed API отображает текст сообщения об ошибке вместо карты. Также могут возникнуть определенные ошибки, которые приводят к отображению затемненной карты с водяными знаками.

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

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

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

Ошибки ключа API и QPS

Ошибки ключа API и QPS рассматриваются как недействительные запросы. Возможные причины включают следующее:

Ошибки выставления счетов и HTTP-реферера

Затемненная карта или «негативное» изображение Street View с водяным знаком  «только для целей разработки» возвращается, если выполняется любое из следующих условий:

Проверка ошибок в вашем браузере

В случае ошибок выставления счетов и HTTP-реферера Maps Embed API записывает сообщения об ошибках в window.console . Для недействительных запросов (включая ошибки ключа API и QPS) в консоли отображается только код состояния HTTP 4xx . В этом разделе объясняется, как проверить вывод консоли в Google Chrome. Если вы используете другие браузеры, ознакомьтесь с документацией разработчика вашего браузера. Для справки, это список инструментов для проверки вывода консоли в некоторых других браузерах.

В Chrome вы можете использовать консоль JavaScript для проверки вывода консоли следующим образом.

  1. Чтобы открыть инструменты разработчика, выберите значок меню > Дополнительные инструменты > Инструменты разработчика .
  2. Чтобы открыть консоль JavaScript, щелкните вкладку «Консоль» в верхней части окна «Инструменты разработчика». Вы также можете использовать клавишу ESC для переключения консоли JavaScript.