Panoramica della migrazione

Places SDK for iOS (New) offre prestazioni migliorate e un nuovo modello di prezzi, quindi vale la pena aggiornare le app che utilizzano Places SDK for iOS (Legacy). Per maggiori dettagli sul confronto delle funzionalità, consulta Scegliere l'SDK.

Utilizza questa guida per comprendere le principali differenze tra Places SDK for iOS (New) e Places SDK for iOS (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 ai prezzi di secondo livello. Quando esegui la migrazione a una versione più recente di un'API, ti viene addebitato anche uno 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 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.

Errore: kGMSPlacesRateLimitExceeded

API Places (Novità)

Places SDK for iOS si basa sul servizio API Places. Per utilizzare le funzionalità di Places SDK for iOS (New), devi prima attivare API Places (New) nel tuo progetto Google Cloud. Per maggiori informazioni, consulta Configurare il progetto Google Cloud project.

Dopodiché, devi verificare di aver aggiunto API Places (New) all'elenco delle API autorizzate nella chiave utilizzata dalla tua app. Per maggiori informazioni, consulta Utilizzare le chiavi API.

Assicurati di avere una quota sufficiente nell'API Places (New)

Assicurati che in Places SDK for iOS (New) sia disponibile una quota sufficiente per coprire il traffico attuale in Places SDK for iOS. Per esaminare e gestire le quote e i limiti di utilizzo, consulta Quote e avvisi relativi alle quote relativi alle quote. Tieni presente le differenze tra le due API:

  • La quota per Places SDK for iOS (Legacy) si basa sulla quota del servizio API Places. È la somma di tutti i metodi dell'API Places.
  • La quota per Places SDK for iOS (New) si basa sulla quota del servizio API Places (New). Esiste una quota separata per ogni metodo API.

Verifica se il tuo contratto negoziato include l'API Places (New)

Se hai un contratto negoziato, verifica che copra l'API Places (New), con i prezzi previsti. In caso contrario, contatta il tuo contatto commerciale 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 Prezzi di Places SDK for iOS (New).

  • Place Details (New), Nearby Search (New) e Ricerca testuale (New) richiedono maschere di campo per specificare i campi che vuoi che vengano restituiti nella risposta.

  • GMSPlacesClient contiene nuovi metodi per chiamare queste nuove API.

  • Sono state aggiunte nuove classi per definire la richiesta a ciascuna delle nuove API.

  • L'istanza di risposta GMSPlace contiene la nuova proprietà reviews di tipo GMSPlaceReview. Quando l'app mostra informazioni ottenute dall'istanza GMSPlace, come foto e recensioni, deve anche mostrare le attribuzioni richieste.

    Per maggiori informazioni, consulta la documentazione sulle attribuzioni.

Modifiche specifiche dell'API

Questa sezione include le seguenti guide alla migrazione per ogni API: