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 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 SKU diverso. Per evitare un aumento dei costi 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)
Per utilizzare le funzionalità di Places SDK for Android (New), devi prima abilitare l'API Places (New) nel tuo progetto Google Cloud. Per saperne di più, consulta Configurare il progetto Google Cloud.
Dopodiché, devi assicurarti di aver aggiunto API Places (New) all'elenco delle API autorizzate nella chiave utilizzata dalla tua app. Per ulteriori informazioni, consulta Utilizzare le chiavi API.
Assicurati di disporre di 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 API Places (New). Esiste una quota separata per ogni metodo API.
Controlla se il tuo contratto 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 il listino prezzi globale.
Devi inizializzare l'app chiamando il metodo
Places.initializeWithNewPlacesApiEnabled(). Per saperne di più sulla selezione del servizio API Places, vedi Configurare il progetto Google Cloud.Place Details (New), Nearby Search (New) e Ricerca testuale (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 di risposta
Placecontiene il nuovo metodogetReviews()che restituisce un elenco di oggettiReview. Quando la tua app mostra informazioni ottenute dall'oggettoPlace, come 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 Photos (legacy) a Place Photos (nuovo)
- Eseguire la migrazione da Place Autocomplete (legacy) ad Autocomplete (nuovo)
- Eseguire la migrazione da Luogo attuale (legacy) a Nearby Search (nuovo)