L'API Places supporta due versioni: API Places sono le API esistenti e API Places (Nuova) sono la versione di nuova generazione delle API.
Con il rilascio dell'API Places (nuova), la prima attività è decidere quale set di API utilizzare. Questo vale se sei un nuovo cliente o un cliente esistente che utilizza già le API. Utilizza questa guida per comprendere le principali differenze tra le due API.
Elenco di API
La tabella seguente elenca entrambi gli insiemi di API. Se sei già cliente, utilizza questa tabella per determinare la nuova API che sostituisce un'API attualmente in uso.
| API Places | API Places (Novità) | Nota |
|---|---|---|
| Trova un luogo | Ricerca di testo (novità) | Non è disponibile una nuova versione di Trova luogo. La ricerca di testo (nuova) lo ha sostituito. |
| Ricerca nelle vicinanze | Ricerca nelle vicinanze (novità) | Tutte le richieste che utilizzano l'API esistente e includono una query di testo devono utilizzare Ricerca di testi (nuova) perché la Ricerca nelle vicinanze (nuova) non supporta l'input di testo. |
| Ricerca di testo | Ricerca di testo (novità) | |
| Dettagli sul luogo | Dettagli del luogo (novità) | |
| Foto del luogo | Inserisci foto (nuova) | |
| Place Autocomplete | Completamento automatico (novità) | |
| Completamento automatico delle query | Completamento automatico (novità) | Funzionalità aggiunte al completamento automatico (novità) |
La versione del servizio API Places che abiliti nella chiave API controlla le API utilizzate dalla tua app:
API Places: abilita le API esistenti. Se è attivata solo l'API Places per il progetto associato alla chiave API utilizzata per la tua app, quest'ultima non avrà accesso alle nuove API.
API Places (novità): abilita tutte le nuove API e le nuove funzionalità descritte in Funzionalità principali aggiunte a Maps SDK for iOS (novità). La tua app non avrà accesso alle API esistenti.
Entrambi: abilita tutte le funzionalità e le API sia per l'SDK Places per iOS (nuovo) sia per l'SDK Places per iOS.
Per ulteriori informazioni sulla selezione del servizio API Places, consulta Configurare il progetto Google Cloud.
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 alla Ricerca nelle vicinanze (novità)
- Eseguire la migrazione alla ricerca di testo (novità)
- Eseguire la migrazione a Place Details (novità)
- Eseguire la migrazione a Foto Ricordo (nuova)
- Eseguire la migrazione a Completamento automatico (novità)
Funzionalità principali aggiunte all'API Places (novità)
Questa sezione illustra le funzionalità principali aggiunte all'API Places (nuova).
Implementato sulla piattaforma standard di Google Cloud
L'API Places (nuova) è implementata nell'infrastruttura di servizio su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile, con opzioni di sicurezza avanzate come OAuth. Questa progettazione API standard garantisce un livello di coerenza tra le API che migliorano l'efficienza dello sviluppo con l'API Places (Novità).
Prestazioni migliorate
L'API Places (nuova) offre prestazioni migliorate, perciò vale la pena sostituire le app che utilizzano l'API Places esistente.
Prezzi semplificati
I prezzi sono semplificati con la nuova API Places, in modo da pagare solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando una maschera di campo.
Con i comandi Dettagli dei luoghi (novità), Ricerca nelle vicinanze (novità) e Ricerca di testo (novità), puoi utilizzare la maschera dei campi per controllare l'elenco dei campi da restituire nella risposta. Ti verranno addebitati solo i dati richiesti. L'utilizzo del mascheramento dei campi è una buona prassi di progettazione per evitare di richiedere dati non necessari, evitando così tempi di elaborazione e addebiti di fatturazione non necessari.
Dati di risposta coerenti per un luogo
Con le API esistenti, le API Place Details, Nearby Search e Text Search hanno restituito dati di risposta diversi per un luogo. L'API Places (nuova) standardizza la risposta in modo che queste API restituiscano tutte gli stessi dati per un luogo.
Tipi di luoghi espansi
La risposta dell'API ora può contenere il tipo principale di un luogo. Ogni luogo può avere un singolo valore di tipo specificato come tipo principale del luogo, come indicato nella Tabella A.
Inoltre, la nuova API aggiunge i tipi di luoghi mostrati nella tabella seguente. Puoi utilizzare questi nuovi tipi e quelli esistenti in una ricerca con Ricerca nelle vicinanze (novità) e Ricerca di testo (novità). I nuovi tipi sono tutti 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 | 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 |
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:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dati dei luoghi dinamici
L'API Places (nuova) supporta i dati di risposta dinamica, come la disponibilità di una stazione di ricarica EV o i prezzi del carburante più recenti per una stazione di servizio. Utilizza questi campi di risposta per creare esperienze utente dinamiche.
Quale API scegli?
Prima di poter iniziare lo sviluppo dell'app, devi scegliere l'API:
Se sei un nuovo cliente che sta iniziando a utilizzare l'API Places, inizia con le nuove API.
Se sei un nuovo cliente e non esiste ancora una sostituzione per un'API esistente, come Place Autocomplete o Query Autocomplete, puoi utilizzare una combinazione di API nuove ed esistenti.
Se sei un cliente esistente, puoi continuare a utilizzare le API esistenti. Tuttavia, per sfruttare i miglioramenti delle prestazioni e le funzionalità avanzate dell'API Places (nuova), puoi eseguire la migrazione alle nuove API.
Per ulteriori informazioni sulla migrazione, consulta la Panoramica della migrazione.