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

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

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

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

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

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

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

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

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

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

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

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

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

Предупреждение Google Maps JavaScript API: NoApiKeys
Ошибка API JavaScript Карт Google: 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 это можно просмотреть на вкладке DevTools Network . Здесь вы увидите сетевые запросы, сделанные вашим сайтом. Запросы, сделанные с использованием Maps JavaScript API, будут находиться по пути maps/api/js . Здесь вы можете подтвердить, используют ли запросы key параметр. Возможно, будет полезно отфильтровать сетевой трафик с помощью maps/api/js при просмотре вкладки «Сеть» .

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

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

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

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

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

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

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

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

Найдя свой проект в Cloud Console, проверьте, прикреплен ли платежный аккаунт, перейдя в раздел «Оплата» в меню слева.

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

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

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

Большой! Давайте удостоверимся, что предоставленный метод выставления счетов действителен.

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

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

Превышен ли добровольный дневной лимит API?

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

Вы можете проверить свои дневные лимиты, перейдя на панель API и сервисов в Cloud Console. Однажды там:

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

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

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

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

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

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

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

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

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

NotLoadingAPIFromGoogleMapsError

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

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

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

TOSViolationMapError

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

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

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

UnauthorizedURLForClientIdMapError

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

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

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

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

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

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

Код ошибки разработчика	Тип	Описание
`ApiNotActivatedMapError`	Ошибка	API JavaScript Карт не активирован в вашем проекте 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, включенный в загрузчик API JavaScript. Вы можете создать новый проект API и получить новый ключ в Cloud Console. Чтобы создать новый проект и получить для него API-ключ, нажмите кнопку ниже. Узнайте, как
`ClientBillingNotEnabledMapError`	Ошибка	Вы не включили оплату для своего проекта. Вам необходимо включить выставление счетов в проекте Google Cloud, связанном с этим идентификатором клиента, здесь .
`BillingNotEnabledMapError`	Ошибка	Вы не включили оплату в своем проекте, что и вызывает эту ошибку. Вы должны включить выставление счетов в проекте Google Cloud здесь . Узнать больше
`ExpiredKeyMapError`	Ошибка	Срок действия ключа API, включенного в элемент сценария, загружающий API, истек или он не распознается системой. Вы можете получить эту ошибку после создания нового ключа API, если попытаетесь использовать ключ до того, как он будет распознан системой. Подождите несколько минут и повторите попытку. В противном случае вам может потребоваться создать новый ключ API в Cloud Console. Чтобы получить ключ API, нажмите кнопку ниже. Начать
`InvalidAppCheckTokenMapError`	Ошибка	Предоставленный токен проверки приложений недействителен или срок его действия истек. Эта ошибка может возникнуть только в том случае, если используется проверка приложения. См. руководство по проверке приложений .
`InvalidClientIdMapError`	Ошибка	Идентификатор клиента, включенный в элемент скрипта, загружающий API, недействителен или срок его действия истек. Убедитесь, что вы правильно используете свой идентификатор клиента. Идентификатор клиента должен начинаться с префикса «gme-». Если вы видите эту ошибку даже при правильном использовании идентификатора клиента, возможно, срок действия идентификатора клиента истек. Обратитесь к своему менеджеру аккаунта Google. Если у вас нет Премиум-плана или лицензии Maps API for Work, вам необходимо использовать `key` параметр с вашим ключом API вместо параметра `client` . См. руководство по аутентификации в Премиум-плане .
`InvalidKeyMapError`	Ошибка	Ключ API, включенный в элемент сценария, загружающий API, не найден. Убедитесь, что вы используете правильный ключ API. Вы можете создать новый ключ API в Cloud Console. Чтобы получить ключ API, нажмите кнопку ниже. Начать
`MalformedCredentialsMapError`	Ошибка	Ваше приложение использует неподдерживаемую схему URI. Убедитесь, что приложение использует действительный формат URI, определенный в RFC 3986 .
`MissingKeyMapError`	Ошибка	В элементе сценария, загружающем API, отсутствует обязательный параметр аутентификации. Если вы используете стандартный API JavaScript Карт, вам необходимо использовать `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` . Если у вас есть план Премиум или лицензия Maps API for Work, укажите свой идентификатор клиента в качестве параметра `client` . Вам не нужно использовать свой криптографический ключ для Maps JavaScript API. См. руководство по идентификаторам клиентов для клиентов плана Premium и Maps API for Work.
`ClientIdLooksLikeKey`	Предупреждение	Возможно, вы указали ключ API в параметре `client` . Если у вас есть план Премиум или лицензия Maps API for Work, укажите свой идентификатор клиента в качестве параметра `client` . Если у вас есть план Премиум платформы Google Карт, вы можете использовать параметр `client` или `key` параметр. Если у вас нет лицензий, вы должны использовать `key` параметр вместо параметра `client` . См. руководство по аутентификации в Премиум-плане .
`InvalidChannel`	Предупреждение	Возможно, вы указали неверный параметр `channel` . Канал должен представлять собой буквенно-цифровую строку ASCII, которая может включать точку (.), подчеркивание (_) и дефис (-). Убедитесь, что вы указываете действительный параметр `channel` . См. Отчетность \| Премиум-план платформы Google Карт .
`InvalidClientId`	Предупреждение	Параметр `client` , похоже, не содержит правильный идентификатор клиента. Идентификатор клиента должен начинаться с «gme-». См. руководство по аутентификации в Премиум-плане .
`InvalidKey`	Предупреждение	Ключ API, включенный в элемент сценария, загружающий API, выглядит неправильно. Убедитесь, что вы используете правильный ключ API. Вы можете создать новый ключ API в Cloud Console. Чтобы получить ключ API, нажмите кнопку ниже. Начать
`InvalidVersion`	Предупреждение	Возможно, вы указали неверный номер версии в элементе сценария. Пожалуйста, убедитесь, что вы используете правильный номер версии. См. Управление версиями \| JavaScript API Карт Google .
`KeyLooksLikeClientId`	Предупреждение	Возможно, вы указали идентификатор клиента в качестве `key` параметра. Если у вас есть план Премиум или лицензия Maps API for Work, укажите свой идентификатор клиента в качестве параметра `client` , а не `key` параметра. Если у вас есть план Премиум платформы Google Карт, вы можете использовать параметр `client` или `key` параметр. Если у вас нет лицензий, вы должны использовать `key` параметр вместо параметра `client` . См. руководство по аутентификации в Премиум-плане .
`KeyLooksLikeCryptoKey`	Предупреждение	Возможно, вы указали криптографический ключ или секрет подписи в качестве `key` параметра. Если у вас есть план Премиум или лицензия Maps API for Work, укажите свой идентификатор клиента в качестве параметра `client` и удалите `key` параметр из элемента сценария. Криптографический ключ не требуется для Maps JavaScript API. Если у вас есть план Премиум платформы 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 по устаревшему пути версии 2, вы получите предупреждение `NoApiKeys` , даже если вы указали `key` параметр. Ознакомьтесь с руководством по обновлению с версии 2 на версию 3 и перенесите свое приложение на Maps JavaScript API версии 3.
`RetiredVersion`	Предупреждение	Возможно, вы указали устаревшую версию в своем элементе сценария. Пожалуйста, обновите приложение, чтобы использовать одну из доступных версий. См. Управление версиями \| JavaScript API Карт Google .
`SensorNotRequired`	Предупреждение	Параметр `sensor` больше не требуется для Maps JavaScript API. Это не помешает Maps JavaScript API работать корректно, но мы рекомендуем удалить параметр `sensor` из элемента скрипта.
`SignatureNotRequired`	Предупреждение	Параметр `signature` не является обязательным для Maps JavaScript API. Это не помешает Maps JavaScript API работать корректно, но может создать угрозу безопасности. Пожалуйста, удалите его из элемента сценария.
`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 еще раз, чтобы открыть ее.

Если при загрузке 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 .

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

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

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

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