Используйте ключи API с API маршрутов

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

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

Прежде чем начать

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

Создание API-ключей

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

Чтобы создать ключ API:

Консоль

  1. Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .

    Перейти на страницу «Учетные данные»

  2. На странице «Учетные данные» нажмите Создать учетные данные > Ключ API .
    В диалоговом окне создания ключа API отобразится ваш недавно созданный ключ API.
  3. Нажмите «Закрыть».
    Новый ключ API указан на странице «Учетные данные» в разделе «Ключи API» .
    (Не забудьте ограничить ключ API перед его использованием в производстве.)

Облачный SDK 

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

Ограничение ключей API

Google настоятельно рекомендует ограничить использование ключей API, ограничив их использование только теми API, которые необходимы для вашего приложения. Ограничение использования ключей API повышает безопасность вашего приложения, защищая его от несанкционированных запросов. Вы несёте финансовую ответственность за расходы, вызванные злоупотреблением использованием ключей API без ограничений. Подробнее см. в разделе «Рекомендации по безопасности API» .

Чтобы ограничить ключ API:

Консоль

  1. Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .

    Перейти на страницу «Учетные данные»

  2. Выберите ключ API, для которого вы хотите установить ограничение. Откроется страница свойств ключа API.
  3. В разделе «Ограничения ключа» установите следующие ограничения:
    • Ограничения по применению:
      1. Чтобы принимать запросы из предоставленного вами списка IP-адресов веб-серверов, выберите IP-адреса (веб-серверов, заданий cron и т. д.) из списка ограничений приложения . Укажите один или несколько адресов IPv4 или IPv6, а также подсеть, используя CIDR-нотацию. IP-адреса должны соответствовать адресу источника, который отслеживают серверы платформы Google Карт. При использовании преобразования сетевых адресов (NAT) он обычно соответствует публичному IP-адресу вашего компьютера.
    • Ограничения API:
      1. Нажмите Ограничить ключ .
      2. В раскрывающемся списке «Выбрать API» выберите «Directs API» . Если Directions API отсутствует в списке, его необходимо включить .
  4. Чтобы завершить изменения, нажмите кнопку Сохранить .

Облачный SDK

Перечислите существующие ключи.

gcloud services api-keys list --project="PROJECT"

Снимите существующие ограничения для существующего ключа.

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Установите новые ограничения для существующего ключа.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=directions-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:

Добавление ключа API к вашему запросу

Необходимо включать ключ API в каждый запрос к API Directions. В следующем примере замените YOUR_API_KEY на свой ключ API.

https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key= YOUR_API_KEY

Для запросов, использующих ключ API, требуется HTTPS.