Scegli la versione dell'SDK

Le funzionalità di Places SDK per iOS disponibili nella tua 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 illustra le differenze tra le versioni e come selezionare quelle attivate nella tua app.

Numeri di versione dell'SDK

Il numero di versione dell'SDK specificato nelle dipendenze del pacchetto determina se la tua app ha accesso alle funzionalità aggiunte in una determinata release. Ad esempio, la funzionalità di completamento automatico (nuova) è disponibile solo nell'SDK nella versione 9.0.0 o successive.

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

Versioni dell'API Places per l'SDK Places for iOS

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 Autocompletamento o Autocompletamento (nuovo). Sebbene tu possa specificare un solo numero di versione dell'SDK, puoi attivare contemporaneamente sia l'API Places sia l'API Places (nuova) nella chiave API. 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 restrizioni relative alle chiavi API, abilita l'API Places, l'API Places (nuova) o entrambe. Per ulteriori informazioni, vedi Limitare le chiavi API.
  3. Quando installi l'SDK, specifica il numero di versione. Per ulteriori informazioni, consulta la sezione Configurare un progetto Xcode.

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 richieste per ogni funzionalità dell'SDK:

SDK Places per iOS (novità) Versione SDK minima Places SDK for iOS Versione SDK minima
Place Details (versione nuova) 9.0.0 Dettagli sul luogo 3.0.0
Inserisci foto (nuova) 9.0.0 Posiziona foto 3.0.0
Ricerca di testo (novità) 8.5.0
Ricerca nelle vicinanze (novità) 9.0.0
Completamento automatico (novità) 9.0.0 Completamento automatico 3.0.0
Luogo attuale 3.0.0

Considerazioni per la scelta delle versioni da attivare

  • Se sei un nuovo cliente che sta iniziando a utilizzare Places SDK for iOS, inizia con l'API Places (nuova) e il nuovo SDK.
  • Se sei già un cliente, puoi continuare a utilizzare l'SDK esistente. Tuttavia, per usufruire dei miglioramenti delle prestazioni e delle funzionalità del nuovo SDK Places for iOS, devi attivare l'API Places (nuova) e utilizzare il nuovo SDK. Non è necessaria alcuna migrazione per passare al nuovo SDK. Segui semplicemente i passaggi descritti in Selezionare la versione dell'SDK e i servizi API.
  • L'API Places (nuova) non attiva alcune funzionalità esistenti come Luogo corrente, GMSPlace.isOpen e GMSPlace.isOpenAtDate.

Utilizzare l'SDK Places Swift per iOS (anteprima)

Per utilizzare l'SDK Places Swift per iOS (anteprima), sono necessari i seguenti passaggi:

  1. Abilita l'API Places (nuova).
  2. Aggiungi Places Swift SDK per iOS (anteprima) alle tue dipendenze.
  3. Inizializza il client Places con PlacesClient.

Per scoprire di più su Places Swift SDK per iOS (anteprima), consulta la panoramica o la guida alla migrazione.

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:

Miglioramenti nell'SDK Places per iOS (novità)

Questa sezione illustra le funzionalità principali aggiunte a Places SDK for iOS (novità).

Implementato sulla piattaforma standard di Google Cloud

Places SDK for iOS (nuovo) è implementato nell'infrastruttura del 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 Places SDK for iOS (novità).

Prestazioni migliorate

Places SDK for iOS (nuovo) offre prestazioni migliorate, quindi conviene sostituire le app che utilizzano l'SDK esistente.

Nuove funzionalità

Il nuovo SDK Places for iOS include le versioni più recenti di tutte le funzionalità dell'SDK:

Prezzi semplificati

I prezzi sono semplificati con Places SDK for iOS (nuovo) in modo da pagare solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando elenchi di campi, chiamati anche maschere di campo.

Con l'SDK Places per iOS e la ricerca di testo, utilizzi gli elenchi di campi per controllare l'elenco di 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 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 la sezione 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 Place Details e Text Search. 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