L'API Places supporta due versioni API: l'API Places è le API esistenti e l'API Places (nuova) è la versione di nuova generazione delle API.
Con il rilascio dell'API Places (Novità), la prima attività è decidere quale insieme 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 delle API
Nella tabella seguente sono elencati entrambi i set di API. Se sei un cliente esistente, utilizza questa tabella per determinare la nuova API che sostituisce un'API che stai attualmente utilizzando.
API Places | API Places (Novità) | Nota |
---|---|---|
Trova luogo | Ricerca testuale (novità) | Non esiste una nuova versione di Find Place. La funzionalità Ricerca testuale (Nuova) lo ha sostituito. |
Ricerca nelle vicinanze | Ricerca nelle vicinanze (novità) | Tutte le richieste che utilizzano l'API esistente che includono una query di testo devono utilizzare Ricerca testuale (nuova) perché la ricerca nelle vicinanze (nuova) non supporta l'inserimento di testo. |
Ricerca testuale | Ricerca testuale (novità) | |
Dettagli del luogo | Dettagli luogo (novità) | |
Foto del luogo | Foto del luogo (nuova) | |
Place Autocomplete | Completamento automatico (novità) | In anteprima |
Completamento automatico query | Completamento automatico (novità) | Funzionalità aggiunte alla versione di anteprima del completamento automatico (novità) |
La versione del servizio API Places che abiliti nella tua chiave API controlla le API utilizzate dalla tua app:
API Places: abilita le API esistenti. Se è abilitata 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 (nuova): abilita tutte le nuove API e funzionalità descritte in Funzionalità principali aggiunte all'SDK Places per iOS (novità). La tua app non avrà accesso alle API esistenti.
Entrambe: attiva 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, vedi 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 a Ricerca nelle vicinanze (novità)
- Eseguire la migrazione alla ricerca testuale (novità)
- Eseguire la migrazione ai Dettagli del luogo (nuova)
- Esegui la migrazione alla foto del luogo (novità)
- Eseguire la migrazione al completamento automatico (novità)
Funzionalità principali aggiunte all'API Places (novità)
Questa sezione illustra le funzionalità principali aggiunte all'API Places (Novità).
Implementata sulla piattaforma Google Cloud standard
L'API Places (Novità) è implementata nell'infrastruttura dei servizi di Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile con opzioni di sicurezza avanzate come OAuth. Questo design standard delle API offre un livello di coerenza tra le API che migliorano l'efficienza dello sviluppo con l'API Places (Novità).
Prestazioni migliorate
L'API Places (Novità) offre prestazioni migliori, il che rende utile sostituire le app che usano l'API Places esistente.
Prezzi semplificati
I prezzi sono semplificati con l'API Places (Novità), in modo che tu paghi solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando una maschera di campo.
Con Dettagli luogo (Nuovo), Ricerca nelle vicinanze (Nuova) e Ricerca testuale (Nuova), puoi utilizzare la maschera dei campi per controllare l'elenco di campi da restituire nella risposta. Ti vengono quindi addebitati solo i dati richiesti. L'uso del mascheramento dei campi è una buona pratica di progettazione per garantire di non richiedere dati inutili, il che contribuisce a evitare tempi di elaborazione e addebiti di fatturazione superflui.
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 (Novità) 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 elencato nella Tabella A.
Inoltre, la nuova API aggiunge i tipi di luogo indicati nella tabella seguente. Puoi utilizzare questi nuovi tipi, e quelli esistenti, in una ricerca con Ricerca nelle vicinanze (nuova) e Ricerca di testo (Nuova). 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 | 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 |
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality
Dati dinamici dei luoghi
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 di app, devi scegliere l'API:
Se sei un nuovo cliente che ha appena iniziato 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, ad esempio 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 i miglioramenti delle funzionalità dell'API Places (Novità), puoi eseguire la migrazione alle nuove API.
Per maggiori informazioni sulla migrazione, consulta la panoramica della migrazione.