Select platform: [Android](https://developers.google.com/maps/documentation/places/android-sdk/overview.md.txt "View this page for the Android platform docs.") [iOS](https://developers.google.com/maps/documentation/places/ios-sdk/overview.md.txt "View this page for the iOS platform docs.") [JavaScript](https://developers.google.com/maps/documentation/javascript/place.md.txt "View this page for the JavaScript platform docs.") [Web Service](https://developers.google.com/maps/documentation/places/web-service/overview.md.txt "View this page for the Web Service platform docs.") **European Economic Area (EEA) developers**

> [!NOTE]
> If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](https://developers.google.com/maps/comms/eea/faq.md.txt).

> [!NOTE]
> **Before you begin:** Before you start using the Places SDK for Android, you need a project with a billing account and the Places API enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. To learn more, see [Set up in Cloud console](https://developers.google.com/maps/documentation/places/android-sdk/cloud-setup).

## Introduction

The Places SDK for Android lets you build location-aware apps that respond
contextually to the local businesses and other places near the user's device. This means you
can build rich apps based on places that mean something to the user, to complement the
straightforward geographic-based services offered by the
[Android location services](https://developer.android.com/training/location/index.html).

> [!NOTE]
> **Note:** Places SDK (New) is the current version of Places SDK for Android. Legacy documentation and migration guides are available on the [Legacy](https://developers.google.com/maps/documentation/places/android-sdk/overview-legacy) tab.

## Concepts

The following interfaces provide the primary entry points to the
Places SDK for Android:

- [`Places`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places.md.txt) provides programmatic access to Google's database of local place and business information, as well as the device's current place.
- [`Autocomplete`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/widget/Autocomplete) provides pre-made widgets to return place predictions in response to user search queries.

A *place* is defined as a physical space that has a name. Another way
of thinking about a place is that it's anything you can find on a map.
Examples include local businesses, points of interest, and geographic
locations. In the API, a place is represented by the
[`Place`](https://developers.google.com/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place.md.txt)
interface. It includes information such as the name of the place and its
address, geographical location, place ID, phone number, place type, website
URL, and more.

> [!NOTE]
> **Note:** Whenever your app displays information about places sourced from the Places SDK for Android, the app must also show all relevant attributions that are returned by the API. See the documentation on [displaying
> attributions](https://developers.google.com/maps/documentation/places/android-sdk/attributions).

## API overview

Help your customers explore where they are and what's around them:

- [Place Autocomplete](https://developers.google.com/maps/documentation/places/android-sdk/place-autocomplete.md.txt) automatically fills in the name and/or address of a place as users type.
- [Place Details](https://developers.google.com/maps/documentation/places/android-sdk/details-place.md.txt) return and display more detailed information about a place.
- [Nearby Search](https://developers.google.com/maps/documentation/places/android-sdk/nearby-search.md.txt) returns a list of places based on a location and a search radius.
- [Place Photos](https://developers.google.com/maps/documentation/places/android-sdk/place-photos.md.txt) returns high-quality images of a place.
- [Text Search](https://developers.google.com/maps/documentation/places/android-sdk/text-search.md.txt) returns places based on a search text string.
- [Place IDs](https://developers.google.com/maps/documentation/places/android-sdk/place-id.md.txt) store the unique ID for one or more places for retrieval of place information on demand.

> [!NOTE]
> **Note:** Google gathers anonymous usage statistics.

## Policies and Terms

All applications that use the Places SDK for Android must adhere
to the requirements described in the
[Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms),
[Usage and Billing](https://developers.google.com/maps/documentation/places/android-sdk/usage-and-billing.md.txt), and
[Displaying Attributions](https://developers.google.com/maps/documentation/places/android-sdk/attributions).