На этой странице описаны сообщения об ошибках, которые может возвращать Maps Embed API. При возникновении ошибки Maps Embed API отображает текст сообщения об ошибке вместо карты. Также могут возникнуть определенные ошибки, которые приводят к отображению затемненной карты с водяными знаками.
Неверные запросы
В случае недопустимого запроса Maps Embed API возвращает код состояния HTTP 4xx и сообщение с описанием проблемы. Ниже приведены примеры таких ошибок. Примечание. Это не полный список возможных ошибок. Пожалуйста, проверьте фактический код ошибки и сообщение, возвращаемое API, для получения подробной информации о конкретных проблемах.
| Пример состояния ошибки | Код состояния |
|---|---|
Запрос содержит недопустимый параметр или отсутствует обязательный параметр. Например, параметр zoom находится за пределами ожидаемого диапазона числовых значений или в запросе отсутствует обязательный параметр. | 400 BAD REQUEST |
| Ключ API, включенный в запрос, недействителен. | 403 FORBIDDEN |
Ошибки ключа API и квоты
Ошибки ключа API и квоты рассматриваются как недействительные запросы. Возможные причины включают следующее:
- Ключ API отсутствует или недействителен. Чтобы устранить эту ошибку, убедитесь, что ваш запрос содержит действительный ключ API. Получите ключ API .
- Maps Embed API не включен для вашего проекта. Узнайте о включении и отключении API .
- Ключ API имеет нарушение ограничений. Узнайте больше о лучших практиках использования ключей API .
Ошибки выставления счетов и HTTP-реферера
Затемненная карта или «негативное» изображение Street View с водяным знаком  «только для целей разработки» возвращается, если выполняется любое из следующих условий:
- В вашем аккаунте не включена оплата. Включить биллинг .
- Указанный способ оплаты недействителен (например, срок действия кредитной карты истек). Чтобы решить эту проблему, посетите Google Cloud Console и убедитесь, что вы указали действительный способ оплаты.
- Превышен добровольный дневной лимит. Узнайте, как просмотреть или изменить лимиты дневной оплаты .
- В запросе отсутствует реферер HTTP, и вы используете ключ API, ограниченный реферером. Узнайте больше о добавлении рефералов .
Проверьте ошибки в вашем браузере
В случае ошибок выставления счетов и HTTP-реферера Maps Embed API записывает сообщения об ошибках в window.console . Для недействительных запросов (включая ошибки ключа API и квоты) в консоли отображается только код состояния HTTP 4xx . В этом разделе объясняется, как проверить вывод консоли в Google Chrome. Если вы используете другие браузеры, ознакомьтесь с документацией разработчика вашего браузера. Для справки, это список инструментов для проверки вывода консоли в некоторых других браузерах.
- Консоль для Internet Explorer.
- Веб-консоль для Firefox.
- Удаленная отладка для Android.
- Веб-инспектор для iOS.
В Chrome вы можете использовать консоль JavaScript для проверки вывода консоли следующим образом.
- Чтобы открыть инструменты разработчика, выберите значок меню > Дополнительные инструменты > Инструменты разработчика .
- Чтобы открыть консоль JavaScript, щелкните вкладку «Консоль» в верхней части окна «Инструменты разработчика». Вы также можете использовать клавишу ESC для переключения консоли JavaScript.