Foto di Place (nuovo) richiede di
superare il nome della risorsa della foto, che include l'ID luogo nell'URL
della richiesta, anziché solo il riferimento alla foto. Per saperne di più, vedi
Passare ai riferimenti fotografici.
Place Photos (New) supporta sia le
chiavi API
sia i token OAuth
come meccanismo di autenticazione.
La tabella seguente elenca i parametri di
Foto dei luoghi (legacy) che sono stati rinominati o
modificati per Foto dei luoghi (nuovo) oppure i parametri
che non sono più supportati.
Parametro corrente
Nuovo parametro
Note
maxheight
maxHeightPx
Devi specificare maxHeightPx,
maxWidthPx o entrambi.
maxwidth
maxWidthPx
Devi specificare maxHeightPx,
maxWidthPx o entrambi.
Aumento delle dimensioni delle foto
Foto di Place (legacy) supportava una dimensione massima delle foto di 1600 x 1600 pixel. Foto di Place (nuovo)
supporta dimensioni fino a 4800 x 4800 pixel.
Passare ai riferimenti fotografici
L'API Place Photos (New)
richiede di trasmettere il nome della risorsa della foto richiesta, che
include un ID luogo e il riferimento foto, nel formato:
Ricerca nelle vicinanze (nuova),
Ricerca di testo (nuova) e
Dettagli luogo (nuovi)
restituiscono tutti un array photos[] nella risposta che supporta questo formato. Ogni
elemento di photos[] nella nuova risposta contiene i seguenti campi:
name: una stringa contenente il nome della risorsa della foto. Questa stringa ha il seguente formato:
places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx: l'altezza massima dell'immagine, in pixel.
widthPx: la larghezza massima dell'immagine, in pixel.
authorAttributions[]: eventuali attribuzioni richieste. Questo
campo è sempre presente, ma potrebbe essere vuoto.
Con l'API precedente, devi solo passare il riferimento alla foto, nel formato:
Find Place (legacy),
Nearby Search (legacy),
Text Search (legacy) e
Place Details (legacy) restituiscono tutti un array photos[] nella
risposta che supporta questo formato. Ogni elemento photo nella risposta precedente contiene i seguenti campi:
photo_reference: una stringa utilizzata per identificare la foto quando
esegui una richiesta di foto.
height: l'altezza massima dell'immagine.
width: la larghezza massima dell'immagine.
html_attributions[]: eventuali attribuzioni richieste. Questo
campo è sempre presente, ma potrebbe essere vuoto.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Migrate to Place Photos (New)\n\n**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](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nIntroduction\n------------\n\nThe Places API supports\n[Place Photos (Legacy)](/maps/documentation/places/web-service/photos).\nIf you are familiar with Place Photos (Legacy),\n[Place Photos (New)](/maps/documentation/places/web-service/place-photos)\nmakes the following changes:\n\n- 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](#photo-ref).\n- Place Photos (New) supports both [API keys](/maps/documentation/places/web-service/get-api-key) and [OAuth](/maps/documentation/places/web-service/oauth-token) tokens as the authentication mechanism.\n\nThe following table lists parameters in\nPlace Photos (Legacy) that have been renamed or\nmodified for Place Photos (New), or parameters\nthat are no longer supported.\n\n| Current parameter | New parameter | Notes |\n|-------------------|---------------|---------------------------------------------------------------|\n| `maxheight` | `maxHeightPx` | You must specify either `maxHeightPx`, `maxWidthPx`, or both. |\n| `maxwidth` | `maxWidthPx` | You must specify either `maxHeightPx`, `maxWidthPx`, or both. |\n\n### Increased photo size\n\nPlace Photos (Legacy) supported a maximum photo\nsize of 1600 by 1600 pixels. Place Photos (New)\nsupports sizes up to 4800 by 4800 pixels.\n\n### Change to photo references\n\n[Place Photos (New)](/maps/documentation/places/web-service/place-photos)\nAPI requires that you pass the *resource name* of the requested photo, which\nincludes a **place ID** and the **photo reference**, in the form: \n\n```json\nhttps://places.googleapis.com/v1/places/\u003cvar translate=\"no\"\u003ePLACE_ID\u003c/var\u003e/photos/\u003cvar translate=\"no\"\u003ePHOTO_REFERENCE\u003c/var\u003e/media?maxWidthPx=400&key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\n```\n\nNearby Search (New),\nText Search (New), and\nPlace Details (New)\nall return a `photos[]` array in the response that supports this format. Each\nelement of `photos[]` in the new response contains the following fields:\n\n- `name` --- A string containing the resource name of the\n photo. This string is in the form:\n\n ```\n places/PLACE_ID/photos/PHOTO_REFERENCE\n ```\n- `heightPx` --- The maximum height of the image, in pixels.\n- `widthPx` --- The maximum width of the image, in pixels.\n- `authorAttributions[]` --- Any required attributions. This field is always present, but might be empty.\n\nWith the legacy API, you only have to pass the **photo reference**, in the\nform: \n\n```json\nhttps://maps.googleapis.com/maps/api/place/photo?photo_reference=\u003cvar translate=\"no\"\u003ePHOTO_REFERENCE\u003c/var\u003emaxwidth=400&key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\n```\n\nFind Place (Legacy),\nNearby Search (Legacy),\nText Search (Legacy), and\nPlace Details (Legacy) all return a `photos[]` array in\nthe response that supports this format. Each `photo` element in the legacy\nresponse contains the following fields:\n\n- `photo_reference` --- A string used to identify the photo when you perform a Photo request.\n- `height` --- The maximum height of the image.\n- `width` --- The maximum width of the image.\n- `html_attributions[]` --- Any required attributions. This field is always present, but might be empty.\n\n| **Note:** The `photo_reference` field does not include the place ID. If you want to use Place Photos (New) with these legacy APIs, you must add the place ID to construct the full resource name."]]
