Продукты платформы Google Карт защищены от несанкционированного использования путем ограничения вызовов API теми, которые предоставляют надлежащие учетные данные для аутентификации. Эти учетные данные представлены в виде ключа API — уникальной буквенно-цифровой строки, которая связывает ваш платежный аккаунт Google с вашим проектом и с конкретным API или SDK.

В этом руководстве показано, как создать, ограничить и использовать ключ API для платформы Google Карт.

## Прежде чем вы начнете
Прежде чем вы начнете использовать Maps Static API, вам нужен проект с платежным аккаунтом и включенным Maps Static API. Дополнительные сведения см. в разделе Настройка в Cloud Console.

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

Чтобы создать ключ API:
 Консоль
-
Перейти к
Платформа Google Карт >Страница учетных данных

Перейти на страницу учетных данных
-
На
На странице Credentials щелкните Создать учетные данные >Ключ API.


В диалоговом окне создания ключа API отображается только что созданный ключ API.

-
Нажмите
Закрывать

Новый ключ API указан на
Страница учетных данных под ключами API

(Не забудьте ограничить ключ API перед его использованием в рабочей среде.)
 Облачный SDK
gcloud alpha сервисы api-keys create \ --project "ПРОЕКТ"\ --display-name "DISPLAY_NAME"Узнайте больше о Google Cloud SDK, установке Cloud SDK и следующих командах:
## Ограничение ключей API
Google настоятельно рекомендует вам ограничивать свои ключи API, ограничивая их использование только теми API, которые необходимы для вашего приложения. Ограничение ключей API повышает безопасность вашего приложения, защищая его от необоснованных запросов. Дополнительные сведения см. в разделе Рекомендации по безопасности API.

Чтобы ограничить ключ API:
 Консоль
-
Перейти к
Платформа Google Карт >Страница учетных данных

Перейти на страницу учетных данных
- Выберите ключ API, для которого вы хотите установить ограничение. Появится страница свойств ключа API.

- Под
Ключевые ограничения, установите следующие ограничения:
- Ограничения по применению:
- Чтобы принимать запросы из списка IP-адресов веб-серверов, которые вы предоставляете, выберите
IP-адреса (веб-серверы, задания cron и т. д.) из списка ограничений приложений. Укажите один адрес IPv4 или IPv6 или подсеть, используя нотацию CIDR (например, 192.168.0.0/22). Поскольку запрос веб-службы веб-службы проверяет и сравнивает внешний IP-адрес с ограничением ключа API, используйте общедоступный IP-адрес сервера.

- Нажмите
Ограничить ключ

- Выбирать
Maps Static API из раскрывающегося списка Select APIs. Если Maps Static API отсутствует в списке, вам необходимо включить его. **Сохранить**

 Облачный SDK

Список существующих ключей

список API-ключей gcloud --project="ПРОЕКТ"Снимите существующие ограничения для существующего ключа

API-ключи gcloud alpha services обновляют «проекты/
ПРОЕКТ/ключи/ KEY_ID"\ --clear-restrictions
Установить новые ограничения для существующего ключа

API-ключи gcloud alpha services обновляют «проекты/
PROJECT/keys/ KEY_ID"\ --api_target="static-maps-backend.googleapis.com"--allowed-ips="IP_ADDRESS"Узнайте больше о Google Cloud SDK, установке Cloud SDK и следующих командах:
## Добавление ключа API к вашему запросу
Вы должны включать ключ API в каждый запрос статического API Карт. В следующем примере
заменять
YOUR_API_KEY с вашим ключом API

httpsmaps.googleapis.com/maps/api/staticmap?center=40.714%2c%20-73.998&zoom=12&size=400x400&key=ВАШ_API_KEY
HTTPS требуется для запросов, использующих ключ API.

## Что дальше
В запросах Maps Static API также должна использоваться цифровая подпись.