Le funzionalità di Places SDK for Android disponibili nella tua app sono determinate da una combinazione del numero di versione dell'SDK (ad esempio 3.5.0) specificato nella configurazione dell'app, delle API abilitate nella tua chiave API e della modalità di inizializzazione dell'app. Questa guida spiega le differenze tra le versioni e come selezionare le versioni abilitate nella tua app.
Numeri di versioni degli SDK
Il numero di versione dell'SDK specificato nel file build.gradle a livello di app determina se l'app ha accesso alle funzionalità aggiunte in una release specifica. Ad esempio, Autocomplete (New) è disponibile solo nell'SDK 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 di API Places per l'SDK Places per Android
Oltre a specificare un numero di versione dell'SDK, devi selezionare anche il servizio API Places che l'SDK chiama nella console Google Cloud: API Places o API Places (novità). Insieme al numero di versione dell'SDK, il servizio API selezionato determina la versione di funzionalità specifiche disponibili nella tua app, ad esempio Completamento automatico o Completamento automatico (Novità). Anche se puoi specificare un solo numero di versione dell'SDK, puoi attivare contemporaneamente sia l'API Places sia l'API Places (Nuova) nella tua chiave API, quindi selezionare il servizio che l'SDK chiama tramite il metodo utilizzato per inizializzare l'SDK nella tua app. Tuttavia, nella maggior parte dei casi, dovrai abilitare l'API Places (Nuova) e utilizzare le versioni (Nuove) delle funzionalità SDK nella tua app.
Seleziona la versione dell'SDK e i servizi API
Per selezionare le funzionalità dell'SDK disponibili nella tua app:
- Nel tuo progetto Google Cloud, abilita l'API Places, l'API Places (nuova) o entrambe. Per ulteriori informazioni, consulta Abilitare le API
- Nelle limitazioni delle chiavi API, abilita l'API Places, l'API Places (nuova) o entrambe. Per ulteriori informazioni, consulta la sezione Limitazione delle chiavi API.
Nel file build.gradle a livello di app, specifica un numero di versione. Per scoprire di più, consulta la sezione Installazione.
Inizializza l'app chiamando il metodo
Places.initializeWithNewPlacesApiEnabled()oPlaces.initialize().
Per ulteriori informazioni sulla selezione del servizio API Places, vedi Configurare il progetto Google Cloud.
Funzionalità dell'SDK disponibili in ogni versione
La tabella seguente mostra le versioni dell'SDK e dell'API necessarie per ogni funzionalità dell'SDK:
| Funzionalità | API Places abilitata sulla chiave API | Metodo di inizializzazione | Versione minima dell'SDK |
|---|---|---|---|
| Completamento automatico (novità) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Dettagli luogo (novità) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Ricerca nelle vicinanze (novità) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Foto del luogo (novità) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Ricerca testuale (novità) | API Places (Novità) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API Places | initialize() |
|
| Luogo attuale | API Places | initialize() |
|
| Dettagli del luogo | API Places | initialize() |
|
| Foto del luogo | API Places | initialize() |
Considerazioni sulla scelta delle versioni da attivare
Per decidere quale versione scegliere, considera quanto segue:
- Se sei un nuovo cliente che ha appena iniziato a utilizzare l'SDK Places per Android, inizia con l'API Places (nuova) e il nuovo SDK.
- Se sei già cliente, puoi continuare a utilizzare l'SDK esistente. Tuttavia, per sfruttare i miglioramenti delle prestazioni e delle funzionalità dell'SDK Places per Android (novità), devi utilizzare il nuovo SDK. Non è necessaria alcuna migrazione quando passi al nuovo SDK, è sufficiente seguire i passaggi descritti in Selezionare la versione dell'SDK e i servizi API.
- Nell'SDK Places for Android (novità), i token di sessione sono disponibili a partire dalla versione 3.5.0. Per ulteriori informazioni, consulta Token di sessione.
- Le chiamate effettuate utilizzando i widget Place Autocomplete chiamano sempre Place Autocomplete, non Place Autocomplete (New); le chiamate dei widget non sono interessate dal metodo di inizializzazione.
- Place Photos (New) restituisce solo un URI a un'immagine bitmap, mentre Place Photos restituisce solo un'immagine bitmap.
- Posizione attuale è disponibile solo nell'SDK Places per Android, non nell'SDK Places per Android (Novità).
Miglioramenti dell'SDK Places per Android (novità)
Questa sezione illustra le funzionalità principali aggiunte all'SDK Places per Android (novità).
Implementata sulla piattaforma Google Cloud standard
L'SDK Places for Android (New) è implementato nell'infrastruttura dei servizi su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile. Questo design standard offre un livello di coerenza tra gli SDK che migliorano l'efficienza dello sviluppo con Places SDK for Android (Novità).
Prestazioni migliorate
L'SDK Places for Android (New) offre prestazioni migliori, pertanto vale la pena sostituire le app che utilizzano l'SDK esistente.
Nuove funzionalità
L'SDK Places for Android (novità) include le versioni più recenti di tutte le funzionalità dell'SDK:
- Completamento automatico (novità)
- Dettagli luogo (novità)
- Ricerca nelle vicinanze (novità)
- Foto del luogo (novità)
- Ricerca testuale (novità)
Nuovo servizio di ricerca testuale
Ricerca testuale 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 corrispondenti alla stringa di testo e all'eventuale bias di località impostato.
Nuovi dati di risposta aggiunti a Dettagli sul luogo (novità) e Foto del luogo (Novità)
Place Details (Novità) include la nuova classe Review nell'oggetto
Placedi risposta. La classe Place contiene il nuovo metodogetReviews()per supportare questo campo. Chiama il numerogetReviews()per visualizzare fino a cinque recensioni per un luogo.Foto del luogo (Novità) aggiunge
AuthorAttributionsalla classePhotoMetadata.AuthorAttributionscontieneListdi oggettiAuthorAttribution.
Nuova risposta URI aggiunta a Place Photo (novità)
Ora puoi utilizzare Posizione foto (nuova) 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 l'SDK Places for Android (Nuovo) in modo che tu paghi solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando elenchi di campi, chiamati anche mascherine di campo.
Con Place Details e la ricerca di testo puoi utilizzare gli elenchi di campi per controllare l'elenco di campi da restituire nella risposta. Ti vengono quindi addebitati solo i dati richiesti. L'utilizzo di un elenco di campi è una buona prassi di progettazione per assicurarsi di non richiedere dati superflui, il che contribuisce a evitare tempi di elaborazione e addebiti di fatturazione superflui.
Per informazioni più dettagliate sui prezzi di entrambi gli SDK, consulta Utilizzo e fatturazione.
Tipi di luoghi espansi
Il nuovo SDK aggiunge i tipi di luogo mostrati nella seguente tabella. Questi tipi vengono restituiti come parte delle risposte di Place Details e Ricerca testuale. Puoi anche usare questi nuovi tipi, e quelli esistenti, in una ricerca con Ricerca testuale. 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 | farm | 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 | su misura |
| 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 | playground | 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 |
Insieme a questi nuovi tipi, l'API Places (Nuova) ha spostato i seguenti tipi dalla Tabella 2 per l'API Places alla Tabella A per l'API Places (Nuova). Ciò significa che ora puoi utilizzare questi tipi di ricerca in una ricerca:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality