Migrate from Place Photos (Legacy) to Place Photos (New)

European Economic Area (EEA) developers

If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region. Learn more.

This feature requires that you enable Places API (New), the next generation of the Places API. For more information, see Enable APIs.

Places SDK for Android supports Place Photos (Legacy). If you are familiar with Place Photos (Legacy), Place Photos (New) makes the following changes:

• Uses a new pricing model. For pricing information for all APIs, see Places SDK for Android (New).

• Place Photos (Legacy) returns a bitmap image. Place Photos (New) returns a URI to the image.

• Place Photos (Legacy) supported a maximum photo size of 1600 by 1600 pixels. Place Photos (New) supports sizes up to 4800 by 4800 pixels.

• To make a request, call the new PlacesClient.fetchResolvedPhotoUri() method.

  For more information, see Use API Keys.

• Pass to the request an object of the new FetchResolvedPhotoUriRequest class.

• Each photo in the response is represented by a PhotoMetadata object. For Places SDK for Android (New) the PhotoMetadata object contains a new PhotoMetadata.getAuthorAttributions() method that returns an object of type AuthorAttributions.

  If the returned PhotoMetadata object includes any attributions or author attribution, you must include these attributions in your application wherever you display the image. See the documentation on attributions.

• To access the new author attributions in PhotoMetadata you must initialize your app by calling the Places.initializeWithNewPlacesApiEnabled() method. For more information on selecting the Places API service, see Set up your Google Cloud project.

Example request

For a complete example, see Place Photos (New).