L'API Places supporta l'attuale foto del luogo. Se hai dimestichezza con la foto del luogo esistente, la nuova versione di Place Photo apporta le seguenti modifiche:
- Il nuovo servizio Place Photo richiede il passaggio del nome risorsa della foto, che include l'ID luogo nell'URL della richiesta, anziché solo il riferimento della foto. Per maggiori informazioni, vedi Passare ai riferimenti alle foto.
- Il nuovo servizio Place Photo supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
Nella tabella seguente sono elencati i parametri nella foto del luogo esistente che sono stati rinominati o modificati per la nuova foto del luogo oppure i parametri non più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
maxheight |
maxHeightPx |
Devi specificare maxHeightPx,
maxWidthPx o entrambi. |
maxwidth |
maxWidthPx |
Devi specificare maxHeightPx,
maxWidthPx o entrambi. |
Dimensioni foto aumentate
La foto del luogo esistente supportava una dimensione massima delle foto di 1600 x 1600 pixel. Place Photo (Nuova) 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 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 testuale e Dettagli luogo 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 risorsa della foto. Questa stringa ha il 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 obbligatorie. Questo campo è sempre presente, ma potrebbe essere vuoto.
Con l'API esistente, devi solo passare il riferimento della foto, nel modulo:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Trova luogo,
Ricerca nelle vicinanze, Ricerca testuale e
Dettagli luogo esistenti restituiscono tutti 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 obbligatorie. Questo campo è sempre presente, ma potrebbe essere vuoto.