Introduzione
L'API Places (Novità) offre prestazioni migliorate e un nuovo modello di prezzi, il che rende utile aggiornare le app che utilizzano l'API Places (legacy). Per maggiori dettagli sul confronto delle funzionalità, vedi Scegliere l' API.
Utilizza questa guida per comprendere le differenze principali tra l'API Places (Novità) e l'API Places (legacy), nonché come gestire le modifiche necessarie.
Best practice di fatturazione per la migrazione
Queste indicazioni si applicano se il tuo 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, raggiungerai 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.
Abilitare l'API Places (Novità)
Per utilizzare le funzionalità dell'API Places (Novità), devi prima abilitare l'API Places (Novità) nel tuo progetto Google Cloud. Per ulteriori informazioni, vedi Configurare il progetto Google Cloud project.
Dopodiché, devi assicurarti di aver aggiunto l'API Places (Novità) alla chiave API utilizzata dalla tua app. Per ulteriori informazioni, vedi Utilizzare le chiavi API.
Modifiche generali
Alcune modifiche generali che si applicano a più API includono:
- Tutte le nuove API supportano sia le chiavi API sia i OAuth come meccanismo di autenticazione.
- È supportato solo il formato JSON come formato di risposta.
- La maschera di campo è richiesta da Place Details (Novità), Nearby Search (Novità) e Ricerca testuale (Novità) per specificare i campi che vuoi che vengano restituiti nella risposta. Per ulteriori informazioni, consulta FieldMask.
- Le API Nearby Search (Novità) e Ricerca testuale (Novità) ora restituiscono i dettagli completi del luogo in modo che corrispondano a quelli restituiti da Place Details (Novità).
- Il formato di risposta JSON per le API Place Details (Novità), Nearby Search (Novità), e Ricerca testuale (Novità) è cambiato rispetto al formato delle API esistenti. Per maggiori dettagli, vedi Eseguire la migrazione della risposta dell'API Places.
Modifiche specifiche dell'API
Questa sezione include le seguenti guide alla migrazione per ogni API:
- Eseguire la migrazione a Nearby Search (Novità)
- Eseguire la migrazione a Ricerca testuale (Novità)
- Eseguire la migrazione a Place Details (Novità)
- Eseguire la migrazione a Place Photos (Novità)
- Eseguire la migrazione a Autocomplete (Novità)