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 trasmettere 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:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
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:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
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.