Place Details

The Places SDK for Android provides your app with rich information about places, including the place's name and address, the geographical location specified as latitude/longitude coordinates, the type of place (such as night club, pet store, museum), and more. To access this information for a specific place, you can use the place ID, a stable identifier that uniquely identifies a place.

Place details

The Place object provides information about a specific place. You can get hold of a Place object in the following ways:

When you request a place, you must specify which types of place data to return. To do this, pass a List<Place.Field>, specifying the data types to return. This is an important consideration, since this will affect the cost for each request. You can use one or more of the following fields:

  • Place.Field.ADDRESS
  • Place.Field.ADDRESS_COMPONENTS
  • Place.Field.ID
  • Place.Field.LAT_LNG
  • Place.Field.NAME
  • Place.Field.OPENING_HOURS
  • Place.Field.PHONE_NUMBER
  • Place.Field.PHOTO_METADATAS
  • Place.Field.PLUS_CODE
  • Place.Field.PRICE_LEVEL
  • Place.Field.RATING
  • Place.Field.TYPES
  • Place.Field.USER_RATINGS_TOTAL
  • Place.Field.VIEWPORT
  • Place.Field.WEBSITE_URI

Learn more about place fields. For more information about how Place data requests are billed, see Usage and Billing.

Use the following methods to retrieve data from a Place:

  • getAddress() – The place's address, in human-readable format.
  • getAddressComponents() – A List of address components for this place. These components are provided for the purpose of extracting structured information about a place's address, for example finding the city in which a place is located. Do not use these components for address formatting; instead, call getAddress(), which provides a localized formatted address.
  • getAttributions() – The attributions that must be shown to the user, if data from the place is used.
  • getID() – The textual identifier for the place. Read more about place IDs in the rest of this page.
  • getLatLng() – The geographical location of the place, specified as latitude and longitude coordinates.
  • getName() – The place's name.
  • getOpeningHours() – The OpeningHours of the place. Call OpeningHours.getWeekdayText() to a return a list of strings that represent opening and closing hours for each day of the week. Call OpeningHours.getPeriods() to return a list of period objects with more detailed information that is equivalent to the data provided by getWeekdayText(). Note: If a place is always open, the time period is represented as Sunday at midnight, and the closeEvent is null.
  • getPhoneNumber() – The place's phone number.
  • getPhotoMetadatas() – The metadata associated with a photo associated with the place, including the bitmap image.
  • getPlusCode() – The PlusCode location of this Place.
  • getPriceLevel() – The price level for this place, returned as an integer with values ranging from 0 (cheapest) to 4 (most expensive).
  • getRating() – An aggregated rating of the place, returned as a float with values ranging from 1.0 to 5.0, based on aggregated user reviews.
  • getTypes() – A list of place types that characterize this place. For a list of available place types, see the documentation for the Place interface.
  • getUserRatingsTotal() – The total number of user ratings of this Place.
  • getViewport() – A viewport, returned as a LatLngBounds object, useful for displaying the place on a map. May return null if the size of the place is not known.
  • getWebsiteUri() – The URI of the place's website, if known. This is the website maintained by the business or other entity associated with the place. Returns null if no website is known.

Some simple examples:

final CharSequence name = place.getName();
final CharSequence address = place.getAddress();
final LatLng location = place.getLatLng();

Get a place by ID

A place ID is a textual identifier that uniquely identifies a place. In the Places SDK for Android, you can retrieve the ID of a place by calling Place.getId(). The Place Autocomplete service also returns a place ID for each place that matches the supplied search query and filter. You can store the place ID and use it to retrieve the Place object again later.

To get a place by ID, call PlacesClient.fetchPlace(), passing a FetchPlaceRequest.

The API returns a FetchPlaceResponse in a Task. The FetchPlaceResponse contains a Place object matching the supplied place ID.

The following code example shows calling fetchPlace() to get details for the specified place.

// Define a Place ID.
String placeId = "INSERT_PLACE_ID_HERE";

// Specify the fields to return (in this example all fields are returned).
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Construct a request object, passing the place ID and fields array.
FetchPlaceRequest request = FetchPlaceRequest.builder(placeId, placeFields).build();

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    Log.i(TAG, "Place found: " + place.getName());
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        ApiException apiException = (ApiException) exception;
        int statusCode = apiException.getStatusCode();
        // Handle error with given status code.
        Log.e(TAG, "Place not found: " + exception.getMessage());
    }
});

Display attributions in your app

When your app displays place information, the app must also display attributions. See the documentation on attributions.

More about place IDs

The place ID used in the Places SDK for Android is the same identifier as used in the Places API. Each place ID can refer to only one place, but a single place can have more than one place ID. There are other circumstances which may cause a place to get a new place ID. For example, this may happen if a business moves to a new location.

When you request a place by specifying a place ID, you can be confident that you will always receive the same place in the response (if the place still exists). Note, however, that the response may contain a place ID that is different from the one in your request.

For more information, see the place ID overview.