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