Panoramica della migrazione

Places SDK for iOS (New) offre prestazioni migliorate e un nuovo modello di prezzi, il che rende utile aggiornare le app che utilizzano Places SDK for iOS (Legacy). Per ulteriori dettagli sul confronto delle funzionalità, vedi Scegliere l'SDK.

Utilizza questa guida per comprendere le differenze principali 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 al prezzo di secondo livello. 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.

Errore: kGMSPlacesRateLimitExceeded

API Places (Novità)

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

Dopodiché, devi verificare 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 in Places SDK for iOS (New) sia disponibile una quota sufficiente a 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. Tieni presente le differenze tra le due API:

  • La quota per Places SDK for iOS (legacy) si basa sulla quota del servizio Places API. È la somma di tutti i metodi dell'API Places.
  • La quota per Places SDK for iOS (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 (nuova), con i prezzi previsti. In caso contrario, contatta il tuo referente commerciale di Google o il tuo partner per discutere di come puoi 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 per Places SDK for iOS (New).

  • Places Details (New), Nearby Search (New) e Text Search (New) richiedono maschere di campo per specificare i campi che vuoi 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 la tua app mostra informazioni ottenute dall'istanza GMSPlace, 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: