Le funzionalità di Places SDK per iOS disponibili nell'app sono determinate da una combinazione del numero di versione dell'SDK (ad es. 9.0.0) specificato nelle dipendenze del pacchetto e delle API abilitate nella chiave API. Questa guida spiega le differenze tra le versioni e come selezionare le versioni da attivare nella tua app.
Numeri di versione SDK
Il numero di versione dell'SDK specificato nelle dipendenze del pacchetto determina se la tua app ha accesso alle funzionalità che sono state aggiunte in una determinata release. Ad esempio, Autocomplete (New) è disponibile solo nell'SDK versione 9.0.0 o successive.
Per ulteriori informazioni sulle modifiche introdotte in ogni versione dell'SDK, consulta le note di rilascio dell'SDK Places per iOS.
Versioni dell'API Places per Places SDK for iOS
Oltre a specificare un numero di versione dell'SDK, devi anche selezionare il servizio API Places chiamato dall'SDK in Google Cloud Console: 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, ad esempio Completamento automatico o Completamento automatico (Novità). Anche se puoi specificare un solo numero di versione dell'SDK, puoi abilitare contemporaneamente l'API Places e l'API Places (Nuova) sulla tua chiave API. Tuttavia, nella maggior parte dei casi, sarà necessario abilitare l'API Places (nuova) e utilizzare le (nuove) versioni 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, segui questi passaggi:
- Nel tuo progetto Google Cloud, abilita l'API Places, l'API Places (nuova) o entrambe. Per ulteriori informazioni, consulta Abilitare le API
- Nelle limitazioni relative alle chiavi API, abilita l'API Places, l'API Places API (New) o entrambe. Per ulteriori informazioni, consulta la sezione Limitazione delle chiavi API.
- Quando installi l'SDK, specifica il numero di versione. Per ulteriori informazioni, consulta la pagina Configurare un progetto Xcode.
Per ulteriori informazioni sulla selezione del servizio API Places, consulta l'articolo sulla configurazione del progetto Google Cloud.
Funzionalità dell'SDK disponibili in ogni versione
La tabella riportata di seguito mostra le versioni di SDK e API richieste per ogni funzionalità dell'SDK:
Funzionalità | API Places abilitata sulla chiave API | Versione minima dell'SDK |
---|---|---|
Completamento automatico (novità) | API Places (Novità) | 9.0.0 |
Dettagli del luogo (novità) | API Places (Novità) | 9.0.0 |
Ricerca nelle vicinanze (novità) | API Places (Novità) | 9.0.0 |
Foto del luogo (novità) | API Places (Novità) | 9.0.0 |
Ricerca testuale (novità) | API Places (Novità) | 8.5.0 |
Place Autocomplete | API Places | 3.0.0 |
Luogo attuale | API Places | 3.0.0 |
Dettagli del luogo | API Places | 3.0.0 |
Foto del luogo | API Places | 3.0.0 |
Considerazioni sulla scelta delle versioni da attivare
- Se sei un nuovo cliente che ha appena iniziato a utilizzare Places SDK per iOS, inizia con l'API Places (nuova) e il nuovo SDK.
- Se sei già cliente, puoi continuare a utilizzare l'SDK esistente. Tuttavia, per usufruire dei miglioramenti delle prestazioni e dei miglioramenti delle funzionalità di Places SDK per iOS (novità), devi abilitare l'API Places (novità) e utilizzare il nuovo SDK. Per passare al nuovo SDK non è necessaria alcuna migrazione; è sufficiente seguire i passaggi descritti in Selezionare la versione dell'SDK e i servizi API.
- L'API Places (nuova) non abilita alcune funzionalità
esistenti, come Current
Place,
GMSPlace.isOpen
eGMSPlaceisOpenAtDate
.
Utilizza la versione di anteprima di GooglePlacesSwift
Per utilizzare GooglePlacesSwift sono necessari i seguenti passaggi:
- Abilita l'API Places (nuova).
- Aggiungi GooglePlacesSwiftSDK alle tue dipendenze.
- Inizializza il client Places con
PlacesClient
.
Per scoprire di più su GooglePlacesSwift, consulta la documentazione di riferimento.
Esegui la migrazione alle nuove API
Se utilizzi un'API esistente e vuoi eseguire la migrazione alla nuova API, consulta le seguenti guide alla migrazione per ogni API:
- Eseguire la migrazione a Place Details (novità)
- Eseguire la migrazione a Place Photo (novità)
- Eseguire la migrazione a Autocomplete (novità)
Miglioramenti all'SDK Places per iOS (novità)
Questa sezione illustra le funzionalità principali aggiunte a Places SDK per iOS (novità).
Implementata sulla piattaforma standard di Google Cloud
L'SDK Places per iOS (novità) è implementato nell'infrastruttura di servizi 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 iOS (novità).
Prestazioni migliorate
L'SDK Places per iOS (novità) fornisce prestazioni migliori, pertanto vale la pena sostituire le app che utilizzano l'SDK esistente.
Nuove funzionalità
Places SDK per iOS (novità) include le ultime versioni di tutte le funzioni dell'SDK:
- Completamento automatico (novità)
- Dettagli del luogo (novità)
- Ricerca nelle vicinanze (novità)
- Foto del luogo (novità)
- Ricerca testuale (novità)
Determinazione del prezzo semplificata
I prezzi sono semplificati con Places SDK per iOS (novità), in modo che paghi solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando elenchi di campi, chiamati anche maschere di campo.
Con Places SDK for iOS e Ricerca testuale, puoi utilizzare gli elenchi di campi per controllare l'elenco dei 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 assicurarsi di non richiedere dati non necessari, evitando così tempi di elaborazione e addebiti superflui.
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 vengono restituiti nell'ambito della risposta a Place Details e alla 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 | 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 (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 i seguenti tipi come parte di una ricerca:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality