Стиль интерфейса платформы Google Карт скоро изменится. Будет обновлена стандартная цветовая палитра, а сами карты станут удобнее. Все стили карт автоматически обновятся в марте 2025 г. Дополнительные сведения о доступности этих изменений и о том, как включить их раньше, приведены в статье Новый стиль карты для платформы Google Maps.

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

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

Ошибки, связанные с оплатой и ключом API

Как устранить

Иногда карты могут отображаться затемненными, а панорамы Просмотра улиц – в негативе, с водяными знаками с текстом "for development purposes only" (только для целей разработки). Чаще всего такая проблема связана с ключом API или оплатой. Сервисами платформы Google Карт можно пользоваться, только если в вашем аккаунте активированы платежные функции, а в запросах к API указан действительный ключ. Подробную информацию вы найдете в разделе Проверка ошибок в браузере.

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

Используете ли вы ключ API?

Не знаю. Как проверить, использую ли я ключ API?

Ключ API передается как параметр key в URL, который используется для загрузки Maps JavaScript API. Существует несколько способов проверить, используете ли вы ключ API:

Воспользуйтесь расширением Chrome Google Maps Platform API Checker. С его помощью вы сможете определить, правильно ли реализованы лицензионные Maps API на вашем сайте.
Если вы используете библиотеку или плагин для загрузки Maps JavaScript API, проверьте настройки этой библиотеки и найдите вариант с ключом API.
Проверьте, нет ли ошибок в вашем браузере. Если вы увидите следующие сообщения, значит вы неправильно используете ключ API:

Предупреждение Google Maps JavaScript API: NoApiKeys
Ошибка Google Maps JavaScript API: MissingKeyMapError

Для веб-разработчиков:

Если у вас есть доступ к коду приложения, найдите тег <script>, который используется для загрузки Maps JavaScript API. При загрузке Maps JavaScript API замените YOUR_API_KEY в указанном ниже коде ключом API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Проверьте в браузере сетевой трафик от вашего сайта. В Chrome это можно сделать с помощью вкладки Network (Сеть) в инструментах разработчика. Вы увидите сетевые запросы от вашего сайта. Запросы, сделанные с использованием Maps JavaScript API, будут указаны в пути maps/api/js. Здесь вы можете проверить, используется ли в запросах параметр key. Рекомендуем отфильтровать сетевой трафик на вкладке Network (Сеть) по пути maps/api/js.

Нет, я не использую ключ API.

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

Да, я использую ключ API.

Отлично! Проверьте, привязан ли к вашему проекту платежный аккаунт.

К вашему проекту привязан платежный аккаунт?

Не знаю. Как проверить, привязан ли к моему проекту платежный аккаунт?

Откройте страницу оплаты в Google Cloud Console и выберите проект, в котором был создан ключ API. Чтобы подтвердить, что этот ключ связан с проектом, сделайте следующее:

Перейдите в раздел Credentials (Учетные данные). Для этого на боковой панели слева выберите Google Maps Platform > Credentials (Платформа Google Карт > Учетные данные).
Проверьте, есть ли в списке ключ API, который вы используете в настоящее время на своем сайте. Если его здесь нет, перейдите в другой проект и проверьте учетные данные там.
Если вы не можете найти проект для этого ключа, возможно, вы потеряли доступ к этому проекту. Попросите коллег о помощи. Если не получается найти исходный проект, можно сделать следующее:
1. Создайте новый проект. Для этого нажмите кнопку New Project (Новый проект) в списке проектов или Create Project (Создать проект) на странице Resource Manager (Менеджер ресурсов).
2. Создайте новый ключ API. Это можно сделать на странице Credentials (Учетные данные). После этого нажмите Create credentials (Создать учетные данные) и выберите API key (Ключ API).

После того как вы найдете свой проект в Cloud Console, выберите Billing (Оплата) в меню слева и проверьте, связан ли с ним платежный аккаунт.

Нет, к моему проекту не привязан платежный аккаунт.

Откройте страницу включения оплаты в Cloud Console и добавьте к проекту платежный аккаунт. Дополнительные сведения можно найти в руководстве по началу работы с платформой Google Карт.

Да, к моему проекту привязан платежный аккаунт.

Отлично! Убедитесь, что вы указали действующий способ оплаты.

Указанный способ оплаты больше не действует (например, истек срок действия кредитной карты)?

Вы можете добавить, удалить или изменить способ оплаты в Cloud Console.

Установленный вами дневной лимит на использование API превышен?

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

Проверить дневные лимиты можно на странице APIs & Services Dashboard (API и сервисы) в Cloud Console. Сделайте следующее:

Если появится запрос, выберите проект.
Выберите API из списка и откройте вкладку Quotas (Квоты).

У вашего ключа API есть ограничение по IP-адресам?

Ключи API с ограничением по IP-адресам можно использовать только с веб-сервисами, которые предназначены для реализации на стороне сервера (например, Geocoding API и другие API веб-сервисов). Большинство этих веб-сервисов имеют аналоги в Maps JavaScript API (например, сервис геокодирования). Для использования Maps JavaScript API в службах на стороне клиента нужно создать отдельный ключ API, который будет защищен ограничением по ссылающемуся домену HTTP. Подробнее…

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

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

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

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

Код ошибки Сообщение Описание

Код ошибки	Сообщение	Описание
`NotLoadingAPIFromGoogleMapsError`	Maps JavaScript API должен загружаться непосредственно с серверов Google.	Элемент script, загружающий Maps JavaScript API, некорректно добавлен на страницу. Для корректной работы API должен загружаться непосредственно с сайта https://maps.googleapis.com. Как загружать Maps JavaScript API
`TOSViolationMapError`	На этом сайте обнаружены нарушения Условий использования Google Maps API. Доступ к нашему API для этого сайта заблокирован.	Ваше приложение было заблокировано из-за несоответствия Условиям использования платформы Google Карт после отправки нескольких уведомлений по эл. почте. Чтобы обжаловать блокировку и запросить проверку вашей реализации, заполните эту форму. Ответ будет предоставлен вам по эл. почте в течение нескольких рабочих дней. Если у вас есть лицензия Premium платформы Google Карт, то, чтобы исправить ошибку, достаточно указать данные этой лицензии. Подробнее…
`UnauthorizedURLForClientIdMapError`	У этого URL нет права использовать указанный идентификатор клиента Google Карт.	Идентификатор клиента с лицензией Premium или Maps APIs for Work, включенный в script, недействителен, просрочен или адрес для загрузки Maps JavaScript API не добавлен в список авторизованных URL-адресов. Как добавить URL в список авторизованных сайтов

NotLoadingAPIFromGoogleMapsError

Maps JavaScript API должен загружаться непосредственно с серверов Google.

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

Как загружать Maps JavaScript API

TOSViolationMapError

На этом сайте обнаружены нарушения Условий использования Google Maps API. Доступ к нашему API для этого сайта заблокирован.

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

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

UnauthorizedURLForClientIdMapError

У этого URL нет права использовать указанный идентификатор клиента Google Карт.

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

Как добавить 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 параметр `key` вместо параметра `client`. Подробнее…
`InvalidKeyMapError`	Ошибка	Не найден ключ API в элементе script, загружающем API. Проверьте, используете ли вы правильный ключ API. Сгенерировать новый ключ API можно в Cloud Console. Чтобы получить ключ API, нажмите кнопку ниже. Начать
`MalformedCredentialsMapError`	Ошибка	Ваше приложение использует неподдерживаемую схему URI. Используйте допустимый формат URI, определенный в RFC 3986.
`MissingKeyMapError`	Ошибка	В элементе script, загружающем API, отсутствует обязательный параметр аутентификации. Если вы используете стандартный Maps JavaScript API, применяйте параметр `key` с действительным ключом API. Подробнее… Если у вас оформлена лицензия Premium, используйте параметр `client` с вашим ID клиента или параметр `key` с действительным ключом API. Подробнее… Вы не можете исправить такую ошибку, если НЕ являетесь владельцем сайта. Обнаружив ее, сообщите об этом владельцу.
`ProjectDeniedMapError`	Ошибка	Ваш запрос не выполнен. Более подробную информацию ищите в Cloud Console. Cloud Console
`RefererDeniedMapError`	Ошибка	Ваше приложение было заблокировано из-за несоответствия Условиям использования платформы Google Карт после отправки нескольких уведомлений по эл. почте. Чтобы обжаловать блокировку и запросить проверку вашей реализации, заполните эту форму. Ответ будет предоставлен вам по эл. почте в течение нескольких рабочих дней.
`RefererNotAllowedMapError`	Ошибка	URL-адрес, загружающий Maps JavaScript API, не был добавлен в список разрешенных источников. Проверьте источники ссылок для своего ключа API в Cloud Console. Подробнее…
`OverQuotaMapError`	Ошибка	Количество запросов превысило лимиты, установленные для Maps JavaScript API. Запросы вашего приложения начнут обрабатываться снова, когда наступит время следующей дневной квоты. Вы не можете исправить такую ошибку, если НЕ являетесь владельцем сайта. Обнаружив ее, сообщите об этом владельцу. Подробную информацию можно найти в руководстве по лимитам на использование. В статье также описано, как повысить эти лимиты.
`ApiProjectMapError`	Ошибка	Предоставленный ключ API или проект API, с которым он связан, не могут быть распознаны. Возможно, эта ошибка временная. Если ошибка повторяется, не исключено, что вам потребуется получить новый ключ API или создать новый проект. Подробнее…
`ClientIdLooksLikeCryptoKey`	Предупреждение	Возможно, вы указали в параметре `client` криптографический ключ. Если у вас есть лицензия Premium или Maps API for Work, укажите идентификатор клиента в качестве параметра `client`. Криптографический ключ для Maps JavaScript API не требуется. Подробнее об идентификаторах клиента…
`ClientIdLooksLikeKey`	Предупреждение	Возможно, вы указали в параметре `client` ключ API. Если у вас есть лицензия Premium или Maps API for Work, укажите идентификатор клиента в качестве параметра `client`. С лицензией Premium платформы Google Карт можно использовать оба параметра (`client` или `key`). Если у вас нет таких лицензий, вместо параметра `client` необходимо использовать `key`. Подробнее…
`InvalidChannel`	Предупреждение	Возможно, вы некорректно указали параметр `channel`. Его значением может быть только буквенно-цифровая строка в кодировке ASCII (может содержать точки, знаки подчеркивания и дефисы). Проверьте, верно ли указан параметр `channel`. Подробнее читайте в статье Отчеты в тарифном плане Premium.
`InvalidClientId`	Предупреждение	Параметр `client` не содержит корректный идентификатор клиента (должен начинаться с префикса "gme-"). Подробнее…
`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`	Предупреждение	Возможно, вы указали криптографический ключ или секретный код подписи в качестве параметра `key`. Если у вас есть лицензия Premium или Maps API for Work, укажите идентификатор в качестве значения параметра `client` и удалите параметр `key` из элемента script. Для работы с Maps JavaScript API криптографический ключ не требуется. С лицензией Premium платформы Google Карт вы можете использовать оба параметра (`client` или `key`). Если у вас нет таких лицензий, получите ключ API в Cloud Console. Подробнее…
`KeyLooksLikeProjectNumber`	Предупреждение	Возможно, вы указали в качестве параметра `key` номер проекта. Проверьте, используете ли вы правильный ключ API. Сгенерировать новый ключ API можно в Cloud Console. Подробнее…
`NoApiKeys`	Предупреждение	В элементе script, который загружает API, нет ключа API. Проверьте, указан ли действительный ключ API в качестве параметра `key`. Сгенерировать новый ключ API можно в Cloud Console. Чтобы получить ключ API, нажмите кнопку ниже. Начать Если вы попытаетесь загрузить Maps JavaScript API по ссылке на устаревшую версию (v2), то получите предупреждение `NoApiKeys`, даже если у вас задан параметр `key`. Ознакомьтесь с инструкциями по обновлению до версии 3 и перенесите свое приложение в Maps JavaScript API v3.
`RetiredVersion`	Предупреждение	Возможно, вы указали неподдерживаемую версию в элементе script. Исправьте свое приложение для использования с одной из доступных версий. Подробнее читайте в статье Версии Maps JavaScript API.
`SensorNotRequired`	Предупреждение	Параметр `sensor` больше не требуется для Maps JavaScript API. Его наличие в элементе script не помешает корректной работе Maps JavaScript API, однако мы рекомендуем удалить его.
`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 в некоторых других браузерах:

Вот как использовать консоль 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 (Поддержка).