Utilizza questa guida per comprendere le principali differenze tra le versioni di Places SDK ed eseguire la migrazione a Places SDK for Android (nuovo).
Funzionalità dell'SDK disponibili in ogni versione
La tabella seguente mostra le versioni dell'SDK e dell'API richieste per ogni funzionalità dell'SDK:
| Funzionalità | Versione dell'API Places | Metodo di inizializzazione | Versione minima dell'SDK |
|---|---|---|---|
| Autocomplete (New) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Details (New) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (New) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Photos (New) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Text Search (New) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API Places (legacy) | initialize() (deprecato) |
|
| Luogo attuale | API Places (legacy) | initialize() (deprecato) |
|
| Place Details | API Places (legacy) | initialize() (deprecato) |
|
| Place Photos | API Places (legacy) | initialize() (deprecato) |
Esegui la migrazione alle nuove API
Per eseguire la migrazione alle nuove API, consulta le seguenti guide alla migrazione:
- Esegui la migrazione a Place Details (New)
- Esegui la migrazione a Place Photos (New)
- Esegui la migrazione ad Autocomplete (New)
Miglioramenti in Places SDK for Android (novità)
Questa sezione illustra le funzionalità principali aggiunte a Places SDK for Android (nuovo).
Implementato sulla piattaforma standard di Google Cloud
Places SDK for Android (nuovo) è implementato nell'infrastruttura di servizi su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile. Questo design standard offre un livello di coerenza tra gli SDK che migliora l'efficienza dello sviluppo con l'SDK Places per Android (nuovo).
Prestazioni migliorate
Places SDK for Android (nuovo) offre prestazioni migliorate, il che rende conveniente sostituire le app che utilizzano l'SDK esistente.
Nuove funzionalità
Places SDK for Android (nuovo) include le ultime versioni di tutte le funzionalità dell'SDK:
Text Search (New)
Ricerca testuale (nuova) restituisce informazioni su un insieme di luoghi in base a una stringa, ad esempio "pizza a New York", "negozi di scarpe vicino a Ottawa" o "123 Main Street". Il servizio risponde con un elenco di luoghi corrispondenti alla stringa di testo e all'eventuale bias di località impostato.
Nuovi dati di risposta aggiunti a Place Details (New) e Place Photos (New)
Place Details (New) ora include la nuova classe Review nell'oggetto
Placedella risposta. La classe Place contiene il nuovo metodogetReviews()per supportare questo campo. ChiamagetReviews()per restituire fino a cinque recensioni per un luogo.Place Photos (New) aggiunge
AuthorAttributionsalla classePhotoMetadata.AuthorAttributionscontiene unListdi oggettiAuthorAttribution.
Nuova risposta URI aggiunta a Place Photos (New)
Ora puoi utilizzare Foto dei luoghi (novità) per restituire un URI a una bitmap dell'immagine. In precedenza, potevi restituire solo la bitmap dell'immagine stessa.
Prezzi semplificati
I prezzi sono semplificati con Places SDK for Android (nuovo), in modo che tu paghi solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando elenchi di campi, chiamati anche maschere di campo.
Con Place Details (New) e Ricerca testuale (New), utilizzi gli elenchi di campi per controllare l'elenco di campi da restituire nella risposta. Ti verranno addebitati solo i dati richiesti. L'utilizzo di un elenco di campi è una buona pratica di progettazione per assicurarti di non richiedere dati non necessari, il che aiuta a evitare tempi di elaborazione e addebiti di fatturazione non necessari.
Per saperne di più sui prezzi, consulta Utilizzo e fatturazione.
Tipi di luoghi espansi
Il nuovo SDK include nuovi tipi di luoghi, che vengono restituiti come parte della risposta di Place Details (nuovo) e Ricerca testuale (nuovo). Puoi anche utilizzare questi nuovi tipi e quelli esistenti in una ricerca con Ricerca testuale (nuova). I nuovi tipi sono inclusi nella Tabella A.