L'API Places supporta l'attuale Place Photo. Se conosci già Place Photo, la nuova versione di Place Photo apporta le seguenti modifiche:
- Il nuovo servizio Place Photo richiede di passare il nome risorsa della foto, che include l'ID luogo nell'URL della richiesta, anziché solo il riferimento della foto. Per maggiori informazioni, consulta Passare ai riferimenti delle foto.
- Il nuovo servizio Place Photo supporta sia chiavi API sia token OAuth come meccanismo di autenticazione.
La seguente tabella elenca i parametri nella foto del luogo esistente che sono stati rinominati o modificati per la nuova foto del luogo o i parametri che non sono più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
maxheight |
maxHeightPx |
Devi specificare maxHeightPx,
maxWidthPx o entrambi. |
maxwidth |
maxWidthPx |
Devi specificare maxHeightPx,
maxWidthPx o entrambi. |
Dimensione foto aumentata
La Place Photo esistente supportava una dimensione massima di 1600 x 1600 pixel. Place Photo (New) supporta dimensioni fino a 4800 x 4800 pixel.
Passa ai riferimenti alle foto
La nuova API Place Photo richiede il passaggio del nome risorsa della foto richiesta, che include un ID luogo e il riferimento foto, nel modulo:
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 testuale e Dettagli luogo restituiscono tutte un array photos[] nella risposta che supporta questo formato. Ogni elemento 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 esistente, devi solo passare il riferimento foto nel modulo:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Gli elementi Trova luogo,
Ricerca nelle vicinanze, Ricerca testuale e
Dettagli luogo esistenti restituiscono 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 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.