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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Ключ API и ошибки выставления счетов

Исправление проблем

При определенных обстоятельствах может отображаться затемненная карта или «негативное» изображение Street View с водяным знаком с текстом «только для целей разработки». Такое поведение обычно указывает на проблемы с ключом API или выставлением счетов. Чтобы использовать продукты платформы Google Карт, в вашей учетной записи должно быть включено выставление счетов, а все запросы должны включать действительный ключ API. Справку по поиску сообщений об ошибках см. в разделе о проверке ошибок в браузере .

Следующий алгоритм поможет вам устранить проблему.

Коды ошибок API JavaScript Maps для разработчиков и владельцев сайтов

В следующих таблицах перечислены возможные коды ошибок, возвращаемые Maps JavaScript API, с описанием причин и способов устранения проблемы. Справку по поиску сообщений об ошибках см. в разделе, посвященном проверке ошибок в браузере .

Ошибки загрузки карты

Если вы столкнулись с ошибкой при загрузке Maps JavaScript API, см. приведенную ниже таблицу, чтобы найти пояснения к кодам ошибок.

Код ошибки Сообщение Описание
NotLoadingAPIFromGoogleMapsError Maps JavaScript API необходимо загружать непосредственно с серверов Google.

Элемент скрипта, который загружает Maps JavaScript API, неправильно добавлен на вашу страницу. Для корректной работы API его необходимо загрузить напрямую с https://maps.googleapis.com.

См. Загрузка Maps JavaScript API .

TOSViolationMapError Этот веб-сайт нарушает Условия использования Google Maps API. API Google Maps отключен для этого веб-сайта.

Ваше приложение было заблокировано за несоблюдение Условий использования платформы Google Карт после нескольких уведомлений по электронной почте. Чтобы подать апелляцию на блокировку и проверить вашу реализацию, заполните эту форму . Вы получите ответ по электронной почте в течение нескольких рабочих дней.

Если у вас есть лицензия на план "Премиум" для платформы Google Карт, используйте свои учетные данные для плана "Премиум" для платформы Google Карт, чтобы устранить эту ошибку. См. руководство по аутентификации на Премиум-плане .

UnauthorizedURLForClientIdMapError Этот URL не авторизован для использования предоставленного идентификатора клиента Google Maps.

Идентификатор клиента Premium Plan или Maps APIs for Work, включенный в загрузку скрипта, недействителен, просрочен или текущий адрес, загружающий Maps JavaScript API, не был добавлен в список авторизованных URL-адресов.

См. раздел Регистрация авторизованных URL-адресов .

Коды ошибок JavaScript API Карт

Если вы обнаружите ошибку в консоли Chrome JavaScript , веб-консоли Firefox или любых других аналогичных инструментах в ваших браузерах, см. таблицу ниже, чтобы найти пояснения к кодам ошибок.

Maps JavaScript API возвращает как ошибки, так и предупреждения. Ошибка указывает на серьезную проблему, возникшую при загрузке Maps JavaScript API. Ваша страница не может правильно загрузить API, и API не будет работать на этой странице. Предупреждение – это дополнительное сообщение о загрузке Maps JavaScript API. В предупреждении описываются возможные причины ошибки или предлагаются возможные проблемы в вашем коде, который загружает Maps JavaScript API. Если вы получаете только предупреждения без каких-либо ошибок, API будет работать правильно на этой странице. Тем не менее, мы рекомендуем вам исправить и эти потенциальные проблемы.

Код ошибки разработчика Тип Описание
ApiNotActivatedMapError Ошибка

Maps JavaScript API не активирован в вашем проекте API. Возможно, вам потребуется включить Maps JavaScript API в разделе API в Google Cloud Console.

Чтобы активировать Maps JavaScript API для своего проекта, нажмите кнопку ниже.
Узнать, как

ApiTargetBlockedMapError Ошибка

Этот ключ API не авторизован для использования этой службы или API. Пожалуйста, проверьте настройки ограничений API вашего ключа API в Google Cloud Console, чтобы убедиться, что все API и сервисы, которые вам нужно использовать, правильно указаны в списке включенных API.

См. ключи API в Cloud Console . Дополнительные сведения см. в разделе Рекомендации по безопасности API .

DeletedApiProjectMapError Ошибка

Возможно, ваш проект API был удален из Cloud Console. Пожалуйста, проверьте проект, для которого вы сгенерировали ключ API, включенный в загрузчик JavaScript API. Вы можете создать новый проект API и получить новый ключ в Cloud Console.

Чтобы создать новый проект и получить ключ API для проекта, нажмите кнопку ниже.
Узнать, как

ClientBillingNotEnabledMapError Ошибка

Вы не включили выставление счетов в своем проекте. Вы должны включить выставление счетов в проекте Google Cloud, связанном с этим идентификатором клиента, здесь .

BillingNotEnabledMapError Ошибка

Вы не включили выставление счетов в своем проекте, что вызывает эту ошибку. Вы должны включить выставление счетов в Google Cloud Project здесь .

Учить больше

ExpiredKeyMapError Ошибка

Срок действия ключа API, включенного в элемент скрипта, который загружает API, истек или не распознается системой. Вы можете получить эту ошибку после создания нового ключа API, если попытаетесь использовать ключ до того, как он будет распознан системой. Подождите несколько минут и повторите попытку, иначе вам может потребоваться сгенерировать новый ключ API в Cloud Console.

Чтобы получить ключ API, нажмите кнопку ниже.
Начать

InvalidClientIdMapError Ошибка

Идентификатор клиента, включенный в элемент скрипта, который загружает API, недействителен или просрочен. Убедитесь, что вы правильно используете идентификатор клиента. Идентификатор клиента должен начинаться с префикса «gme-». Если вы видите эту ошибку даже при правильном использовании идентификатора клиента, возможно, срок действия идентификатора клиента истек. Обратитесь к своему менеджеру аккаунта Google.

Если у вас нет плана Premium или лицензии Maps API for Work, вам необходимо использовать key параметр с вашим ключом API вместо параметра client .

См. руководство по аутентификации на Премиум-плане .

InvalidKeyMapError Ошибка

Ключ API, включенный в элемент скрипта, который загружает API, не найден. Пожалуйста, убедитесь, что вы используете правильный ключ API. Вы можете сгенерировать новый ключ API в Cloud Console.

Чтобы получить ключ API, нажмите кнопку ниже.
Начать

MalformedCredentialsMapError Ошибка

Ваше приложение использует неподдерживаемую схему URI. Убедитесь, что приложение использует допустимый формат URI, определенный в RFC 3986 .

MissingKeyMapError Ошибка

В элементе скрипта, который загружает API, отсутствует обязательный параметр аутентификации.

Если вы используете стандартный Maps JavaScript API, вы должны использовать key параметр с действительным ключом API. Дополнительную информацию см. в разделе Начало работы с платформой Google Maps .

Если вы являетесь клиентом Премиум-плана, вы должны использовать либо параметр client с вашим идентификатором клиента, либо параметр key с действительным ключом API. Дополнительные сведения см. в руководстве по ключам API и идентификаторам клиентов .

Если вы НЕ являетесь владельцем веб-сайта, вы не можете предпринять никаких действий, чтобы исправить эту ошибку. Тем не менее, вы можете захотеть уведомить владельца сайта, если это возможно.

ProjectDeniedMapError Ошибка

Ваш запрос не выполнен. Вы можете найти более подробную информацию об ошибке в Cloud Console.

См. Облачная консоль .

RefererDeniedMapError Ошибка

Ваше приложение было заблокировано за несоблюдение Условий использования платформы Google Карт после нескольких уведомлений по электронной почте. Чтобы подать апелляцию на блокировку и проверить вашу реализацию, заполните эту форму . Вы получите ответ по электронной почте в течение нескольких рабочих дней.

RefererNotAllowedMapError Ошибка

Текущий URL-адрес, загружающий Maps JavaScript API, не был добавлен в список разрешенных рефереров. Пожалуйста, проверьте настройки реферера вашего ключа API в Cloud Console.

Ознакомьтесь с API JavaScript Карт и получите ключ API .

OverQuotaMapError Ошибка

Количество запросов превысило ограничения на использование Maps JavaScript API. Запросы вашего приложения снова будут работать при следующем сбросе дневной квоты.

Если вы НЕ являетесь владельцем веб-сайта, вы не можете предпринять никаких действий, чтобы исправить эту ошибку. Тем не менее, вы можете уведомить владельца сайта, если это возможно.

Дополнительные сведения см. в руководстве по ограничениям использования . На странице также объясняется, как вы можете получить более высокие лимиты использования.

ApiProjectMapError Ошибка

Предоставленный ключ API или проект API, с которым он связан, не могут быть разрешены. Эта ошибка может быть временной. Если это сообщение об ошибке повторяется, вам может потребоваться получить новый ключ API или создать новый проект API.

Дополнительную информацию см. в разделе Начало работы с платформой Google Maps .

ClientIdLooksLikeCryptoKey Предупреждение

Возможно, вы указали криптографический ключ в параметре client . Если у вас есть план Premium или лицензия Maps API for Work, укажите идентификатор клиента в качестве параметра client . Вам не нужно использовать криптографический ключ для Maps JavaScript API.

См. руководство по идентификаторам клиентов для планов Premium и Maps API for Work.

ClientIdLooksLikeKey Предупреждение

Возможно, вы указали ключ API в параметре client . Если у вас есть план Premium или лицензия Maps API for Work, укажите идентификатор клиента в качестве параметра client . Если у вас есть план Premium платформы Google Карт, вы можете использовать параметр client или key параметр. Если у вас нет лицензий, вы должны использовать параметр key вместо параметра client .

См. руководство по аутентификации на Премиум-плане .

InvalidChannel Предупреждение

Возможно, вы указали недопустимый параметр channel . Канал должен быть буквенно-цифровой строкой ASCII, которая может включать точку (.), подчеркивание (_) и дефис (-). Убедитесь, что вы указываете допустимый параметр channel .

См. Отчетность | Премиум-план платформы Google Карт .

InvalidClientId Предупреждение

Параметр client не содержит правильного идентификатора клиента. Идентификатор клиента должен начинаться с «gme-».

См. руководство по аутентификации на Премиум-плане .

InvalidKey Предупреждение

Ключ API, включенный в элемент скрипта, который загружает API, выглядит некорректно. Пожалуйста, убедитесь, что вы используете правильный ключ API. Вы можете сгенерировать новый ключ API в Cloud Console.

Чтобы получить ключ API, нажмите кнопку ниже.
Начать

InvalidVersion Предупреждение

Возможно, вы указали неверный номер версии в элементе скрипта. Убедитесь, что вы используете правильный номер версии.

См. Управление версиями | API JavaScript для Карт Google .

KeyLooksLikeClientId Предупреждение Возможно, вы указали идентификатор клиента в качестве key параметра. Если у вас есть план Premium или лицензия Maps API for Work, укажите идентификатор клиента в качестве параметра client , а не key параметра. Если у вас есть план Premium платформы Google Карт, вы можете использовать параметр client или key параметр. Если у вас нет лицензий, вы должны использовать параметр key вместо параметра client .

См. руководство по аутентификации на Премиум-плане .

KeyLooksLikeCryptoKey Предупреждение

Возможно, вы указали криптографический ключ или секрет подписи в качестве параметра key . Если у вас есть план Premium или лицензия Maps API for Work, укажите свой идентификатор клиента в качестве параметра client и удалите key параметр из элемента script. Криптографический ключ не требуется для Maps JavaScript API. Если у вас есть план Premium платформы Google Карт, вы можете использовать параметр client или key параметр. Если у вас нет лицензий, вы можете получить ключ API в Cloud Console.

См. руководство по указанию идентификатора клиента при загрузке API .

KeyLooksLikeProjectNumber Предупреждение

Возможно, вы указали номер проекта в качестве key параметра. Пожалуйста, убедитесь, что вы используете правильный ключ API. Вы можете сгенерировать новый ключ API в Cloud Console.

Узнайте, как получить ключ API.

NoApiKeys Предупреждение

Элемент скрипта, который загружает API, не имеет ключа API. Убедитесь, что вы указали действительный ключ API в качестве key параметра. Вы можете сгенерировать новый ключ API в Cloud Console.

Чтобы получить ключ API, нажмите кнопку ниже, чтобы начать.
Начать

Если вы загружаете Maps JavaScript API из устаревшего пути v2, вы получите предупреждение NoApiKeys , даже если вы указали key параметр. Пожалуйста, ознакомьтесь с руководством по обновлению с версии v2 до версии 3 и перенесите свое приложение на Maps JavaScript API v3.

RetiredVersion Предупреждение

Возможно, вы указали устаревшую версию в своем элементе сценария. Обновите приложение, чтобы использовать одну из доступных версий.

См. Управление версиями | API JavaScript для Карт Google .

SensorNotRequired Предупреждение

Параметр sensor больше не требуется для Maps JavaScript API. Это не помешает корректной работе Maps JavaScript API, но мы рекомендуем вам удалить параметр sensor из элемента скрипта.

SignatureNotRequired Предупреждение

Параметр signature не требуется для Maps JavaScript API. Это не помешает корректной работе Maps JavaScript API, но может создать угрозу безопасности. Удалите его из элемента script.

SignedInNotSupported Предупреждение

Параметр signed_in устарел и не поддерживается в используемой вами версии Maps JavaScript API. Это не помешает работе Maps JavaScript API, но поведение вашего приложения может измениться, если вы полагаетесь на функции входа в систему.

UrlAuthenticationCommonError Ошибка

Произошла ошибка, которая не попадает в другие категории на этой странице. Это может быть вызвано временной проблемой. Повторите запрос после небольшой задержки. Если это не решит проблему, просмотрите руководство разработчика, чтобы убедиться, что запрос имеет правильный формат.

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

Maps JavaScript API записывает сообщения об ошибках в window.console . В этом разделе объясняется, как проверить вывод window.console в Google Chrome. Если вы используете какие-либо другие браузеры, ознакомьтесь с документацией разработчика для вашего браузера. Для справки, это список инструментов для проверки вывода window.console в некоторых других браузерах.

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

  1. Чтобы открыть Инструменты разработчика, выберите значок меню > Дополнительные инструменты > Инструменты разработчика.
  2. Чтобы открыть консоль JavaScript, нажмите клавишу ESC на клавиатуре. Клавиша ESC переключит консоль JavaScript. Если вы закрыли консоль, снова нажмите клавишу ESC, чтобы открыть ее.

Если при загрузке Maps JavaScript API возникают какие-либо ошибки или предупреждения, они отображаются в виде одной или нескольких строк в консоли. Сообщение об ошибке или предупреждение имеет следующий формат:

Google Maps API error: [ERROR CODE] [Link to API document]
или же
Google Maps API warning: [ERROR CODE] [Link to API document]

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

Примечание. Вы можете прослушивать ошибки проверки подлинности программно.

Работа с неподдерживаемыми браузерами

Убедитесь, что используемая вами версия браузера в настоящее время поддерживается Maps JavaScript API .

Если ваш код все еще не работает

Чтобы помочь вам настроить и запустить код карты, Брендан Кенни и Мано Маркс указывают на некоторые распространенные ошибки и способы их исправления в этом видео.

  • Ищите опечатки. Помните, что JavaScript — это язык, чувствительный к регистру.
  • Ознакомьтесь с основами — некоторые из наиболее распространенных проблем возникают при первоначальном создании карты. Такие как:
    • Убедитесь, что вы указали свойства zoom и center в параметрах карты.
    • Убедитесь, что вы объявили элемент div, в котором карта будет отображаться на экране.
    • Убедитесь, что элемент div для карты имеет высоту. По умолчанию элементы div создаются с нулевой высотой и поэтому невидимы.
    Обратитесь к нашим примерам для эталонной реализации .
  • Используйте отладчик JavaScript для выявления проблем, например тот, который доступен в инструментах разработчика Chrome . Начните с поиска ошибок в консоли JavaScript.
  • Публикуйте вопросы в Stack Overflow . Рекомендации о том, как публиковать хорошие вопросы, доступны на странице поддержки .