Places SDK for Android (New) offre prestazioni migliorate e un nuovo modello di prezzi, il che rende utile aggiornare le app che utilizzano Places SDK for Android (Legacy). Per ulteriori dettagli sul confronto delle funzionalità, vedi Scegliere l'SDK.
Utilizza questa guida per comprendere le principali differenze tra Places SDK for Android (New) e Places SDK for Android (Legacy), nonché come gestire le modifiche necessarie.
Best practice di fatturazione per la migrazione
Queste indicazioni si applicano se l'utilizzo dell'API è sufficientemente elevato da passare al secondo livello di prezzo. Quando esegui la migrazione a una versione più recente di un'API, ti viene addebitato anche un SKU diverso. Per evitare costi maggiori durante il mese di transizione, ti consigliamo di passare alle nuove API in produzione il più vicino possibile all'inizio del mese. In questo modo, durante il mese della 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.
Abilitare l'API Places (New)
Places SDK for Android (legacy) si basa sul servizio Places API. Per utilizzare le funzionalità di Places SDK for Android (New), devi prima attivare l'API Places (New) nel tuo progetto Google Cloud. Per maggiori informazioni, vedi Configurare il progetto Google Cloud.
Devi quindi assicurarti di aver aggiunto l'API Places (New) all'elenco delle API autorizzate nella chiave utilizzata dalla tua app. Per ulteriori informazioni, consulta Utilizzare le chiavi API.
Assicurati di avere una quota sufficiente nell'API Places (novità)
Assicurati che ci sia una quota sufficiente nell'API Places (New) per coprire il traffico attuale. Per esaminare e gestire le quote e i limiti di utilizzo, consulta Quote e avvisi relativi alle quote.
Nota la differenza:
- La quota per Places SDK for Android (legacy) si basa sulla quota del servizio API Places. È la somma di tutti i metodi dell'API Places.
- La quota per Places SDK for Android (New) si basa sulla quota del servizio Places API (New). Esiste una quota separata per ogni metodo API.
Verifica se l'accordo negoziato include l'API Places (nuova)
Se hai un contratto negoziato, verifica che copra l'API Places (New) con i prezzi previsti. In caso contrario, contatta il tuo contatto commerciale di Google o il tuo partner per discutere di come includere questa API.
Modifiche generali
Alcune modifiche generali che si applicano a più API includono:
Utilizza un nuovo modello di prezzi. Per informazioni sui prezzi di tutte le API, consulta Places SDK for Android (New).
Devi inizializzare l'app chiamando il metodo
Places.initializeWithNewPlacesApiEnabled()
. Per maggiori informazioni sulla selezione del servizio API Places, vedi Configurare il progetto Google Cloud.Place Details (New), Nearby Search (New) e Text Search (New) richiedono maschere di campo per specificare i campi che vuoi vengano restituiti nella risposta.
Sono state aggiunte nuove classi per definire le richieste o per aggiungere nuovi campi alla risposta.
L'oggetto
Place
della risposta contiene il nuovo metodogetReviews()
che restituisce un elenco di oggettiReview
. Quando la tua app mostra informazioni ottenute dall'oggettoPlace
, ad esempio foto e recensioni, deve mostrare anche le attribuzioni richieste.Per saperne di più, consulta la documentazione relativa alle attribuzioni.
Modifiche specifiche dell'API
Questa sezione include le seguenti guide alla migrazione per ogni API:
- Eseguire la migrazione da Place Details (legacy) a Place Details (nuovo)
- Eseguire la migrazione da Place Photo (legacy) a Place Photo (nuovo)
- Eseguire la migrazione dal completamento automatico (legacy) al completamento automatico (nuovo)
- Eseguire la migrazione da Current Place (legacy) a Nearby Search (nuovo)