Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Устранение неполадок

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

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

Перейдите в раздел Credentials (Учетные данные). Для этого на боковой панели слева выберите Google Maps Platform > Credentials (Платформа Google Карт > Учетные данные).
Проверьте, есть ли в списке ключ API, который вы используете в настоящее время на своем сайте. Если его здесь нет, перейдите в другой проект и проверьте учетные данные там.
Если вы не можете найти проект для своего ключа 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-клиента вам нужно создать отдельный ключ API, который будет защищен ограничением по HTTP-реферерам. Подробная информация приведена в этой статье.

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

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

Убедитесь в отсутствии опечаток. Помните, что в языке JavaScript учитывается регистр.
Не забывайте об основах! Некоторые распространенные проблемы возникают еще на начальном этапе создания карты. Например:
- заданы ли свойства zoom и center;
- объявлен ли элемент div, в котором карта будет отображаться на экране;
- Убедитесь, что для элемента div карты задана ненулевая высота CSS (например, height: 400px). По умолчанию элементы div создаются с высотой 0 и поэтому не отображаются на экране.
Изучите примеры и используйте их как образцы.
В инструментах разработчика Chrome предусмотрен отладчик JavaScript, помогающий выявлять проблемы. Начните поиск ошибок с консоли JavaScript. Если вы обнаружите ошибки, например InvalidKeyMapError или ApiNotActivatedMapError, устраните их, следуя инструкциям из руководства Сообщения об ошибках.
Задавайте вопросы на форуме Stack Overflow. Воспользуйтесь инструкциями и советами на странице Support (Поддержка).