L'API Places (nuova) offre prestazioni migliorate e un nuovo modello di prezzi, pertanto vale la pena aggiornare le app che la utilizzano. Per ulteriori dettagli sul confronto delle funzionalità, vedi Scegliere la sua API.
Utilizza questa guida per comprendere le differenze principali dell'API Places (nuova) rispetto all'API Places, 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, viene addebitato anche un SKU diverso. 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, durante il mese di migrazione raggiungerai i livelli di prezzo mensili più convenienti. Per informazioni sui livelli di prezzo, consulta la pagina dei prezzi e le domande frequenti sui prezzi.
Abilita l'API Places (novità)
Per utilizzare le funzionalità dell'API Places (nuova), devi prima attivare l'API Places (nuova) nel tuo progetto Google Cloud. Per ulteriori informazioni, vedi Configurare il progetto Google Cloud.
Poi devi assicurarti di aver aggiunto l'API Places (nuova) 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.
- Come formato di risposta è supportato solo JSON.
- La mascheratura dei campi è obbligatoria per i dettagli dei luoghi (novità), la ricerca nelle vicinanze (novità) e la ricerca di testo (novità) per specificare i campi da restituire nella risposta. Per ulteriori informazioni, consulta FieldMask.
- Le API Ricerca nelle vicinanze (nuova) e Ricerca di testo (nuova) ora restituiscono i dettagli completi dei luoghi in modo che corrispondano a quelli restituiti dall'API Place Details (nuova).
- Il formato della risposta JSON per le API Dettagli dei luoghi (nuova), Ricerca nelle vicinanze (nuova) e Ricerca di testo (nuova) è cambiato rispetto a quello delle API esistenti. Per maggiori dettagli, consulta Eseguire la migrazione della risposta dell'API Places.
Modifiche specifiche per l'API
Questa sezione include le seguenti guide alla migrazione per ogni API: