Introduzione
L'API Places supporta Place Photos (legacy). Se hai familiarità con Place Photos (legacy), Place Photos (nuovo) apporta le seguenti modifiche:
- Foto dei luoghi (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 |
È necessario specificare maxHeightPx, maxWidthPx o entrambi. |
maxwidth |
maxWidthPx |
Devi specificare maxHeightPx,
maxWidthPx o entrambi. |
Dimensioni della foto aumentate
Place Photos (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 passare il nome della risorsa della foto richiesta, che include un ID del luogo e il riferimento della foto, nel formato:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Le funzioni Ricerca nelle vicinanze (nuova), Ricerca di testo (nuova) e Dettagli luogo (nuova) restituiscono tutte 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— 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 legacy, devi solo passare il riferimento fotografico, nel formato:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Trova luogo (Legacy), Ricerca nelle vicinanze (Legacy), Ricerca di testo (Legacy) e Dettagli luogo (Legacy) restituiscono tutti un array photos[] nella risposta che supporta questo formato. Ogni elemento photo nella risposta legacy contiene i seguenti campi:
photo_reference— Una stringa utilizzata per identificare la foto quando si esegue 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.