Panoramica di Places SDK for Android (legacy)

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)

Deprecato:il metodo Places.initialize è deprecato. Utilizza invece Places.initializeWithNewPlacesApiEnabled(). Tieni presente che per utilizzare Places.initializeWithNewPlacesApiEnabled(), devi attivare l'API Places (New) nella chiave API nella console Google Cloud.

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 Place della risposta. La classe Place contiene il nuovo metodo getReviews() per supportare questo campo. Chiama getReviews() per restituire fino a cinque recensioni di un luogo.

• Foto dei luoghi (novità) aggiunge AuthorAttributions alla classe PhotoMetadata. AuthorAttributions contiene un List di oggetti AuthorAttribution.

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.