L'API Places supporta la funzionalità Foto del luogo esistente. Se conosci la funzionalità Foto dei luoghi esistente, la nuova versione di Foto dei luoghi apporta le seguenti modifiche:
- Il nuovo servizio di foto dei luoghi richiede di trasmettere il nome della risorsa della foto, che include l'ID luogo nell'URL della richiesta, anziché solo il riferimento della foto. Per ulteriori informazioni, consulta Passare ai riferimenti fotografici.
- Il nuovo servizio Foto dei luoghi supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
La tabella seguente elenca i parametri della Foto di luogo esistenti che sono stati rinominati o modificati per la nuova Foto di luogo o 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. |
Dimensioni delle foto aumentate
La foto del luogo esistente supportava una dimensione massima di 1600 x 1600 pixel. La funzionalità Inserisci foto (nuova) supporta dimensioni fino a 4800 x 4800 pixel.
Modificare i riferimenti fotografici
La nuova API Place Photo richiede di passare il nome della risorsa della foto richiesta, che include un ID luogo e il riferimento foto, nel seguente formato:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Le nuove versioni di Ricerca nelle vicinanze,
Ricerca di testo e Dettagli dei luoghi
tutti restituiscono 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 è nel 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 riconoscimenti obbligatori. Questo campo è sempre presente, ma potrebbe essere vuoto.
Con l'API esistente, devi solo passare il riferimento della foto, nel modo seguente:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Le funzionalità Trova un luogo, Ricerca nelle vicinanze, Ricerca di testo e Dettagli sui luoghi esistenti restituiscono tutte un array photos[] nella risposta che supporta questo formato. Ogni elemento photo nella risposta esistente contiene i seguenti campi:
photo_reference: una stringa utilizzata per identificare la foto quando effettui una richiesta di foto.height: l'altezza massima dell'immagine.width: la larghezza massima dell'immagine.html_attributions[]: eventuali riconoscimenti obbligatori. Questo campo è sempre presente, ma potrebbe essere vuoto.