Utilizza questa guida per comprendere le principali differenze tra le versioni di Places SDK e per 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 (novità) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Details (New) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (novità) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Photos (New) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Ricerca testuale (novità) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API Places (legacy) | initialize() (deprecato) |
|
| Current Place | API Places (legacy) | initialize() (deprecato) |
|
| Place Details | API Places (legacy) | initialize() (deprecato) |
|
| Place Photos | API Places (legacy) | initialize() (deprecato) |
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 (novità)
- Esegui la migrazione a Place Photos (novità)
- Migrare al completamento automatico (novità)
Miglioramenti in Places SDK for Android (novità)
Questa sezione descrive le funzionalità chiave aggiunte a Places SDK for Android (New).
Implementato sulla piattaforma standard 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 (novità)
- Place Details (New)
- Nearby Search (novità)
- Place Photos (New)
- Ricerca testuale (novità)
Ricerca testuale (novità)
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 preferenza di località impostata.
Nuovi dati di risposta aggiunti a Dettagli luogo (nuovo) e Foto del luogo (nuovo)
Dettagli del luogo (nuovo) ora include la nuova classe Recensione nell'oggetto
Placedella risposta. La classe Place contiene il nuovo metodogetReviews()per supportare questo campo. ChiamagetReviews()per restituire fino a cinque recensioni di un luogo.Foto dei luoghi (novità) aggiunge
AuthorAttributionsalla classePhotoMetadata.AuthorAttributionscontiene unListdi oggettiAuthorAttribution.
Nuova risposta URI aggiunta a Foto dei luoghi (nuovo)
Ora puoi utilizzare Place Photos (Nuova) per restituire un URI a una bitmap immagine. In precedenza, potevi restituire solo la bitmap dell'immagine.
Prezzi semplificati
I prezzi sono semplificati con Places SDK per Android (New), in modo da pagare solo per i dati che utilizzi. Il prezzo semplificato viene implementato utilizzando gli 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. A questo punto ti vengono addebitati solo i costi per i dati richiesti. L'utilizzo di un elenco di campi è una buona pratica di progettazione per assicurarsi di non richiedere dati non necessari, il che contribuisce 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 nell'ambito della risposta Place Details (New) e Ricerca testuale (New). Puoi anche utilizzare questi nuovi tipi e quelli esistenti in una ricerca con la ricerca testuale (nuova). I nuovi tipi sono inclusi in Tabella A.