L'API Places supporta le foto dei luoghi esistenti. Se conosci la foto di luogo esistente, la nuova versione di Foto di luogo apporta le seguenti modifiche:
- Il nuovo servizio Foto luogo richiede di indicare il nome della risorsa della foto, che include l'ID luogo nell'URL della richiesta, anziché solo il riferimento alla foto. Per ulteriori informazioni, consulta Passare ai riferimenti fotografici.
- Il nuovo servizio Foto di 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.
Passare ai 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, Text Search e Dettagli sui luoghi tutte 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 attribuzioni richieste. Questo campo è sempre presente, ma potrebbe essere vuoto.
Con l'API esistente, devi solo passare il riferimento della foto, nel formato:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Le attuali richieste Trova luogo, Ricerca nelle vicinanze, Ricerca di testo e Dettagli sul luogo 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 attribuzioni richieste. Questo campo è sempre presente, ma potrebbe essere vuoto.