Используйте ключи API с Places API

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

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

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

Прежде чем вы начнете

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

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

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

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

Консоль

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

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

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

Облачный SDK

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

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

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

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

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

Консоль

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

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

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

Облачный SDK

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

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

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

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

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

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="places-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

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

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

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&types=restaurant&name=harbour&key= YOUR_API_KEY

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