Le funzioni di Places SDK per iOS disponibili nel tuo vengono determinate da una combinazione del numero di versione dell'SDK (ad es. 9.0.0) che specificato nelle dipendenze del pacchetto e le API abilitate nella chiave API. Questa guida spiega le differenze tra le versioni e come scegliere quali siano attivate 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 a funzionalità che sono state aggiunte in un una determinata release. Ad esempio, Autocomplete (New) è disponibile solo nell'SDK versione 9.0.0 o successiva.
Per ulteriori informazioni sulle modifiche introdotte in ogni versione dell'SDK, consulta la sezione Places Note di rilascio dell'SDK per iOS.
Versioni dell'API Places per Places SDK for iOS
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. Nella maggior parte dei casi, però, è consigliabile attivare API Places (nuova) e utilizza 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) 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.
- Quando installi l'SDK, specifica il numero di versione. Per ulteriori informazioni, consulta Configurare un progetto Xcode.
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 | 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 l'SDK Places per iOS, iniziano con l'API Places (Novità) e il nuovo SDK.
- Se sei già cliente, puoi continuare a utilizzare l'SDK esistente. Tuttavia, per sfruttare i miglioramenti delle prestazioni e le funzionalità miglioramenti di Places SDK for iOS (novità), devi abilitare l'API Places (Nuovo) e utilizza il nuovo SDK. Non è necessaria alcuna migrazione durante lo spostamento il nuovo SDK, segui i passaggi descritti in Selezionare la versione dell'SDK e l'API Google Cloud.
- L'API Places (nuova) non abilita alcuni
come Currents
Luogo,
GMSPlace.isOpeneGMSPlaceisOpenAtDate.
Utilizza la versione di anteprima di GooglePlacesSwift
Per utilizzare GooglePlacesSwift sono necessari i seguenti passaggi:
- Abilita l'API Places (Nuova).
- Aggiungi il parametro GooglePlacesSwiftSDK alle tue dipendenze.
- Inizializzare il client Places con
PlacesClient
Per ulteriori informazioni su GooglePlacesSwift, consulta il riferimento documentazione.
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 ciascuna 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 funzioni principali aggiunte a Places SDK per iOS (Novità).
Implementata sulla piattaforma standard di Google Cloud
L'SDK Places per iOS (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 iOS (Novità).
Prestazioni migliorate
L'SDK Places per iOS (novità) fornisce prestazioni migliori, consentendo di 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 funzionalità 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 o maschere di campo.
Con l'SDK Places per iOS 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