На этой странице описаны сообщения об ошибках, возвращаемые 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-источником ссылки
Затемненная карта или негативное изображение Просмотра улиц с водяным знаком "for development purposes only" (только для целей разработки) возвращается, если выполняется любое из следующих условий:
- В вашем аккаунте не включены платежные функции. Включите оплату.
- Указанный способ оплаты недействителен (например, истек срок действия кредитной карты). Чтобы устранить эту проблему, перейдите в консоль Google Cloud и убедитесь, что вы указали действительный способ оплаты.
- Превышено заданное ограничение на использование. Подробнее о том, как посмотреть или изменить дневные лимиты на оплату…
- В запросе отсутствует заголовок HTTP referer, а вы используете ключ API с ограничением по заголовку HTTP referer. Подробнее о добавлении источников перехода…
Проверьте, нет ли ошибок в вашем браузере
Сообщения об ошибках, связанных с оплатой и заголовком HTTP referer, Maps Embed API записывает в window.console. Для недействительных запросов (включая ошибки ключа API и квоты) в консоли регистрируется только код статуса HTTP 4xx. В этом разделе мы рассказываем, как проверить выходные данные консоли в Google Chrome. Если вы используете другой браузер, обратитесь к его документации для разработчиков. Ниже даны ссылки на инструменты, с помощью которых можно проверить выходные данные консоли в некоторых других браузерах:
Вот как использовать консоль JavaScript для проверки выходных данных в Chrome:
- Откройте инструменты разработчика (нажмите на значок меню > Другие инструменты > Инструменты разработчика).
- Чтобы открыть консоль JavaScript, нажмите на вкладку Console (Консоль) в верхней части окна инструментов разработчика. Вы также можете использовать клавишу Esc для переключения в режим консоли JavaScript.