Scegli la versione dell'SDK

Le funzionalità dell'SDK Places per Android disponibili nella tua app sono determinate da una combinazione del numero di versione dell'SDK (ad es. 3.5.0) specificato nella configurazione dell'app, dalle API abilitate nella chiave API e dal modo in cui viene inizializzata l'app. Questa guida spiega le differenze tra le versioni e come selezionare le versioni da attivare nella tua app.

Numeri di versione dell'SDK

Il numero di versione dell'SDK specificato nel file build.gradle a livello di app determina se la tua app ha accesso alle funzionalità aggiunte in una determinata release. Ad esempio, il completamento automatico (nuovo) è disponibile solo nell'SDK nella versione 3.5.0 o successive.

Per ulteriori informazioni sulle modifiche introdotte in ogni versione dell'SDK, consulta le note di rilascio dell'SDK Places per Android.

Versioni dell'API Places per l'SDK Places per Android

Oltre a specificare un numero di versione dell'SDK, devi anche selezionare il servizio API Places chiamato dall'SDK nella console Google Cloud: API Places o API Places (nuova). Insieme al numero di versione dell'SDK, il servizio API selezionato determina la versione di funzionalità specifiche disponibili nella tua app, come il completamento automatico o il completamento automatico (nuovo). Sebbene sia possibile specificare un solo numero di versione dell'SDK, puoi attivare contemporaneamente sia l'API Places sia l'API Places (nuova) nella chiave API, quindi selezionare il servizio chiamato dall'SDK tramite il metodo utilizzato per inizializzare l'SDK nella tua app. Tuttavia, nella maggior parte dei casi, ti consigliamo di attivare l'API Places (nuova) e di utilizzare le versioni (nuove) delle funzionalità dell'SDK nella tua app.

Seleziona la versione dell'SDK e i servizi API

Per selezionare le funzionalità dell'SDK disponibili nella tua app:

  1. Nel tuo progetto Google Cloud, abilita l'API Places, l'API Places (nuova) o entrambe. Per ulteriori informazioni, consulta Attivare le API.
  2. Nelle limitazioni relative alla chiave API, abilita l'API Places, l'API Places (nuova) o entrambe. Per ulteriori informazioni, consulta Limitare le chiavi API.

  3. Nel file build.gradle a livello di app, specifica un numero di versione. Per ulteriori informazioni, consulta la sezione Installazione.

  4. Inizializza l'app chiamando il metodo Places.initializeWithNewPlacesApiEnabled() o Places.initialize().

Per ulteriori informazioni sulla selezione del servizio API Places, consulta Configurare il progetto Google Cloud.

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à API Places abilitata nella chiave API Metodo di inizializzazione Versione SDK minima
Completamento automatico (novità) API Places (Novità) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (versione nuova) API Places (Novità) initializeWithNewPlacesApiEnabled() 3.3.0
Ricerca nelle vicinanze (nuova) API Places (Novità) initializeWithNewPlacesApiEnabled() 3.5.0
Metti foto (novità) API Places (Novità) initializeWithNewPlacesApiEnabled() 3.4.0
Ricerca di testo (novità) API Places (Novità) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete API Places initialize()
Posizione attuale API Places initialize()
Dettagli sul luogo API Places initialize()
Foto del luogo API Places initialize()

Considerazioni per la scelta delle versioni da attivare

Per aiutarti a decidere quale versione scegliere, tieni presente quanto segue:

  • Se sei un nuovo cliente che sta iniziando a utilizzare l'SDK Places per Android, inizia con l'API Places (nuova) e il nuovo SDK.
  • Se sei già un cliente, puoi continuare a utilizzare l'SDK esistente. Tuttavia, per sfruttare i miglioramenti delle prestazioni e delle funzionalità dell'SDK Places per Android (nuovo), devi utilizzare il nuovo SDK. Non è necessaria alcuna migrazione per il passaggio al nuovo SDK. Segui semplicemente i passaggi descritti in Selezionare la versione dell'SDK e i servizi API.
  • Nell'SDK Places per Android (nuovo), i token di sessione sono disponibili a partire dalla versione 3.5.0. Per ulteriori informazioni, consulta la sezione Token di sessione.
  • Le chiamate effettuate utilizzando i widget di completamento automatico dei luoghi chiamano sempre Completamento automatico dei luoghi, non Completamento automatico dei luoghi (nuovo); le chiamate ai widget non sono interessate dal metodo di inizializzazione.
  • Metti foto (nuova) restituisce solo un URI per un'immagine bitmap, mentre Metti foto restituisce solo un'immagine bitmap.
  • Posizione attuale è disponibile solo nell'SDK Places per Android, non nell'SDK Places per Android (nuovo).

Miglioramenti nell'SDK Places per Android (novità)

Questa sezione illustra le funzionalità principali aggiunte all'SDK Places per Android (novità).

Implementato sulla piattaforma standard di Google Cloud

L'SDK Places per Android (nuovo) è 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 l'SDK Places per Android (novità).

Prestazioni migliorate

L'SDK Places per Android (nuovo) offre un rendimento migliore, pertanto vale la pena sostituire le app che utilizzano l'SDK esistente.

Nuove funzionalità

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

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 "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 a eventuali bias di geolocalizzazione impostati.

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

Nuova risposta URI aggiunta a Aggiungi foto (novità)

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

Prezzi semplificati

I prezzi sono semplificati con l'SDK Places per Android (nuovo) 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 Dettagli dei luoghi e Ricerca di testo utilizzi gli elenchi di campi per controllare l'elenco di campi da restituire nella risposta. Ti verrà addebitato solo il costo dei 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 Utilizzo e fatturazione.

Tipi di luoghi espansi

Il nuovo SDK aggiunge i tipi di luoghi mostrati nella tabella seguente. Questi tipi vengono resi disponibili nell'ambito della risposta di Dettagli dei luoghi e della Ricerca di testo. Puoi anche utilizzare questi nuovi tipi, oltre a quelli esistenti, in una ricerca con la ricerca di testo. I nuovi tipi sono inclusi nella Tabella A.

Tipo
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant fattoria korean_restaurant sporting_goods_store
barber_shop agriturismo lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal mercato steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant sarto
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant motel thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
consulente eliporto parco giochi vegetarian_restaurant
convention_center hiking_area scuola materna vietnamese_restaurant
cottage historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center ostello resort_hotel grossista
dental_clinic hotel rest_stop

Oltre a questi nuovi tipi, l'API Places (nuova) ha spostato i seguenti tipi dalla tabella 2 dell'API Places alla tabella A dell'API Places (nuova). Ciò significa che ora puoi utilizzare questi tipi nell'ambito di una ricerca:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality