Le funzioni di Places SDK per Android disponibili nella tua app sono determinato da una combinazione del numero di versione dell'SDK (ad es. 3.5.0) che hai specificare nella configurazione dell'app le API abilitate nella chiave API e il modo in cui per inizializzare l'app. Questa guida spiega le differenze tra le versioni e come selezionare le versioni abilitate nella tua app.
Numeri di versione SDK
Il numero di versione dell'SDK specificato nel file build.gradle a livello di app determina se la tua app ha accesso a funzionalità che sono state aggiunte in un una determinata release. Ad esempio, Autocomplete (New) è disponibile solo nell'SDK versione 3.5.0 o successiva.
Per ulteriori informazioni sulle modifiche introdotte in ogni versione dell'SDK, consulta la sezione Places Release dell'SDK per Android note.
Versioni dell'API Places per Places SDK for Android
Oltre a specificare un numero di versione dell'SDK, devi selezionare anche i luoghi Servizio API chiamato dall'SDK in Google Cloud Console: API Places o API Places (novità). Insieme al numero di versione dell'SDK, il servizio API che "Seleziona" determina la versione di specifiche funzionalità disponibili nella tua app, come Autocomplete o Autocomplete (New). Anche se è possibile specificare un solo SDK numero di versione, puoi abilitare sia l'API Places sia l'API Places (Novità) sul tuo chiave API, quindi seleziona il servizio tramite cui l'SDK effettua le chiamate il metodo che usi per inizializzare l'SDK nella tua app. Tuttavia, nella maggior parte dei casi, abilitare l'API Places (nuova) e utilizzare le versioni (nuove) del 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, segui questi passaggi:
- Nel tuo progetto Google Cloud, abilita l'API Places, l'API Places (nuova) oppure entrambi. Per ulteriori informazioni, consulta Attivare API
- Nelle limitazioni relative alle chiavi API, abilita l'API Places, l'API Places (nuova) oppure entrambi. Per maggiori informazioni, consulta la sezione Restricting API chiave.
Nel file build.gradle a livello di app, specifica un numero di versione. Per maggiori informazioni le informazioni, vedi Installazione.
Inizializza la tua app chiamando il
Places.initializeWithNewPlacesApiEnabled()oPlaces.initialize().
Per ulteriori informazioni sulla selezione del servizio API Places, vedi Configurare progetto Google Cloud.
Funzionalità dell'SDK disponibili in ogni versione
La tabella seguente mostra le versioni di SDK e API richieste per ogni SDK funzionalità:
| 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 del 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 la funzione miglioramenti di Places SDK per Android (New), è consigliabile utilizzare il nuovo l'SDK. Non è necessaria alcuna migrazione per passare al nuovo SDK, basta seguire i passaggi in Selezionare la versione dell'SDK e l'API Google Cloud.
- In Places SDK for Android (Novità), i token di sessione saranno disponibili a partire dal giorno nella versione 3.5.0. Per ulteriori informazioni, consulta la sezione Sessione di token.
- Per le chiamate effettuate utilizzando i widget Place Autocomplete, viene sempre chiamata Place Completamento automatico, non Place Autocomplete (Novità); le chiamate ai widget non sono influenzate di inizializzazione.
- Foto del luogo (novità) restituisce solo un URI a un'immagine bitmap, mentre Posiziona Photos restituisce solo una bitmap dell'immagine.
- Luogo attuale è disponibile solo in Places SDK for Android, non in Places SDK per Android (Novità).
Miglioramenti a Places SDK per Android (novità)
Questa sezione illustra le funzionalità principali aggiunte a Places SDK per Android (novità).
Implementata sulla piattaforma standard di Google Cloud
L'SDK Places per Android (novità) è implementato nel servizio infrastruttura su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile. Questo design standard garantisce un livello di coerenza tra gli SDK che migliorano l'efficienza dello sviluppo con Places SDK per Android (Novità).
Prestazioni migliorate
L'SDK Places per Android (novità) offre prestazioni migliori, pertanto vale la pena sostituire le app che utilizzano l'SDK esistente.
Nuove funzionalità
Places SDK per Android (novità) include le ultime versioni di tutto l'SDK caratteristiche:
- Completamento automatico (novità)
- Dettagli del luogo (novità)
- Ricerca nelle vicinanze (novità)
- Foto del luogo (novità)
- Ricerca testuale (novità)
Nuovo servizio di ricerca testuale
Ricerca testuale (Novità) restituisce informazioni su un insieme di posizioni in base a una stringa, ad esempio "pizza a New York" o "negozi di scarpe vicino a Roma" o "Via Cavour 123". Il servizio risponde con un elenco di luoghi corrispondenti alla stringa di testo e qualsiasi bias di località impostato.
Nuovi dati delle risposte aggiunti a Placed Details (Novità) e Place Photo (Novità)
Dettagli del luogo (Novità) ora include la nuova Esamina nell'oggetto
Placedella risposta. La Classe Place contiene il nuovo metodogetReviews()per supportare questo campo. ChiamagetReviews()per restituire fino a cinque recensioni per un luogo.Foto del luogo (Nuova) aggiunta
AuthorAttributionsalla classePhotoMetadata.AuthorAttributionscontiene un valoreListdiAuthorAttributiondi oggetti strutturati.
Nuova risposta URI aggiunta a Place Photo (novità)
Ora puoi utilizzare Foto del luogo (Novità) per restituire un URI a una bitmap dell'immagine. In precedenza, potevi restituire solo l'immagine bitmap stessa.
Determinazione del prezzo semplificata
La determinazione del prezzo è semplificata con Places SDK per Android (novità), in modo che paghi solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando elenchi di campi, o maschere di campo.
Con Place Details e Ricerca testuale - Uso degli elenchi di campi per controllare l'elenco campi da restituire nella risposta. Ti verranno quindi addebitati solo i dati richiesto. L'utilizzo di un elenco di campi è una buona prassi di progettazione per garantire richiedere dati non necessari, così da evitare tempi di elaborazione non necessari e addebiti di fatturazione.
Per informazioni dettagliate sui prezzi di entrambi gli SDK, consulta Utilizzo e Fatturazione.
Tipi di luogo espansi
Il nuovo SDK aggiunge i tipi di luogo mostrati nella seguente tabella. Questi tipi sono restituiti nell'ambito di Place Details e Risposta della ricerca testuale. Puoi anche usare questi nuovi tipi, e i tipi esistenti in una ricerca con Ricerca testuale. I nuovi tipi sono inclusi nella Tabella R.
| 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 | sartoria |
| 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 |
Insieme a questi nuovi tipi, l'API Places (Novità) ha spostato i seguenti tipi dalla tabella 2 per l'API Places alla tabella A per l'API Places (novità). Ciò significa che ora puoi utilizzare questi tipi come parte di un cerca:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality