Все готово!

Прежде чем приступить к разработке, ознакомьтесь с документацией для разработчиков.

Активация Google Places API for Android

Чтобы помочь вам освоиться, мы покажем, как выполнить некоторые необходимые действия в консоли разработчика Google:

  1. Создание или выбор проекта
  2. Активация Google Places API for Android
  3. Создание соответствующих ключей

Начало работы

В этой статье вы познакомитесь с возможностями Google Places API for Android и узнаете, как настроить приложение для использования этого API.

  1. Введение и основные понятия
  2. Обзор API
  3. Поддерживаемые версии платформы Android
  4. Настройка приложения
    1. Настройка служб Google Play
    2. Добавление ключа API
    3. Запрос на увеличение лимитов использования
  5. Подключение к Places API

Введение и основные понятия

Ключевыми компонентами Google Places API for Android являются виджеты пользовательского интерфейса PlacePicker и Autocomplete, интерфейсы GeoDataApi и PlaceDetectionApi.

С помощью Google Places API for Android можно создавать геолокационные приложения, предоставляющие интересующую информацию в контексте местных компаний и других мест поблизости на основе местоположения устройства. Это означает, что вы можете создавать полнофункциональные приложения с учетом мест, которые имеют для пользователя какое-либо значение, и дополнять их удобными возможностями работы с геоданными, которые предлагают службы геолокации Android.

Местом считается физическое пространство, которому присвоено какое-либо название. Также местом можно назвать любой объект, который можно найти на карте. Примерами могут служить местные компании, достопримечательности и географические объекты. В API место представлено интерфейсом Place. Он содержит такую информацию о месте, как его название и адрес, географическое местоположение, идентификатор места, номер телефона, тип места, URL-адрес веб-сайта и многие другие сведения.

Обзор API

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

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

Выделите свое приложение среди других за счет предоставления актуальной информации об окружающем пространстве.

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

Другие возможности API-интерфейса.

  • Точное определение местоположения в режиме низкого энергопотребления с помощью сканирования Wi-Fi.
  • Кэширование на устройстве. Большинство запросов к Google Places API for Android могут предусматривать двойную передачу данных между устройством и сервером Google, однако у вас есть также возможность хранения кэшированных данных на устройстве до 30 дней.

Поддерживаемые версии платформы Android

Интерфейс Google Places API for Android доступен для всех версий Android, поддерживаемых службами Google Play. Дополнительную информацию см. в руководстве Android по поддержке различных версий платформы.

Настройка приложения

Ниже указаны действия по настройке, которые являются обязательными для всех приложений, использующих Google Places API for Android.

Настройка служб Google Play

Для доступа к Google Places API for Android в проект вашего приложения необходимо включить возможность использования служб Google Play. Загрузите и установите компонент служб Google Play, используя диспетчер SDK, добавьте эту библиотеку в свой проект. Дополнительную информацию см. в руководстве Android по настройке служб Google Play.

Добавление ключа API

Если вы еще не получили ключ API и не разрешили использование Google Places API for Android, следуйте инструкциям в руководстве по регистрации.

Добавьте ключ API в манифест вашего приложения, как показано в примере кода ниже, заменив YOUR_API_KEY на свой ключ API.

<application>
  ...
  <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="YOUR_API_KEY"/>
</application>

Запрос на увеличение лимитов использования

Использование Google Places API for Android является бесплатным и неограниченным для всех приложений. Однако, в целях обеспечения равных условий использования всеми приложениями были введены уровни ограничений на количество запросов к определенным методам.

В Google Places API for Android по умолчанию устанавливается ограничение на 1 000 запросов в течение суток. Если приложение превысит этот лимит, начнут происходить сбои.

Дополнительная точка контроля применяется, когда приложение достигает уровня 150 000 запросов за 24 часа. Если приложение превысит этот лимит, снова начнут происходить сбои.

Если вы ожидаете превышение разрешенного по умолчанию числа запросов, заблаговременно примите меры по увеличению своего лимита. Инструкции содержатся в руководстве по ограничениям на использование.

Подключение к Places API

Ниже перечислены интерфейсы, являющиеся основными компонентами для работы с Google Places API for Android.

  • Интерфейс GeoDataApi обеспечивает доступ к базе данных Google с информацией о местах и местных компаниях.
  • Интерфейс PlaceDetectionApi позволяет быстро получить доступ к информации о текущем местоположении устройства, а также обеспечивает возможность создавать отчеты о том, что устройство находится в определенном месте.

Для подключения к этому API необходимо создать экземпляр клиента API служб Google Play. Для этого в методе onCreate() в своем фрагменте кода или операции создайте экземпляр клиента API-интерфейса Google с помощью GoogleApiClient.Builder. Добавьте необходимые API с помощью конструктора, как показано в следующем примере кода:

import com.google.android.gms.common.api.GoogleApiClient;
import com.google.android.gms.common.api.GoogleApiClient.OnConnectionFailedListener;
import android.support.v4.app.FragmentActivity;

public class MyActivity extends FragmentActivity 
        implements OnConnectionFailedListener {
    private GoogleApiClient mGoogleApiClient;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mGoogleApiClient = new GoogleApiClient
                .Builder(this)
                .addApi(Places.GEO_DATA_API)
                .addApi(Places.PLACE_DETECTION_API)
                .enableAutoManage(this, this)
                .build();
    }

    // TODO: Please implement GoogleApiClient.OnConnectionFailedListener to
    // handle connection failures.
}

Как видно из примера, класс Places предоставляет токены, которые можно передать в GoogleApiClient.Builder для включения интерфейсов GeoDataApi и PlaceDetectionApi.

Подробные сведения об использовании клиента приведены в руководстве Android по доступу к API Google. В частности, ознакомьтесь с руководствами по созданию подключения и обработке ошибок подключения, в которых содержатся более подробные сведения о методах addConnectionCallbacks() и addOnConnectionFailedListener().

Оставить отзыв о...

Текущей странице
location_on
Google Places API for Android