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

Выберите платформу: Android iOS JavaScript

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

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

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

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

Консоль

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

    Перейдите на страницу учетных данных

  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 понадобится вам при создании проекта Xcode, как описано в разделе «Настройка проекта Xcode» .

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

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

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

Консоль

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

    Перейдите на страницу учетных данных

  2. Выберите ключ API, для которого вы хотите установить ограничение. Появится страница свойств ключа API.
  3. В разделе «Ограничения ключей» установите следующие ограничения:
    • Ограничения применения:
      1. Выберите приложения для iOS .
      2. Чтобы принимать запросы от приложения iOS с предоставленным вами идентификатором пакета, выберите соответствующий идентификатор пакета iOS из списка.
    • Ограничения API:
      1. Нажмите Ограничить ключ .
      2. В раскрывающемся списке «Выбор API» выберите Maps SDK для iOS . Если Maps SDK для iOS не указан, его необходимо включить .
  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=maps-ios-backend.googleapis.com
    --allowed-bundle-ids="BUNDLE_NAME"

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

Теперь, когда вы получили ключ API для Maps SDK для iOS, вы готовы приступить к работе .

Что дальше

Теперь, когда у вас есть ключ API, создайте и настройте проект Xcode, как описано в разделе «Настройка проекта Xcode» .