Эта страница переведена с помощью Cloud Translation API.

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

Нужна помощь от человека?
Перейдите на страницу поддержки платформы Google Maps.
Эта страница с сообщениями об ошибках предназначена только для ознакомления. Она поможет вам самостоятельно устранить ошибки JavaScript API в Maps. Если вы попытаетесь обратиться за помощью к специалисту, отправив отзыв через эту страницу, вы не сможете связаться с тем, кто сможет вам помочь. Однако, если вы обнаружите проблему с содержимым этой страницы, пожалуйста, сообщите нам об этом, используя ссылку для обратной связи. Спасибо!

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

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

Поиск неисправностей

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

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

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

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

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

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

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

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

Если у вас есть доступ к исходному коду вашего приложения, найдите тег <script> , который используется для загрузки JavaScript API карт. При загрузке 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 это можно сделать с помощью вкладки «Сеть» в Инструментах разработчика . Здесь вы увидите сетевые запросы, сделанные вашим сайтом. Запросы, сделанные с использованием Maps JavaScript API, будут находиться по пути maps/api/js . Здесь вы можете убедиться, что запросы используют параметр key . При просмотре вкладки «Сеть» может быть полезно отфильтровать сетевой трафик по maps/api/js .

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

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

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

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

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

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

Перейдите на страницу «Биллинг» в консоли Google Cloud и выберите проект, в рамках которого был создан ваш API-ключ. Чтобы подтвердить, что ключ связан с проектом:

Перейдите в раздел «Учетные данные» , доступ к которому можно получить через левую боковую панель в меню «Платформа Google Maps» > «Учетные данные» .
Убедитесь, что используемый вами в данный момент API-ключ указан в списке. Если это не так, переключитесь на другой проект и проверьте учетные данные там.
Если вы не можете найти проект, соответствующий вашему API-ключу, возможно, вы потеряли доступ к этому проекту. Обратитесь за помощью к другим сотрудникам вашей организации. Если исходный проект найти не удаётся, вам следует:
1. Создайте новый проект. Это можно сделать, выбрав «Новый проект» в списке проектов или выбрав «Создать проект» на странице «Диспетчер ресурсов» .
2. Создайте новый ключ API. Это можно сделать на странице «Учетные данные» . Там нажмите «Создать учетные данные» , а затем выберите «Ключ API» .

После того как вы найдете свой проект в облачной консоли, проверьте, привязан ли к нему платежный аккаунт, перейдя в раздел «Биллинг» в меню слева.

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

Перейдите на страницу «Включить выставление счетов» в консоли Cloud и добавьте учетную запись для выставления счетов к своему проекту. Дополнительную информацию см. в разделе «Начало работы с Google Maps Platform» .

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

Отлично! Давайте убедимся, что указанный способ оплаты действителен.

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

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

Превышен ли установленный вами самими суточный лимит на использование API?

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

Проверить свои ежедневные лимиты можно, перейдя на панель управления API и сервисами в консоли Cloud. Там:

При появлении запроса выберите проект.
Выберите API из списка, затем перейдите на вкладку «Квоты» .

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

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

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

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

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

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

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

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

NotLoadingAPIFromGoogleMapsError

JavaScript API для работы с картами необходимо загрузить непосредственно с серверов Google.

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

См. раздел «Загрузка JavaScript API карт» .

TOSViolationMapError

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

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

Если у вас есть лицензия Google Maps Platform Premium Plan, пожалуйста, используйте свои учетные данные Google Maps Platform Premium Plan для устранения этой ошибки. См. руководство по аутентификации для Premium Plan .

UnauthorizedURLForClientIdMapError

Данный URL-адрес не авторизован для использования предоставленного идентификатора клиента Google Maps.

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

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

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

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

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

Код ошибки разработчика	Тип	Описание
`ApiNotActivatedMapError`	Ошибка	В вашем проекте API не активирован JavaScript API для работы с картами. Возможно, вам потребуется включить JavaScript API для работы с картами в разделе API в консоли Google Cloud. Чтобы активировать JavaScript API для работы с картами в вашем проекте, нажмите кнопку ниже. Узнайте, как
`ApiTargetBlockedMapError`	Ошибка	Данный ключ API не авторизован для использования этой службы или API. Пожалуйста, проверьте настройки ограничений API для вашего ключа API в консоли Google Cloud, чтобы убедиться, что все необходимые вам API и службы правильно указаны в списке включенных API. См. ключи API в консоли Cloud . Для получения дополнительной информации см. рекомендации по обеспечению безопасности API .
`DeletedApiProjectMapError`	Ошибка	Возможно, ваш API-проект был удален из консоли Cloud. Пожалуйста, проверьте проект, для которого вы сгенерировали ключ API, включенный в JavaScript API Loader. Вы можете создать новый API-проект и получить новый ключ в консоли Cloud. Чтобы создать новый проект и получить API-ключ для проекта, нажмите кнопку ниже. Узнайте, как
`ClientBillingNotEnabledMapError`	Ошибка	Вы не включили выставление счетов в своем проекте. Вам необходимо включить выставление счетов в проекте Google Cloud, связанном с этим идентификатором клиента, здесь .
`BillingNotEnabledMapError`	Ошибка	Вы не включили выставление счетов в своем проекте, что и вызывает эту ошибку. Вам необходимо включить выставление счетов в проекте Google Cloud здесь . Узнать больше
`ExpiredKeyMapError`	Ошибка	Ключ API, указанный в элементе скрипта, загружающем API, устарел или не распознается системой. Эта ошибка может появиться после создания нового ключа API, если вы попытаетесь использовать его до того, как система его распознает. Подождите несколько минут и повторите попытку, или вам может потребоваться сгенерировать новый ключ API в консоли Cloud. Чтобы получить ключ API, нажмите кнопку ниже. Начать
`InvalidAppCheckTokenMapError`	Ошибка	Предоставленный токен App Check недействителен или истек. Эта ошибка может возникнуть только в том случае, если используется проверка App Check. См. руководство по проверке через App Check .
`InvalidClientIdMapError`	Ошибка	В целях повышения безопасности и надежности аутентификации, идентификаторы клиентов Maps Platform устарели с 26 мая 2025 года и больше не могут использоваться после 31 мая 2026 года. Вместо идентификатора клиента для аутентификации трафика сервиса Google Maps API необходимо использовать учетные данные API-ключа. Для получения дополнительной информации посетите руководство по миграции идентификатора клиента . Следуйте инструкциям в руководстве, чтобы временно восстановить идентификатор клиента .
`InvalidKeyMapError`	Ошибка	Ключ API, указанный в элементе скрипта, загружающем API, не найден. Убедитесь, что вы используете правильный ключ API. Вы можете сгенерировать новый ключ API в консоли Cloud. Чтобы получить ключ API, нажмите кнопку ниже. Начать
`MalformedCredentialsMapError`	Ошибка	Ваше приложение использует неподдерживаемую схему URI. Убедитесь, что приложение использует допустимый формат URI, определенный в RFC 3986 .
`MissingKeyMapError`	Ошибка	В элементе скрипта, загружающем API, отсутствует необходимый параметр аутентификации. Если вы используете стандартный JavaScript API для работы с картами, необходимо указать в качестве параметра `key` с действительным ключом API. Дополнительную информацию см. в разделе «Начало работы с платформой Google Maps» . Если вы являетесь клиентом тарифного плана Premium, вам необходимо использовать либо параметр `client` с вашим идентификатором клиента, либо параметр `key` с действительным ключом API. Для получения дополнительной информации см. руководство по ключам API и идентификаторам клиентов . Если вы НЕ являетесь владельцем сайта, то никаких действий для исправления этой ошибки вы предпринять не сможете. Однако, по возможности, стоит уведомить владельца сайта.
`ProjectDeniedMapError`	Ошибка	Ваш запрос не был выполнен. Более подробную информацию об ошибке вы можете найти в консоли Cloud. См. консоль Cloud .
`RefererDeniedMapError`	Ошибка	Ваше приложение было заблокировано за несоответствие условиям использования платформы Google Maps после нескольких уведомлений по электронной почте. Чтобы обжаловать блокировку и добиться пересмотра вашей реализации, пожалуйста, заполните эту форму . Вы получите ответ по электронной почте в течение нескольких рабочих дней.
`RefererNotAllowedMapError`	Ошибка	Текущий URL-адрес, загружающий JavaScript API карт, не добавлен в список разрешенных рефереров. Пожалуйста, проверьте настройки рефереров вашего API-ключа в консоли Cloud. Ознакомьтесь с JavaScript API для работы с картами и получите ключ API .
`OverQuotaMapError`	Ошибка	Количество запросов превысило лимиты использования API JavaScript для карт. Запросы вашего приложения возобновятся после следующего сброса ежедневной квоты. Если вы НЕ являетесь владельцем сайта, вы ничего не можете сделать для исправления этой ошибки. Однако, если это возможно, вы можете уведомить владельца сайта. Более подробную информацию см. в руководстве по ограничениям использования . На этой странице также объясняется, как можно увеличить лимиты использования.
`ApiProjectMapError`	Ошибка	Не удалось разрешить предоставленный ключ API или связанный с ним проект API. Эта ошибка может быть временной. Если сообщение об ошибке повторяется, вам может потребоваться получить новый ключ API или создать новый проект API. Для получения более подробной информации см. раздел «Начало работы с платформой Google Maps» .
`ClientIdLooksLikeCryptoKey`	Предупреждение	Возможно, вы указали криптографический ключ в параметре `client` . Если у вас есть тарифный план Premium или лицензия Maps APIs for Work, укажите свой идентификатор клиента в качестве параметра `client` . Вам не нужно использовать криптографический ключ для API карт JavaScript. См. руководство по идентификаторам клиентов для тарифных планов Premium и API карт для пользователей Work.
`ClientIdLooksLikeKey`	Предупреждение	Возможно, вы указали ключ API в параметре `client` . Если у вас есть тарифный план Premium или лицензия Maps APIs for Work, укажите свой идентификатор клиента в качестве параметра `client` . Если у вас тарифный план Google Maps Platform Premium, вы можете использовать параметр `client` или параметр `key` . Если у вас нет лицензий, необходимо использовать параметр `key` вместо параметра `client` . См. руководство по аутентификации в рамках Премиум-плана .
`InvalidChannel`	Предупреждение	Возможно, вы указали недопустимый параметр `channel` . Канал должен представлять собой буквенно-цифровую строку ASCII, которая может содержать точку (.), подчеркивание (_) и дефис (-). Пожалуйста, убедитесь, что вы указываете допустимый параметр `channel` . См. раздел «Отчетность» \| Премиум-план платформы Google Maps .
`InvalidClientId`	Предупреждение	Параметр `client` , по всей видимости, не содержит корректного идентификатора клиента. Идентификатор клиента должен начинаться с "gme-". См. руководство по аутентификации в рамках Премиум-плана .
`InvalidKey`	Предупреждение	Ключ API, указанный в элементе скрипта, загружающем API, выглядит некорректно. Пожалуйста, убедитесь, что вы используете правильный ключ API. Вы можете сгенерировать новый ключ API в консоли Cloud. Чтобы получить ключ API, нажмите кнопку ниже. Начать
`InvalidVersion`	Предупреждение	Возможно, вы указали неверный номер версии в элементе скрипта. Пожалуйста, убедитесь, что вы используете правильный номер версии. См. раздел «Версионирование \| Google Maps JavaScript API» .
`KeyLooksLikeClientId`	Предупреждение	Возможно, вы указали идентификатор клиента в качестве параметра `key` . Если у вас есть тарифный план Premium или лицензия Maps APIs for Work, укажите идентификатор клиента в качестве параметра `client` вместо параметра `key` . Если у вас тарифный план Google Maps Platform Premium, вы можете использовать параметр `client` или параметр `key` . Если у вас нет лицензий, необходимо использовать параметр `key` вместо параметра `client` . См. руководство по аутентификации в рамках Премиум-плана .
`KeyLooksLikeCryptoKey`	Предупреждение	Возможно, вы указали криптографический ключ или секретный ключ подписи в качестве параметра `key` . Если у вас есть тарифный план Premium или лицензия Maps APIs for Work, укажите свой идентификатор клиента в качестве параметра `client` и удалите параметр `key` из элемента скрипта. Криптографический ключ не требуется для API карт JavaScript. Если у вас есть тарифный план Google Maps Platform Premium, вы можете использовать параметр `client` или параметр `key` . Если у вас нет лицензий, вы можете получить ключ API в консоли Cloud. См. руководство по указанию идентификатора клиента при загрузке API .
`KeyLooksLikeProjectNumber`	Предупреждение	Возможно, вы указали номер проекта в качестве параметра `key` . Пожалуйста, убедитесь, что используете правильный ключ API. Вы можете сгенерировать новый ключ API в консоли Cloud. Узнайте, как получить ключ API.
`NoApiKeys`	Предупреждение	Элемент скрипта, загружающий API, не имеет ключа API. Пожалуйста, убедитесь, что вы указали действительный ключ API в качестве параметра `key` . Вы можете сгенерировать новый ключ API в консоли Cloud. Чтобы получить ключ API, нажмите кнопку ниже, чтобы начать. Начать Если вы загружаете Maps JavaScript API из устаревшего пути версии 2, вы получите предупреждение `NoApiKeys` , даже если указали параметр `key` . Пожалуйста, ознакомьтесь с руководством по обновлению с версии 2 до версии 3 и переведите ваше приложение на Maps JavaScript API версии 3.
`RetiredVersion`	Предупреждение	Возможно, в элементе скрипта вы указали устаревшую версию. Пожалуйста, обновите ваше приложение, чтобы использовать одну из доступных версий. См. раздел «Версионирование \| Google Maps JavaScript API» .
`SensorNotRequired`	Предупреждение	Параметр `sensor` больше не требуется для JavaScript API карт. Он не помешает корректной работе JavaScript API карт, но мы рекомендуем удалить параметр `sensor` из элемента script.
`SignatureNotRequired`	Предупреждение	Параметр `signature` не является обязательным для JavaScript API карт. Он не помешает корректной работе JavaScript API карт, но может создать риски безопасности. Пожалуйста, удалите его из элемента script.
`SignedInNotSupported`	Предупреждение	Параметр `signed_in` устарел и не поддерживается в используемой вами версии Maps JavaScript API. Это не помешает работе Maps JavaScript API, но поведение вашего приложения может измениться, если вы используете функции авторизации.
`UrlAuthenticationCommonError`	Ошибка	Произошла ошибка, не подпадающая под другие категории на этой странице. Это может быть вызвано временной проблемой. Пожалуйста, повторите запрос через небольшую задержку. Если это не решит проблему, пожалуйста, ознакомьтесь с руководством для разработчиков, чтобы убедиться, что запрос имеет правильный формат.

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

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

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

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

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

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

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

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

Обработка неподдерживаемых браузеров

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

Если вы разрабатываете нативное приложение для Windows, работающее в WebView, убедитесь, что используете WebView2 на базе Edge. Предыдущие версии WebView, основанные на Internet Explorer, больше не поддерживаются.

Если ваш код по-прежнему не работает

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

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