Аутентификация и авторизация

Эта страница предназначена только для пользователей, которые владеют лицензией на ранее выпускавшиеся продукты Maps APIs for Work или Maps API for Business. Эта страница не предназначена для пользователей нового продукта Google Maps APIs Premium Plan, который стал доступен в январе 2016 года.

Идентификаторы клиента

Аутентификация Google Maps JavaScript API для пользователей Google Maps APIs for Work требует наличия уникального идентификатора клиента в сочетании с регистрацией URL-адреса.

Получение идентификатора клиента

Чтобы использовать специальные функции Google Maps APIs for Work, вы должны указывать идентификатор клиента при доступе к любым библиотекам или службам API. При регистрации для Google Maps APIs for Work вы получите этот идентификатор клиента из Google Cloud Support Portal. Все идентификаторы клиентов начинаются с префикса 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 for Work.

Регистрация авторизованных 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 for Work.