Получение ключа для Google Places API Web Service

В Google Places API Web Service приложения идентифицируются по ключам API. Добавление ключа в запрос позволяет контролировать использование API приложением в Google API Console и обеспечивает доступ к значительной бесплатной ежедневной квоте, а также позволяет Google в случае необходимости связываться с вами относительно вашего приложения. Подробнее см. справку Google API Console.

• Пользователям стандартного API необходимо настроить ключ API в выбранном проекте.
• Пользователям Google Places API с лицензией на Premium Plan необходимо установить ключ API в проект Google Maps Premium (созданный для вас проект при заказе Google Maps APIs Premium Plan). Если вы еще не приобрели доступ к API, свяжитесь с отделом продаж.

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

Если используется стандартный Google Places API Web Service:

Для начала использования Google Places API Web Service нажмите кнопку ниже, чтобы перейти к инструкциям по активации Google Places API Web Service и получению ключа API.

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

В качестве альтернативы выполните следующие действия, чтобы получить ключ API.

1. Перейдите в Google API Console.
2. Создайте или выберите проект.
3. Нажмите Continue для активации API.
4. Получите ключ API на странице Учетные данные (и установите ограничения ключа API).
   Примечание. Если у вас есть действующий ключ API без ограничений или ключ с ограничениями для сервера, можете использовать его.
5. Чтобы предотвратить неавторизованное использование квоты защитите ключ API, руководствуясь следующими практическими рекомендациями.
6. (Дополнительно) Разрешите тарификацию. Подробнее см. раздел Тарификация и ограничения на использование.

Не используйте этот ключ вне серверного кода. Например, не встраивайте его на веб-страницу или в мобильное приложение.

Примечание. Google Places API Web Service не работает с ключом API, ограниченным для Android или iOS.

Если вы приобрели Google Maps APIs Premium Plan

Чтобы начать пользоваться Google Places API Web Service с Google Maps APIs Premium Plan, нажмите кнопку ниже и перейдите к инструкциям по процессу получения ключа API. Примечание. Чтобы получить доступ ко всем преимуществам Premium Plan, включая квоты на использование, в раскрывающемся меню проектов выберите проект, созданный для вас при покупке Google Maps APIs Premium Plan.*

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

В качестве альтернативного варианта вы можете выполнить следующие действия, чтобы получить ключ API для Premium Plan.

1. Перейдите в Google API Console.
2. В раскрывающемся меню проектов выберите проект Google Maps Premium. *
3. Нажмите Continue.
4. Получите ключ API на странице Учетные данные (и установите ограничения ключа API).
   Примечание. Если у вас есть действующий ключ API без ограничений или ключ с ограничениями для сервера, можете использовать его.
5. Чтобы предотвратить неавторизованное использование квоты защитите ключ API, руководствуясь следующими практическими рекомендациями.

* Примечание. В раскрывающемся меню проектов выберите проект, созданный для вас при покупке Google Maps APIs Premium Plan. Имя проекта начинается с Google Maps APIs for Business or Google Maps for Work or Google Maps. Если вы еще не приобрели доступ к API, свяжитесь с отделом продаж.

Вы также можете выполнить поиск существующего ключа в Google API Console.

Подробнее об использовании Google API Console см. Справку API Console.

Типы ограничений для ключа API

Интерфейсы Google Maps API доступны для приложений Android и iOS, веб-браузеров, а также применяются веб-службами HTTP. Интерфейсы API на любой платформе могут использовать общий (не содержащий ограничений) ключ API. При необходимости в ключ API можно добавить ограничение (например, IP-адрес). После добавления ограничения ключ будет работать только на тех платформах, которые поддерживают ограничение этого типа. Дополнительная информация о ключах и учетных данных.

Указание ключа в запросе

Ключ необходимо передавать с каждым запросом как значение параметра key.

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

Запросы без ключа выполняться не будут.

Ограничение IP-адресов

Чтобы предотвратить использование вашего ключа и квоты другими приложениями, можно ограничить IP-адреса, которые могут использовать ключ API для отправки запросов:

1. Перейдите в Google API Console.
2. Выберите проект, который был создан для вас при регистрации.
3. Выберите из списка ключей API тот ключ, который вы используете.
4. В разделе Restrictions выберите P addresses (web servers, cron jobs, etc.).
5. В поле Accept requests from these server IP addresses введите IP-адреса, с которых будет приниматься ваш ключ, по одному в каждой строке. Можно также ввести подсеть, используя обозначения CIDR (например, 192.168.0.0/22).

Этот способ применим как для стандартного плана, так и для премиум-плана. Подробнее см. Цены и планы.