Получение ключа/аутентификация

Для всех приложений Google Maps JavaScript API требуется аутентификация.

• Пользователи стандартного API: Если вы используете API по стандартному плану, вам необходимо использовать ключ API, указанный в выбранном вами проекте. См. более подробную информацию о ключах API для стандартных API.
• Пользователи Premium Plan: если вы используете API в рамках Google Maps APIs Premium Plan, возможны два варианта аутентификации.
  • Использовать ключ API, указанный в проекте Google Maps APIs Premium Plan, созданном для вас при покупке Premium Plan.
      или
  • Использовать свой идентификатор клиента вместо ключа API.

  См. раздел Google Maps APIs Premium Plan ниже, чтобы получить информацию о выборе наиболее подходящего способа аутентификации.

Аутентификация для стандартного API – ключи API

Чтобы использовать стандартный API, вы должны при загрузке API добавить ключ API.

Преимущества использования ключа API:

• Ключ API позволяет осуществлять мониторинг использования API приложения в Google API Console. Дополнительные сведения см. в Справке Google API Console.
• При использовании ключа у вас есть доступ к значительной бесплатной ежедневной квоте, а также возможность увеличить свою дневную квоту путем разрешения тарификации для оплаты по факту использования.
• Регистрация ключа API позволяет Google связаться с вами относительно вашего приложения, если возникнет такая необходимость.

Получение ключа API

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

Получение ключа

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

1. Перейдите в Google API Console.
2. Создайте или выберите проект.
3. Нажмите Continue для активации API и всех связанных служб.
4. На странице Учетные данные выберите Ключ API (и установите ограничения для ключа API).
   Примечание. Если у вас есть действующий ключ API без ограничений или ключ с ограничениями для браузера, можете использовать его.
5. Для предотвращения неавторизованного использования квоты обеспечьте защиту ключа API, руководствуясь следующими практическими рекомендациями.
6. (Дополнительно) Разрешите тарификацию. Дополнительную информацию см. в документе Ограничения на использование.

В Google API Console также можно выполнить поиск существующего ключа или просмотреть список включенных API.

Дополнительную информацию об использовании Google API Console см. в Справке API Console.

Типы ограничений для ключа API

Интерфейсы Google Maps API доступны для приложений Android и iOS, веб-браузеров, а также применяются веб-службами HTTP. Интерфейсы API на любой платформе могут использовать общий (без ограничений) ключ API. При необходимости в ключ API можно добавить ограничение (например, источник ссылки HTTP). После добавления ограничения ключ будет работать только на тех платформах, которые поддерживают ограничение этого типа. Дополнительная информация о ключах и учетных данных.

Указание ключа при загрузке API

Чтобы указать ключе, добавьте его как значение параметра key при загрузке API.

Например:

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
  type="text/javascript"></script>

Аутентификация для пользователей Google Maps APIs Premium Plan

Информация в этом разделе относится только к новому продукту Google Maps APIs Premium Plan, который стал доступен 6 января 2016 года.

У вас есть лицензия на ранее выпускавшиеся продукты Maps APIs for Work или Maps API for Business? См. наше Руководство по использованию лицензий на Maps APIs for Work. Чтобы определить, какая у вас лицензия, выполните следующие действия. Перейдите на Google Cloud Support Portal и щелкните Maps: Usage Report слева. Если идентификатор в верхней части отчета представлен в следующем формате, вы используете новый Premium Plan:
gme-[company] & proj-[number] ([type])
В противном случае у вас лицензия на ранее выпускавшийся продукт.

При использовании Google Maps JavaScript API с лицензией на Google Maps APIs Premium Plan вы должны выполнить аутентификацию своего приложения с использованием либо ключа API, либо идентификатора клиента. Примечание. Если у вас есть лицензия на ранее выпускавшийся продукт Maps API for Business, вы должны использовать идентификатор клиента, а не ключ API.

Принимая решение об применении способа аутентификации, необходимо учитывать следующее.

• Ключ API (доступен для владельцев Google Maps APIs Premium Plan, но не для владельцев лицензии на ранее выпускавшийся продукт Maps API for Business) – используя ключ API для аутентификации запросов, вы можете:
  • Управлять всеми своими API в Google API Console
  • Получать доступ к информации об использовании в режиме реального времени, а также к журналу использования за последние 30 дней для вашего приложения в Google API Console
  • Просматривать отчеты об использовании данных за более чем 30 дней в Google Cloud Support Portal.
• Идентификатор клиента – используя идентификатор клиента (вместо ключа API) для аутентификации запросов, вы можете:
  • Добавлять в запросы параметр channel, благодаря чему вы сможете просматривать отчеты с более подробной информацией об использовании.
  • Просматривать отчеты об использовании данных за более чем 30 дней в Google Cloud Support Portal.
  • Использовать инструменты Maps Analytics для Maps JavaScript API

Дополнительная информация об отчетах, доступных для пользователей Premium Plan.

Использование ключа API

Чтобы выполнить аутентификацию Google Maps JavaScript API с использованием ключа API, нажмите следующую кнопку для помощи при выполнении процесса получения ключа API.

Внимание! В раскрывающемся меню проектов выберите проект, созданный для вас при покупке Premium Plan. Имя проекта начинается с Google Maps APIs for Business or Google Maps for Work or Google Maps.*

Получение ключа

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

1. Перейдите в Google API Console.
2. В раскрывающемся меню Project выберите проект Google Maps Premium.*
3. Нажмите Continue.
4. На странице Учетные данные выберите Ключ API (и установите ограничения для ключа API).
   Примечание. Если у вас есть действующий ключ API без ограничений или ключ с ограничениями для браузера, можете использовать его.
5. Для предотвращения неавторизованного использования квоты обеспечьте защиту ключа API, руководствуясь следующими практическими рекомендациями.

* Примечание. В раскрывающемся меню проектов выберите проект, созданный для вас при покупке Premium Plan. Имя проекта начинается с Google Maps APIs for Business or Google Maps for Work or Google Maps. Внимание! Если у вас есть лицензия на ранее выпускавшийся продукт Maps API for Business, вы должны использовать идентификатор клиента, а не ключ API.

Также можно выполнить поиск существующего ключа в Google API Console.

Дополнительную информацию об использовании Google API Console см. в Справке API Console.

Указание ключа при загрузке API

Чтобы указать ключе, добавьте его как значение параметра key при загрузке API.

Например:

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
  type="text/javascript"></script>

Использование идентификатора клиента

Для аутентификации Google Maps JavaScript API с использованием идентификатора клиента (вместо ключа API) требуется уникальный идентификатор клиента в сочетании с регистрацией URL-адреса.

Если ранее для аутентификации вы использовали ключ API и теперь переходите к использованию идентификатора клиента, перед загрузкой API удалите параметр key. При одновременном использовании идентификатора клиента и ключа API загрузка API завершится с ошибкой.

Ваш идентификатор клиента

После приобретения лицензии на Google Maps APIs Premium Plan вы получите по эл. почте приветственное письмо от Google, в котором будет указан ваш идентификатор клиента. Ваш идентификатор клиента используется для доступа к специальным функциям Google Maps APIs Premium Plan. Все идентификаторы клиентов начинаются с префикса gme-.

Этот идентификатор клиента не является ключом. Он будет работать только для URL-адресов, которые вы авторизуете, поэтому вам не стоит переживать об обеспечении его секретности.

Указание идентификатора клиента при загрузке API

Укажите идентификатор клиента как значение параметра client при загрузке Google Maps JavaScript API:

<script async defer src="https://maps.googleapis.com/maps/api/js?client=YOUR_CLIENT_ID &v=3.26&callback=initMap"></script>

Как видно из приведенного выше примера, вам необходимо указать выпущенную версию (которая также называется стабильной версией) или более раннюю версию, применив параметр v=3.26. Приложения, в которых используется экспериментальная версия, не учитываются соглашением об уровне обслуживания Google Maps APIs Premium Plan.

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

Чтобы не допустить применение вашего идентификатора клиента посторонними лицами на своих веб-сайтах, его использование ограничено списком URL-адресов, которые вы явным образом авторизуете.

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

1. Выполните вход в Google Cloud Support Portal.
2. В меню с левой стороны щелкните Maps: Manage Client ID.

За один раз можно добавить до 100 URL-адресов, а их общее количество не должно превышать 3 000 URL-адресов. Если вам необходим больший лимит адресов, обратитесь в службу поддержки.

В отношении авторизованных URL-адресов следует учитывать следующее:

Доменное имя или IP-адрес не обязательно должны быть общедоступными.

Например, могут использоваться адреса http://myintranet и http://192.168.1.1.

Все дочерние домены указанного домена также будут авторизованы.

Например, если адрес http://example.com авторизован, тогда авторизованным является также и адрес http://www.example.com. Это правило не действует в обратную сторону: если адрес http://www.example.com авторизован, это не означает, что и адрес http://example.com также будет авторизован.

Все вложенные пути авторизованного пути также являются авторизованными.

Например, если адрес http://example.com авторизован, тогда авторизованным является также и адрес http://example.com/foo. Кроме того, поскольку дочерние домены указанного домена также авторизованы, адрес http://sub.example.com/bar является авторизованным.

Имена путей чувствительны к регистру.

Например, адреса http://www.example.com/ThisPath/ и http://www.example.com/thispath/ – это не одно и то же.

Вы можете установить ограничения для действительных URL-адресов, указав определенные порты.

Например, если указан адрес http://example.com:8080/foo, это не означает, что будет авторизован и адрес http://example.com.

Протоколы HTTP и HTTPS считаются разными URL-адресами.

Например, если адрес https://example.com авторизован, это не означает, что адрес http://example.com также является авторизованным. Если требуется авторизовать сразу оба адреса, добавьте домен без использования протокола: example.com/

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

http://example.com/ также авторизует адрес http://sub.example.com/path.

Дополнительную информацию см. в документе Устранение проблем при использовании Google Maps APIs Premium Plan с помощью авторизации.