Panoramica di Places SDK (legacy)

L'SDK Places ti consente di cercare e recuperare informazioni su vari tipi di luoghi utilizzando una stringa di testo o in base alla vicinanza. Places SDK è la versione precedente di Places SDK (nuovo).

Utilizza questa guida per comprendere le principali differenze tra le versioni di Places SDK e per eseguire la migrazione a Places SDK (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:

Esegui 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à)
• Eseguire la migrazione a Foto Ricordo (nuova)
• Eseguire la migrazione a Completamento automatico (novità)

Miglioramenti nell'SDK Places per 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 del 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 (nuovo).

Prestazioni migliorate

Places SDK for Android (nuovo) offre prestazioni migliorate, quindi vale la pena sostituire le app che utilizzano l'SDK esistente.

Nuove funzionalità

Places SDK for Android (nuovo) include le versioni più recenti di tutte le funzionalità dell'SDK:

• Completamento automatico (novità)
• Place Details (versione nuova)
• Ricerca nelle vicinanze (novità)
• Place Photos (versione nuova)
• Ricerca di testo (novità)

Nuovo servizio di ricerca di testo

La ricerca di testo (novità) restituisce informazioni su un insieme di luoghi in base a una stringa, ad esempio "pizzeria a New York" o "negozi di scarpe vicino a Ottawa" o "123 Main Street". Il servizio risponde con un elenco di luoghi corrispondenti alla stringa di testo e a eventuali bias di geolocalizzazione impostati.

Nuovi dati di risposta aggiunti a Dettagli luogo (novità) e Foto del luogo (novità)

• Dettagli dei luoghi (novità) ora include la nuova recensione nella risposta dell'oggetto Place. La classe Place contiene il nuovo metodo getReviews() per supportare questo campo. Chiama getReviews() per visualizzare fino a cinque recensioni di un luogo.

• Inserisci foto (nuova) aggiunge il AuthorAttributions al gruppo PhotoMetadata. AuthorAttributions contiene un List di AuthorAttribution oggetti.

Nuova risposta URI aggiunta a Foto dei luoghi (novità)

Ora puoi utilizzare Inserisci foto (nuovo) per restituire un URI a una bitmap immagine. In precedenza, potevi restituire solo la bitmap dell'immagine stessa.

Prezzi semplificati

I prezzi sono semplificati con il nuovo SDK Places per Android, in modo da pagare solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando gli elenchi di campi, chiamati anche maschere di campo.

Con i dettagli dei luoghi e la ricerca di testo, 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 prassi di progettazione per assicurarti di non richiedere dati non necessari, il che consente di evitare tempi di elaborazione e costi di fatturazione non necessari.

Per informazioni dettagliate sui prezzi di entrambi gli SDK, consulta la sezione Utilizzo e fatturazione.

Tipi di luoghi espansi

Il nuovo SDK include nuovi tipi di luoghi, che vengono restituiti nell'ambito della risposta di Text Search e Places Details. Puoi anche utilizzare questi nuovi tipi e quelli esistenti in una ricerca con la ricerca di testo. I nuovi tipi sono inclusi nella Tabella A.