На этой странице описаны сообщения об ошибках, возвращаемые Maps JavaScript API. Этот API записывает сообщения об ошибках и предупреждения в Консоль JavaScript. Некоторые ошибки могут приводить к показу затемненной карты с водяными знаками.
Ошибки, связанные с оплатой и ключом API
Как устранить
Иногда карты могут отображаться затемненными, а панорамы Просмотра улиц – в негативе, с водяными знаками с текстом "for development purposes only" (только для целей разработки). Чаще всего такая проблема связана с ключом API или оплатой. Сервисами платформы Google Карт можно пользоваться, только если в вашем аккаунте активированы платежные функции, а в запросах к API указан действительный ключ. Подробную информацию вы найдете в разделе Проверка ошибок в браузере.
Ниже приведена последовательность шагов, которая поможет вам выявить и решить проблему.
Коды ошибок Maps JavaScript API (для разработчиков и владельцев сайтов)
В следующей таблице приведен список кодов ошибок, которые возвращает Maps JavaScript API, с описанием их причины и способом устранения. Как посмотреть в браузере сообщения об ошибках…
Ошибки загрузки карты
В следующей таблице приведены коды ошибок Maps JavaScript API и пояснения к ним.
Код ошибки | Сообщение | Описание |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
Maps JavaScript API должен загружаться непосредственно с серверов Google. |
Элемент script, загружающий Maps JavaScript API, некорректно добавлен на страницу. Для корректной работы API должен загружаться непосредственно с сайта https://maps.googleapis.com. |
TOSViolationMapError
|
На этом сайте обнаружены нарушения Условий использования Google Maps API. Доступ к нашему API для этого сайта заблокирован. |
Ваше приложение было заблокировано из-за несоответствия Условиям использования платформы Google Карт после отправки нескольких уведомлений по эл. почте. Чтобы обжаловать блокировку и запросить проверку вашей реализации, заполните эту форму. Ответ будет предоставлен вам по эл. почте в течение нескольких рабочих дней. Если у вас есть лицензия Premium платформы Google Карт, то, чтобы исправить ошибку, достаточно указать данные этой лицензии. Подробнее… |
UnauthorizedURLForClientIdMapError
|
У этого URL нет права использовать указанный идентификатор клиента Google Карт. |
Идентификатор клиента с лицензией Premium или Maps APIs for Work, включенный в script, недействителен, просрочен или адрес для загрузки Maps JavaScript API не добавлен в список авторизованных URL-адресов. |
Коды ошибок Maps JavaScript API
Пояснения к ошибкам в Консоли JavaScript браузера Chrome, веб-консоли Firefox и других аналогичных инструментах браузера ищите в таблице ниже.
Maps JavaScript API возвращает как ошибки, так и предупреждения. Ошибка указывает на возникновение серьезной проблемы при загрузке Maps JavaScript API. Например, ошибка – это когда API не может быть корректно загружен на страницу и не работает на ней. Предупреждение – это дополнительная информация о загрузке Maps JavaScript API. Она описывает возможные причины ошибки или проблемы с кодом, который загружает Maps JavaScript API. Если вы получаете только предупреждения, но не сообщения об ошибках, API на странице будет работать. Тем не менее мы рекомендуем устранять и потенциальные проблемы.
Код ошибки для разработчика | Тип | Описание |
---|---|---|
ApiNotActivatedMapError
|
Ошибка |
Maps JavaScript API не активирован в вашем проекте. Возможно, требуется включить Maps JavaScript API в списке API в Cloud Console. Чтобы активировать Maps JavaScript API для своего проекта, нажмите кнопку ниже.
|
ApiTargetBlockedMapError
|
Ошибка |
Ключ API не авторизован для использования этой службы или API. Проверьте ограничения API для вашего ключа в Google Cloud Console, чтобы убедиться, что все API и сервисы, которые вам нужны, указаны в списке включенных API. Проверьте свои ключи API в Cloud Console и ознакомьтесь со статьей Рекомендации по обеспечению безопасности доступа к API. |
DeletedApiProjectMapError
|
Ошибка |
Возможно, ваш проект API удален из Cloud Console. Проверьте проект, для которого вы сгенерировали ключ API, указанный в загрузчике JavaScript API. Создать новый проект и получить новый ключ можно в Cloud Console. Для этого нажмите кнопку ниже.
|
ClientBillingNotEnabledMapError
|
Ошибка |
Вы не включили функции оплаты в своем проекте. Сделать это для проекта в Google Cloud, связанного с идентификатором клиента, можно здесь. |
BillingNotEnabledMapError
|
Ошибка |
Вы не включили функции оплаты в своем проекте. Сделать это для своего проекта в Google Cloud можно здесь. |
ExpiredKeyMapError
|
Ошибка |
Срок действия ключа API, включенного в элемент script, который загружает API, истек или не распознается системой. Создав новый ключ API, вы можете получить эту ошибку, если попытаетесь использовать ключ до того, как он будет распознан системой. Подождите несколько минут и повторите попытку, иначе может потребоваться сгенерировать новый ключ API в Cloud Console. Чтобы получить ключ API, нажмите кнопку ниже.
|
InvalidClientIdMapError
|
Ошибка |
Недопустимый идентификатор клиента в элементе script, который загружает API, или истекший срок действия идентификатора. Проверьте корректность использования своего ID клиента. Идентификатор клиента должен начинаться с префикса "gme-". Если эта ошибка возникает даже при правильном использовании ID клиента, возможно, срок действия этого идентификатора истек. Свяжитесь с вашим менеджером Google по работе с клиентами.
Если у вас нет лицензии Premium или Maps API for Work, используйте с вашим ключом API параметр |
InvalidKeyMapError
|
Ошибка |
Не найден ключ API в элементе script, загружающем API. Проверьте, используете ли вы правильный ключ API. Сгенерировать новый ключ API можно в Cloud Console. Чтобы получить ключ API, нажмите кнопку ниже.
|
MalformedCredentialsMapError
|
Ошибка |
Ваше приложение использует неподдерживаемую схему URI. Используйте допустимый формат URI, определенный в RFC 3986. |
MissingKeyMapError
|
Ошибка |
В элементе script, загружающем API, отсутствует обязательный параметр аутентификации. Если вы используете стандартный Maps JavaScript API, применяйте параметр Если у вас оформлена лицензия Premium, используйте параметр Вы не можете исправить такую ошибку, если НЕ являетесь владельцем сайта. Обнаружив ее, сообщите об этом владельцу. |
ProjectDeniedMapError
|
Ошибка |
Ваш запрос не выполнен. Более подробную информацию ищите в Cloud Console. |
RefererDeniedMapError
|
Ошибка |
Ваше приложение было заблокировано из-за несоответствия Условиям использования платформы Google Карт после отправки нескольких уведомлений по эл. почте. Чтобы обжаловать блокировку и запросить проверку вашей реализации, заполните эту форму. Ответ будет предоставлен вам по эл. почте в течение нескольких рабочих дней. |
RefererNotAllowedMapError
|
Ошибка |
URL-адрес, загружающий Maps JavaScript API, не был добавлен в список разрешенных источников. Проверьте источники ссылок для своего ключа API в Cloud Console. |
OverQuotaMapError
|
Ошибка |
Количество запросов превысило лимиты, установленные для Maps JavaScript API. Запросы вашего приложения начнут обрабатываться снова, когда наступит время следующей дневной квоты. Вы не можете исправить такую ошибку, если НЕ являетесь владельцем сайта. Обнаружив ее, сообщите об этом владельцу. Подробную информацию можно найти в руководстве по лимитам на использование. В статье также описано, как повысить эти лимиты. |
ApiProjectMapError
|
Ошибка |
Предоставленный ключ API или проект API, с которым он связан, не могут быть распознаны. Возможно, эта ошибка временная. Если ошибка повторяется, не исключено, что вам потребуется получить новый ключ API или создать новый проект. |
ClientIdLooksLikeCryptoKey
|
Предупреждение |
Возможно, вы указали в параметре |
ClientIdLooksLikeKey
|
Предупреждение |
Возможно, вы указали в параметре |
InvalidChannel
|
Предупреждение |
Возможно, вы некорректно указали параметр Подробнее читайте в статье Отчеты в тарифном плане Premium. |
InvalidClientId
|
Предупреждение |
Параметр |
InvalidKey
|
Предупреждение |
Ключ API в элементе script, загружающем API, выглядит некорректно. Проверьте, используете ли вы правильный ключ API. Сгенерировать новый ключ API можно в Cloud Console. Чтобы получить ключ API, нажмите кнопку ниже.
|
InvalidVersion
|
Предупреждение |
Вы указали неверный номер версии в элементе script. Проверьте номер версии. Подробнее читайте в статье Версии Maps JavaScript API. |
KeyLooksLikeClientId
|
Предупреждение |
Возможно, вы указали ID клиента в качестве параметра key . Если у вас есть Premium-план или лицензия Maps API for Work, укажите идентификатор клиента в качестве параметра client , а не key . С лицензией Premium платформы Google Карт вы можете использовать оба параметра (client или key ). Если у вас нет лицензий, вместо параметра client
необходимо использовать key .
|
KeyLooksLikeCryptoKey
|
Предупреждение |
Возможно, вы указали криптографический ключ или секретный код подписи в качестве параметра |
KeyLooksLikeProjectNumber
|
Предупреждение |
Возможно, вы указали в качестве параметра |
NoApiKeys
|
Предупреждение |
В элементе script, который загружает API, нет ключа API. Проверьте, указан ли действительный ключ API в качестве параметра
Чтобы получить ключ API, нажмите кнопку ниже.
Если вы попытаетесь загрузить Maps JavaScript API по ссылке на устаревшую версию (v2), то получите предупреждение |
RetiredVersion
|
Предупреждение |
Возможно, вы указали неподдерживаемую версию в элементе script. Исправьте свое приложение для использования с одной из доступных версий. Подробнее читайте в статье Версии Maps JavaScript API. |
SensorNotRequired
|
Предупреждение |
Параметр |
SignatureNotRequired
|
Предупреждение |
Параметр |
SignedInNotSupported
|
Предупреждение |
Параметр |
UrlAuthenticationCommonError
|
Ошибка |
Произошла ошибка, которая не относится к другим категориям, описанным на этой странице. Это может быть вызвано временной проблемой. Повторите запрос через некоторое время. Если проблема не исчезнет, сверьтесь с руководством для разработчиков, чтобы понять, имеет ли ваш запрос правильный формат. |
Проверка ошибок в браузере
Maps JavaScript API записывает сообщения об ошибках в window.console
. В этом разделе мы рассказываем, как проверить выходные данные window.console
в Google Chrome. Если вы используете другой браузер, обратитесь к его документации для разработчиков. Ниже даны ссылки на инструменты, с помощью которых можно проверить выходные данные window.console
в некоторых других браузерах:
Вот как использовать консоль JavaScript для проверки выходных данных window.console
в Chrome:
- Откройте инструменты разработчика (нажмите на значок меню > Другие инструменты > Инструменты разработчика).
- Чтобы открыть консоль 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]
Чтобы понять код ошибки, найдите его в этой таблице. Кроме того, в сообщении об ошибке будет ссылка на документацию с ее описанием.
Примечание. Прослушивать ошибки аутентификации можно программно.
Работа с неподдерживаемыми браузерами
Проверьте, поддерживает ли Maps JavaScript API используемая вами версия браузера.
Если вы разрабатываете нативное приложение для Windows на WebView, используйте только WebView2 (на базе браузера Edge). Предыдущие версии WebView на базе Internet Explorer больше не поддерживаются.
Если ваш код по-прежнему не работает
Чтобы помочь вам справиться с наиболее распространенными ошибками, Брендан Кенни и Мано Маркс записали для вас это видео. Вот что они советуют:
- Убедитесь в отсутствии опечаток. Помните, что в языке JavaScript учитывается регистр.
- Не забывайте об основах! Некоторые распространенные проблемы возникают еще на начальном этапе создания карты. Например:
- заданы ли свойства
zoom
иcenter
; - объявлен ли элемент div, в котором карта будет отображаться на экране;
- задана ли для элемента div высота на экране. По умолчанию элементы div создаются с высотой 0 и поэтому не отображаются на экране.
- заданы ли свойства
- В инструментах разработчика Chrome предусмотрен отладчик JavaScript, помогающий выявлять проблемы. Начните поиск ошибок с консоли JavaScript.
- Задавайте вопросы на форуме Stack Overflow. Воспользуйтесь инструкциями и советами на странице Support (Поддержка).