Esegui la migrazione a Place Photo (novità)

L'API Places supporta Place Photo (legacy). Se conosci la funzionalità Aggiungi foto (legacy), Aggiungi foto (nuova) apporta le seguenti modifiche:

  • La foto del luogo (nuova) 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.
  • Foto del luogo (nuova) 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 (nuova) 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 funzionalità Foto in primo piano (legacy) supportava dimensioni massime di 1600 x 1600 pixel. La funzionalità Inserisci foto (nuova) supporta dimensioni fino a 4800 x 4800 pixel.

Passare ai riferimenti fotografici

L'API Place Photo (nuova) richiede di passare il nome della risorsa della foto richiesta, che include un ID luogo e il riferimento alla foto, nel seguente formato:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

Ricerca nelle vicinanze (novità), Text Search (novità) e Dettagli dei luoghi (novità) 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 è 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

Trova luogo (legacy), Ricerca nelle vicinanze (legacy), Ricerca di testo (legacy) e Dettagli sul 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 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.