Utilizza questa guida per comprendere le principali differenze tra le versioni di Places SDK ed eseguire la migrazione a Places SDK for Android (New).
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 |
|---|---|---|---|
| Completamento automatico (New) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Dettagli del luogo (New) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (New) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Photos (New) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Text Search (New) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API Places (Legacy) | initialize() (Deprecated) |
|
| Luogo attuale | API Places (Legacy) | initialize() (Deprecated) |
|
| Dettagli del luogo | API Places (Legacy) | initialize() (Deprecated) |
|
| Place Photos | API Places (Legacy) | initialize() (Deprecated) |
Eseguire la migrazione alle nuove API
Per eseguire la migrazione alle nuove API, consulta le seguenti guide alla migrazione:
- Eseguire la migrazione a Place Details (New)
- Eseguire la migrazione a Place Photos (New)
- Eseguire la migrazione a Completamento automatico (New)
Miglioramenti in Places SDK for Android (New)
Questa sezione illustra le funzionalità principali aggiunte a Places SDK for Android (New).
Implementato sulla piattaforma standard di Google Cloud
Places SDK for Android (New) è implementato nell'infrastruttura di servizio 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 Places SDK for Android (New).
Prestazioni migliorate
Places SDK for Android (New) offre prestazioni migliorate, il che rende utile sostituire le app che utilizzano l'SDK esistente.
Nuove funzionalità
Places SDK for Android (New) include le versioni più recenti di tutte le funzionalità dell'SDK:
- Completamento automatico (New)
- Dettagli del luogo (New)
- Nearby Search (New)
- Place Photos (New)
- Text Search (New)
Text Search (New)
Ricerca testuale (New) restituisce informazioni su un insieme di luoghi in base a una stringa, ad esempio "pizza a New York" o "negozi di scarpe vicino a Ottawa" o "123 Main Street". Il servizio risponde con un elenco di luoghi che corrispondono alla stringa di testo e a qualsiasi bias di posizione impostato.
Nuovi dati di risposta aggiunti a Place Details (New) e Place Photos (New)
Dettagli del luogo (New) ora include la nuova classe Review nell'oggetto
Placedella risposta. La classe Place contiene il nuovogetReviews()metodo per supportare questo campo. ChiamagetReviews()per restituire fino a cinque recensioni per un luogo.Place Photos (New) aggiunge
AuthorAttributionsalla classePhotoMetadata.AuthorAttributionscontiene unListdiAuthorAttributionoggetti.
Nuova risposta URI aggiunta a Place Photos (New)
Ora puoi utilizzare Place Photos (New) per restituire un URI a una bitmap di un'immagine. In precedenza, potevi restituire solo la bitmap dell'immagine stessa.
Prezzi semplificati
I prezzi sono semplificati con Places SDK for Android (New) 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 dei campi da restituire nella risposta. Ti vengono 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 non necessari.
Per ulteriori informazioni 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 Place Details (New) e Ricerca testuale (New). Puoi anche utilizzare questi nuovi tipi e quelli esistenti in una ricerca con Ricerca testuale (New). I nuovi tipi sono inclusi nella Tabella A.