Android use google api

Accessing Google APIs

In this document

When you want to make a connection to one of the Google APIs provided in the Google Play services library (such as Google+, Games, or Drive), you need to create an instance of GoogleApiClient («Google API Client»). The Google API Client provides a common entry point to all the Google Play services and manages the network connection between the user’s device and each Google service.

Connecting to REST APIs

If the Google API you want to use is not included in the Google Play services library, you can connect using the appropriate REST API, but you must obtain an OAuth 2.0 token. For more information, read Authorizing with Google for REST APIs.

This guide shows how you can use Google API Client to:

• Connect to one or more Google Play services asynchronously and handle failures.
• Perform synchronous and asynchronous API calls to any of the Google Play services.

Note: If you have an existing app that connects to Google Play services with a subclass of GooglePlayServicesClient , you should migrate to GoogleApiClient as soon as possible.

Figure 1. An illustration showing how the Google API Client provides an interface for connecting and making calls to any of the available Google Play services such as Google Play Games and Google Drive.

To get started, you must first install the Google Play services library (revision 15 or higher) for your Android SDK. If you haven’t done so already, follow the instructions in Set Up Google Play Services SDK.

Start a Connection

Once your project is linked to the Google Play services library, create an instance of GoogleApiClient using the GoogleApiClient.Builder APIs in your activity’s onCreate() method. The GoogleApiClient.Builder class provides methods that allow you to specify the Google APIs you want to use and your desired OAuth 2.0 scopes. For example, here’s a GoogleApiClient instance that connects with the Google Drive service:

You can add multiple APIs and multiple scopes to the same GoogleApiClient by appending additional calls to )» > addApi() and addScope() .

Important: If you are adding multiple APIs to a GoogleApiClient , you may run into client connection errors on devices that do not have the Android Wear app installed. To avoid connection errors, call the , com.google.android.gms.common.api.Scope. )»> addApiIfAvailable() method and pass in the Wearable API to indicate that your client should gracefully handle the missing API. For more information, see Access the Wearable API.

Before you can begin a connection by calling connect() on the GoogleApiClient , you must specify an implementation for the callback interfaces, ConnectionCallbacks and OnConnectionFailedListener . These interfaces receive callbacks in response to the asynchronous connect() method when the connection to Google Play services succeeds, fails, or becomes suspended.

For example, here’s an activity that implements the callback interfaces and adds them to the Google API Client:

With the callback interfaces defined, you’re ready to call connect() . To gracefully manage the lifecycle of the connection, you should call connect() during the activity’s onStart() (unless you want to connect later), then call disconnect() during the onStop() method. For example:

However, if you run this code, there’s a good chance it will fail and your app will receive a call to onConnectionFailed() with the SIGN_IN_REQUIRED error because the user account has not been specified. The next section shows how to handle this error and others.

Handle connection failures

When you receive a call to the onConnectionFailed() callback, you should call hasResolution() on the provided ConnectionResult object. If it returns true, you can request the user take immediate action to resolve the error by calling startResolutionForResult() on the ConnectionResult object. The startResolutionForResult() behaves the same as startActivityForResult() and launches the appropriate activity for the user to resolve the error (such as an activity to select an account).

If hasResolution() returns false, you should instead call GooglePlayServicesUtil.getErrorDialog() , passing it the error code. This returns a Dialog provided by Google Play services that’s appropriate for the given error. The dialog may simply provide a message explaining the error, but it may also provide an action to launch an activity that can resolve the error (such as when the user needs to install a newer version of Google Play services).

For example, your onConnectionFailed() callback method should now look like this:

Once the user completes the resolution provided by startResolutionForResult() or GooglePlayServicesUtil.getErrorDialog() , your activity receives the onActivityResult() callback with the RESULT_OK result code. You can then call connect() again. For example:

In the above code, you probably noticed the boolean, mResolvingError . This keeps track of the app state while the user is resolving the error to avoid repetitive attempts to resolve the same error. For instance, while the account picker dialog is showing to resolve the SIGN_IN_REQUIRED error, the user may rotate the screen. This recreates your activity and causes your onStart() method to be called again, which then calls connect() again. This results in another call to startResolutionForResult() , which creates another account picker dialog in front of the existing one.

This boolean is effective only if retained across activity instances, though. The next section explains further.

Maintain state while resolving an error

To avoid executing the code in onConnectionFailed() while a previous attempt to resolve an error is ongoing, you need to retain a boolean that tracks whether your app is already attempting to resolve an error.

As shown in the code above, you should set a boolean to true each time you call startResolutionForResult() or display the dialog from GooglePlayServicesUtil.getErrorDialog() . Then when you receive RESULT_OK in the onActivityResult() callback, set the boolean to false .

To keep track of the boolean across activity restarts (such as when the user rotates the screen), save the boolean in the activity’s saved instance data using onSaveInstanceState() :

Then recover the saved state during onCreate() :

Now you’re ready to safely run your app and connect to Google Play services. How you can perform read and write requests to any of the Google Play services using GoogleApiClient is discussed in the next section.

For more information about each services’s APIs available once you’re connected, consult the corresponding documentation, such as for Google Play Games or Google Drive.

Access the Wearable API

The Wearable API provides a communication channel for your handheld and wearable apps. The API consists of a set of data objects that the system can send and synchronize over the wire and listeners that notify your apps of important events with the data layer. The Wearable API is available on devices running Android 4.3 (API level 18) or higher when a wearable device is connected. The API is not available under the following conditions:

• Devices running Android 4.2 (API level 17) or earlier.
• Android Wear companion app is not installed on the device.
• Android Wear device is not connected.

Using only the Wearable API

If your app uses the Wearable API but not other Google APIs, you can add this API by calling the )» > addApi() method. The following example shows how to add the Wearable API to your GoogleApiClient instance:

In situations where the Wearable API is not available, connection requests that include the Wearable API fail with the API_UNAVAILABLE error code.

The following example shows how to determine whether the Wearable API is available:

Using the Wearable API with other APIs

If your app uses the Wearable API in addition to other Google APIs, call the , com.google.android.gms.common.api.Scope. )»>addApiIfAvailable() method and pass in the Wearable API to indicate that your client should gracefully handle the missing API.

The following example shows how to access the Wearable API along with the Drive API:

In the example above, the GoogleApiClient can successfully connect with the Google Drive service without connecting to the Wearable API if it is unavailable. After you connect your GoogleApiClient instance, ensure that the Wearable API is available before making the API calls:

Communicate with Google Services

Once connected, your client can make read and write calls using the service-specific APIs for which your app is authorized, as specified by the APIs and scopes you added to your GoogleApiClient instance.

Note: Before making calls to specific Google services, you may first need to register your app in the Google Developer Console. For specific instructions, refer to the appropriate getting started guide for the API you’re using, such as Google Drive or Google+.

When you perform a read or write request using Google API Client, the immediate result is returned as a PendingResult object. This is an object representing the request, which hasn’t yet been delivered to the Google service.

For example, here’s a request to read a file from Google Drive that provides a PendingResult object:

Once you have the PendingResult , you can continue by making the request either asynchronous or synchronous.

Using asynchronous calls

To make the request asynchronous, call )» > setResultCallback() on the PendingResult and provide an implementation of the ResultCallback interface. For example, here’s the request executed asynchronously:

When your app receives a Result object in the onResult() callback, it is delivered as an instance of the appropriate subclass as specified by the API you’re using, such as DriveApi.MetadataBufferResult .

Using synchronous calls

If you want your code to execute in a strictly defined order, perhaps because the result of one call is needed as an argument to another, you can make your request synchronous by calling await() on the PendingResult . This blocks the thread and returns the Result object when the request completes, which is delivered as an instance of the appropriate subclass as specified by the API you’re using, such as DriveApi.MetadataBufferResult .

Because calling await() blocks the thread until the result arrives, it’s important that you never perform this call on the UI thread. So, if you want to perform synchronous requests to a Google Play service, you should create a new thread, such as with AsyncTask in which to perform the request. For example, here’s how to perform the same file request to Google Drive as a synchronous call:

Tip: You can also enqueue read requests while not connected to Google Play services. For example, execute a method to read a file from Google Drive regardless of whether your Google API Client is connected yet. Then once a connection is established, the read requests execute and you’ll receive the results. Any write requests, however, will generate an error if you call them while your Google API Client is not connected.

Источник

Google MAPs API в android или как работать с картами быстрее

Принцип работы Google MAPs API

Вся документация для работы с картами приведена на (логично) официальном сайте google maps api. Сегодня я рассматриваю только Directions API (документация). Для того что бы получить какую-либо информацию от большого числа, вам необходимо сделать запрос. Ответ прийдет в формате JSON.

Общий вид запроса:

Пример: https://maps.googleapis.com/maps/api/directions/json?origin=55.754724,%2037.621380&destination=55.728466,%2037.604155&key=»Your MAPs API key»

В качестве ответа нам (ожидаемо) пришел JSON с большим набором разных точек с координатами и названиями этих мест.

А как вообще работать с этой страшной штукой?

Если вы только начинаете работать с Android, то советую вам почитать про такую замечательную библиотеку Retrofit, которая превращает работу с запросами в код из 2 строк. Рассматривать сейчас я её не буду.

Но я сегодня хочу рассмотреть пример использования библиотеки Java Client for Google Maps Services. Библиотека как по мне замечательная, освобождает от необходимости писать (пусть даже очень короткие) запросы вручную и отлично подходит в случаях когда нужно писать очень быстро, как например на хакатоне. Я хочу показать живой пример использования данной библиотеки на примере работы с Directions API.

Подключение библиотеки

Для начала нам потребуется получить ключ для нашего приложения. Топаем на оф. сайт, находим сверху кнопку «получить ключ», создаем новый проект, нажимаем далее и готово!
UPD: теперь бесплатно получить нельзя. С лета 2018 года Google обновили план и необходимо ввести данные своей карты для получения 200$ для запросов каждый месяц бесплатно. Этого должно хватать, но конечно тенденция не радует.

Firebase
Для правильной работы приложения нам необходимо получить файл google-service.json. Идем на firebase выбираем наш проект и добавляем его. Далее нам нужно выбрать Android проект, ввести название пакета, регистрируем приложение. Скачиваем файл и перетаскиваем в папку app. К слову её не будет видно в дереве проекта, для этого надо в Android Studio поменять отображение с Android на Project или залезть в наш проект через файловый менеджер. Далее следуем инструкциям где какой код писать.

Включаем в консоли
Так же нам необходимо включить Directions API (или любую другую необходимую вам API) в консоли, для этого идем сюда, выбираем наше приложение и включаем Directions API.

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

Обязательно проверяйте, актуальная ли это сейчас версия!

Встраиваем карту в приложение

Google map в андроид реализовывается как фрагмент (или как MapView, но об этом в другой раз, нам сейчас особой разницы нет). Просто встраиваем его в наш layout. В нашем классе, который работает с картой, необходимо найти эту карту и заимплементить интерфейс.

Код для фрагмента выглядит вот так. Я буду работать с MainActivity, соответственно если вы используете другой класс вам необходимо поменять контекст.

Отлично, фрагмент встроили, Android Studio на нас не ругается, едем дальше. Переходим в MainActivity.class и имплементим интерфейс OnMapReadyCallback.

В onCreate пишем

Так же идем в Manifests и прописываем вот такие штуки внутри тэга application

Где вместо @string/google_maps_key должен подставиться ваш ключ для карт, который мы получили ранее. Соответственно вам нужно создать нужный ресурс в файле string.

Пишем всякие интересности

Отлично, карта у нас есть, давайте наконец напишем хоть что-нибудь интересное. Пусть нашей целью будет нарисовать маршрут по Москве через несколько точек:

• Гум (55.754724, 37.621380)
• Большой театр (55.760133, 37.618697)
• Патриаршие пруды (55.764753, 37.591313)
• Парк культуры (55.728466, 37.604155)

Кладу все наши места в List и делаю это как глобальную переменную.

Для начала создадим по маркеру на каждое место. Маркер это просто объект, которому передаются координаты, а затем они накладываются на карту. Код:

Далее мы пишем вот такой код все в том же методе onMapReady

При запуске приложения мы получили вот такую картину:

Хм, Москва, конечно, весьма запутанная, но не настолько же. Почему же такой странный маршрут нам вернул Google? Потому что он построил маршрут для автомобилей, который идет по умолчанию, но мы можем это изменить. Чтобы построить маршрут для пешеходов, меняем код на:

Теперь наш маршрут выглядит вот так

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

Источник