Summary: Nested Classes | Fields | Ctors | Methods | Inherited Methods | [Expand All]
public final class

# Address

extends Object

java.lang.Object
↳ | com.google.android.gms.identity.intents.Address

## Class Overview

APIs for accessing a user's address. Calling `requestUserAddress(GoogleApiClient, UserAddressRequest, int)` will prompt the user to select an address to share with your application.

## Summary

Nested Classes
class | Address.AddressOptions | A class that encapsulates options for the Address APIs.

Fields
public static final Api<Address.AddressOptions> | API | Add this to your `GoogleApiClient` via `addApi(Api)`.

Public Constructors
| Address()

Public Methods
static void | requestUserAddress(GoogleApiClient googleApiClient, UserAddressRequest request, int requestCode) API to request an address from a user.

[Expand] Inherited Methods
From class java.lang.Object
Object | clone()
boolean | equals(Object arg0)
void | finalize()
final Class<?> | getClass()
int | hashCode()
final void | notify()
final void | notifyAll()
String | toString()
final void | wait(long arg0, int arg1)
final void | wait(long arg0)
final void | wait()

## Fields

#### public static final Api<Address.AddressOptions> API

Add this to your `GoogleApiClient` via `addApi(Api)`.

## Public Constructors

#### public Address ()

## Public Methods

#### public static void requestUserAddress (GoogleApiClient googleApiClient, UserAddressRequest request, int requestCode)

API to request an address from a user. This will invoke a dialog that allows the user to decide if they want to select a single address to share your app, or alternatively decline to share an address at all. The response to this request is supplied via your Activity's `onActivityResult(int, int, Intent)` callback method.

- If the user selects an address to share, a response code of `RESULT_OK` is returned. You can retrieve the `UserAddress` from the data Intent sent to `onActivityResult(int, int, Intent)` using the `fromIntent(android.content.Intent)` key.
- If the user declines to share an address, a response code of `RESULT_CANCELED` is returned.
- If there is an error retrieving addresses for the user, for example if the user has no applicable addresses, then a response code of `RESULT_ERROR` is returned. You can retrieve the error code from the data Intent using the `EXTRA_ERROR_CODE` key.

##### Parameters

googleApiClient | used to communicate with Google Play Services. This should be configured to use `API`. Must not be null.
request | used to specify what kind of addresses your app can handle. You must pass in a valid `UserAddressRequest` created via `build()`.
requestCode | used `onActivityResult(int, int, Intent)` to identify which request triggered that callback.