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

Напоминание. Чтобы использовать Maps JavaScript API:

• Все запросы Maps JavaScript API должны включать ключ API; мы больше не поддерживаем доступ без ключа.
• Вам необходимо включить выставление счетов для каждого из ваших проектов.

Ключ 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 и выберите проект, в рамках которого был создан ваш ключ API. Чтобы подтвердить, что ключ связан с проектом:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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