L'SDK Places per iOS versione 8.5.0 supporta due versioni di SDK: L'SDK Places per iOS è l'SDK Places per iOS (nuovo) esistente. È la versione di nuova generazione dell'SDK.
Con il rilascio dell'SDK Places per iOS versione 8.5.0, la tua prima attività è decidere quale SDK utilizzare. Questo vale se sei un nuovo cliente o un cliente esistente che utilizza già l'SDK. Utilizza questa guida per comprendere le principali differenze tra i due SDK.
Come selezionare la versione dell'SDK
L'SDK Places per iOS si basa sul servizio API Places. Prima di poter utilizzare l'SDK Places per iOS, devi abilitare il servizio API Places nel tuo progetto Google Cloud.
La versione del servizio API Places che attivi controlla la versione dell'SDK utilizzata dalla tua app:
API Places: abilita l'SDK Places per iOS esistente. Se solo l'API Places è abilitata per il progetto associato alla chiave API utilizzata per la tua app, quest'ultima non avrà accesso alle nuove funzionalità aggiunte nell'SDK Places per iOS 8.5.0 e versioni successive.
API Places (nuova): abilita l'SDK Places per iOS (novità), tra cui Ricerca testuale e tutte le nuove funzionalità descritte in Funzionalità principali aggiunte a Places SDK per iOS (novità). Non attiva funzionalità esistenti come Dettagli del luogo, Foto del luogo, Luogo attuale e Completamento automatico del luogo.
Entrambe: attiva tutte le funzionalità sia per l'SDK Places per iOS (nuovo) sia per l'SDK Places per iOS.
Per ulteriori informazioni sulla selezione del servizio API Places, vedi Configurare il progetto Google Cloud.
Quale SDK scegli?
Per decidere quale versione scegliere:
Se sei un nuovo cliente che ha appena iniziato a utilizzare l'SDK Places per iOS, inizia con l'API Places (nuova) e l'API Places per avere accesso a tutte le funzionalità.
Se sei un cliente esistente, puoi continuare a utilizzare l'SDK esistente. Tuttavia, per sfruttare i miglioramenti delle prestazioni e i miglioramenti delle funzionalità dell'SDK Places per iOS (novità), puoi utilizzare il nuovo SDK.
Non è necessaria alcuna migrazione quando si passa al nuovo SDK. Devi abilitare l'SDK Places per iOS (nuovo) sulla chiave API utilizzata nella tua app. Se utilizzi sia l'SDK Places per iOS sia l'SDK Places per iOS (nuovo), attiva entrambe le versioni sulla chiave API. Per maggiori informazioni, consulta Utilizzare le chiavi API.
Funzionalità principali aggiunte a Places SDK for iOS (novità)
Questa sezione illustra le funzionalità principali aggiunte all'SDK Places per iOS (novità).
Implementata sulla piattaforma Google Cloud standard
L'SDK Places per iOS (nuovo) è implementato nell'infrastruttura di 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 l'SDK Places per iOS (Novità).
Prestazioni migliorate
L'SDK Places per iOS (nuovo) offre prestazioni migliori, pertanto vale la pena sostituire le app che utilizzano l'SDK esistente.
Nuovo servizio di ricerca testuale
La 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 con eventuali bias di località impostati.
Prezzi semplificati
I prezzi sono semplificati con l'SDK Places per iOS (nuovo) in modo da pagare solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando elenchi di campi, chiamati anche mascherine di campo.
Con l'SDK Places per iOS e la ricerca testuale, 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 |
countryadministrative_area_level_1administrative_area_level_2postal_codelocality