Introduzione
L'API Places (nuova) offre prestazioni migliorate e un nuovo modello di prezzo, il che rende conveniente l'aggiornamento delle app che utilizzano l'API Places (legacy). Per maggiori dettagli sul confronto delle funzionalità, consulta Scegli l'API.
Utilizza questa guida per comprendere le principali differenze tra l'API Places (nuova) e l'API Places (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 del secondo livello. Quando esegui la migrazione a una versione più recente di un'API, ti viene fatturato anche uno SKU diverso. Per evitare un aumento dei costi durante il mese della 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, potrai usufruire dei livelli di prezzo mensili più convenienti. Per informazioni sui livelli di prezzo, consulta la pagina dei prezzi e le domande frequenti sui prezzi.
Abilita l'API Places (nuova)
Per utilizzare le funzionalità dell'API Places (nuova), devi prima abilitare l'API Places (nuova) nel tuo progetto Google Cloud. Per saperne di più, consulta Configura il progetto Google Cloud.
Devi quindi assicurarti di aver aggiunto l'API Places (novità) alla chiave API utilizzata dalla tua app. Per ulteriori informazioni, consulta Utilizza 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 token OAuth come meccanismo di autenticazione.
- Come formato di risposta è supportato solo JSON.
- Il mascheramento dei campi è richiesto da Place Details (New), Nearby Search (New) e Ricerca testuale (New) per specificare i campi che vuoi che vengano restituiti nella risposta. Per ulteriori informazioni, consulta FieldMask.
- Le API Nearby Search (New) e Ricerca testuale (New) ora restituiscono i dettagli completi del luogo in modo che corrispondano a quelli restituiti da Place Details (New).
- Il formato della risposta JSON per le API Place Details (New), Nearby Search (New) e Ricerca testuale (New) è cambiato rispetto al formato delle API esistenti. Per maggiori dettagli, consulta Esegui la migrazione della risposta dell'API Places.
Modifiche specifiche per l'API
Questa sezione include le seguenti guide alla migrazione per ogni API:
- Esegui la migrazione a Nearby Search (New)
- Esegui la migrazione a Ricerca testuale (Nuovo)
- Esegui la migrazione a Place Details (New)
- Esegui la migrazione a Foto dei luoghi (novità)
- Esegui la migrazione ad Autocomplete (New)