L'API Places supporta Foto del luogo. Se hai familiarità con Place Photo esistente, nuova versione di Place Photo apporta le seguenti modifiche:
- Il nuovo servizio Place Photo richiede passa il nome risorsa della foto, che include l'ID luogo nella l'URL di richiesta, anziché solo il riferimento della foto. Per ulteriori informazioni, vedi Passa ai riferimenti alle foto.
- Il nuovo servizio Place Photo supporta sia Chiavi API e OAuth come meccanismo di autenticazione.
Nella tabella seguente sono elencati i parametri nell'elenco Foto del luogo che sono state rinominate o modificate per una nuova foto del luogo o parametri che non sono più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
maxheight |
maxHeightPx |
Devi specificare maxHeightPx,
maxWidthPx o entrambe. |
maxwidth |
maxWidthPx |
Devi specificare maxHeightPx,
maxWidthPx o entrambe. |
Dimensioni foto aumentate
La foto del luogo esistente supportava un numero massimo di foto di 1600 x 1600 pixel. Foto del luogo (novità) supporta dimensioni fino a 4800 x 4800 pixel.
Passa ai riferimenti alle foto
Il nuovo Foto del luogo L'API richiede il passaggio del nome risorsa della foto richiesta, che Includa un ID luogo e il riferimento della foto, nella seguente forma:
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 sui luoghi
restituiscono tutti un array photos[] nella risposta che supporta questo formato. Ciascuna
l'elemento photos[] nella nuova risposta contiene i seguenti campi:
name: una stringa contenente il nome risorsa del 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 è 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
L'attuale Trova luogo,
Nearby Search, Text Search e
Place Details restituiscono tutti un array photos[] in
che supporta questo formato. Ogni elemento photo nella struttura
contiene i seguenti campi:
photo_reference: una stringa utilizzata per identificare la foto quando per eseguire una richiesta di foto.height: l'altezza massima dell'immagine.width: la larghezza massima dell'immagine.html_attributions[]: eventuali attribuzioni obbligatorie. Questo è sempre presente, ma potrebbe essere vuoto.