Migrate to Place Photos (New)

Project: /maps/documentation/places/web-service/_project.yaml Book: /maps/documentation/places/web-service/_book.yaml

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

  • Place Photos (New) requires that you pass the resource name of the photo, which includes the place ID in the request URL, instead of just the photo reference. For more information, see Change to photo references.
  • Place Photos (New) supports both API keys and OAuth tokens as the authentication mechanism.

The following table lists parameters in Place Photos (Legacy) that have been renamed or modified for Place Photos (New), or parameters that are no longer supported.

Current parameter New parameter Notes
maxheight maxHeightPx You must specify either maxHeightPx, maxWidthPx, or both.
maxwidth maxWidthPx You must specify either maxHeightPx, maxWidthPx, or both.

Increased photo size

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

Change to photo references

Place Photos (New) API requires that you pass the resource name of the requested photo, which includes a place ID and the photo reference, in the form:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

Nearby Search (New), Text Search (New), and Place Details (New) all return a photos[] array in the response that supports this format. Each element of photos[] in the new response contains the following fields:

  • name — A string containing the resource name of the photo. This string is in the form:

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx — The maximum height of the image, in pixels.
  • widthPx — The maximum width of the image, in pixels.
  • authorAttributions[] — Any required attributions. This field is always present, but might be empty.

With the legacy API, you only have to pass the photo reference, in the form:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Find Place (Legacy), Nearby Search (Legacy), Text Search (Legacy), and Place Details (Legacy) all return a photos[] array in the response that supports this format. Each photo element in the legacy response contains the following fields:

  • photo_reference — A string used to identify the photo when you perform a Photo request.
  • height — The maximum height of the image.
  • width — The maximum width of the image.
  • html_attributions[] — Any required attributions. This field is always present, but might be empty.