Places SDK for iOS (New) offre prestazioni migliorate e un nuovo modello di prezzi, per cui vale la pena aggiornare le app che utilizzano Places SDK for iOS (Legacy). Per maggiori dettagli sul confronto delle funzionalità, consulta la sezione 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 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 altro SKU. 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, ti assicurerai di raggiungere i livelli di prezzo mensili più convenienti durante il mese di migrazione. 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 abilitare Places API (New) nel tuo progetto Google Cloud. Per saperne di più, consulta Configurare il progetto Google Cloud.
Dopodiché, devi verificare di aver aggiunto l'Places SDK per iOS (nuovo) all'elenco delle API autorizzate nella chiave utilizzata dalla tua app. Per saperne di più, 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 per coprire il traffico attuale in Places SDK for iOS (legacy). Per esaminare e gestire le quote e i limiti di utilizzo, consulta Quote e avvisi relativi alle quote. Nota le differenze tra le due API:
- La quota per Places SDK for iOS (legacy) si basa sulla quota del servizio Places API (legacy). È 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.
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 puoi includere questa API.
Modifiche generali
Alcune modifiche generali che si applicano a più API includono:
Utilizza un nuovo modello di prezzo. Per informazioni sui prezzi di tutte le API, consulta Prezzi dell'SDK Places per iOS (nuovo).
Place Details (novità), Nearby Search (novità) e Ricerca testuale (novità) richiedono maschere di campo per specificare i campi che vuoi vengano restituiti nella risposta.
GMSPlacesClientcontiene 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
GMSPlacecontiene la nuova proprietàreviewsdi tipoGMSPlaceReview. Quando la tua app mostra informazioni ottenute dall'istanzaGMSPlace, come foto e recensioni, deve mostrare anche le attribuzioni richieste.Per saperne di più, consulta la documentazione relativa alle attribuzioni.
Modifiche specifiche per l'API
Questa sezione include le seguenti guide alla migrazione per ogni API:
- Eseguire la migrazione a Place Details (novità)
- Esegui la migrazione a Place Photos (novità)
- Migrazione al completamento automatico (novità)