Introduzione
L'API Places (nuova) offre prestazioni migliorate e un nuovo modello di prezzo, il che rende conveniente l'aggiornamento delle app che utilizzano l'API Places (legacy). Per maggiori dettagli sul confronto delle funzionalità, consulta Scegli l'API.
Utilizza questa guida per comprendere le principali differenze tra l'API Places (nuova) e l'API Places (legacy), nonché come gestire le modifiche necessarie.
Best practice per la fatturazione per la migrazione
Queste indicazioni si applicano se l'utilizzo dell'API è sufficientemente elevato da passare ai prezzi di secondo livello. Quando esegui la migrazione a una versione più recente di un'API, ti viene addebitato anche un altro SKU. Per evitare un aumento dei costi durante il mese della transizione, ti consigliamo di passare alle nuove API in produzione il più vicino possibile all'inizio del mese. In questo modo, ti assicurerai di raggiungere i livelli di prezzo mensili più convenienti durante il mese di migrazione. Per informazioni sui livelli di prezzo, consulta la pagina dei prezzi e le domande frequenti sui prezzi.
Abilitare l'API Places (New)
Per utilizzare le funzionalità dell'API Places (New), devi prima abilitare l'API Places (New) nel tuo progetto Google Cloud. Per saperne di più, consulta Configura il progetto Google Cloud.
Dopodiché, devi assicurarti di aver aggiunto l'API Places (novità) alla chiave API utilizzata dalla tua app. Per ulteriori informazioni, consulta Utilizzare le chiavi API.
Modifiche generali
Alcune modifiche generali che si applicano a più API includono:
- Tutte le nuove API supportano sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- È supportato solo JSON come formato di risposta.
- La maschera del campo è richiesta da Place Details (New), Nearby Search (New) e Ricerca testuale (New) per specificare i campi che vuoi che vengano restituiti nella risposta. Per saperne di più, consulta FieldMask.
- Le API Nearby Search (New) e Text Search (New) ora restituiscono i dettagli completi del luogo in modo che corrispondano a quelli restituiti da Place Details (New).
- Il formato della risposta JSON per le API Place Details (New), Nearby Search (New) e Ricerca testuale (New) è cambiato rispetto a quello delle API esistenti. Per maggiori dettagli, vedi Eseguire la migrazione della risposta dell'API Places.
Modifiche specifiche per l'API
Questa sezione include le seguenti guide alla migrazione per ogni API:
- Eseguire la migrazione a Nearby Search (novità)
- Esegui la migrazione alla ricerca testuale (novità)
- Eseguire la migrazione a Place Details (novità)
- Esegui la migrazione a Foto dei luoghi (novità)
- Esegui la migrazione ad Autocomplete (New)