L'API Places supporta due versioni API: l'API Places è l'API esistente e l'API Places (nuova) è 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 per i nuovi clienti o per i clienti esistenti che utilizzano già le API. Usa questa guida per comprendere le principali differenze tra le due API.
Elenco delle API
La tabella seguente elenca entrambi i set di API. Se sei un cliente esistente, utilizza questa tabella per determinare la nuova API che sostituisce un'API che stai utilizzando.
| API Places | API Places (Novità) | Nota |
|---|---|---|
| Trova luogo | Ricerca testuale (novità) | Non è disponibile una nuova versione di Trova luogo. Ricerca testuale (nuova) l'ha sostituita. |
| Ricerca nelle vicinanze | Ricerca nelle vicinanze (novità) | Tutte le richieste che utilizzano l'API esistente che includono una query di testo dovrebbero usare Ricerca testuale (nuova) perché Ricerca nelle vicinanze (nuova) non supporta l'input di testo. |
| Ricerca testuale | Ricerca testuale (novità) | |
| Dettagli del luogo | Dettagli del luogo (novità) | |
| Foto del luogo | Foto del luogo (novità) | |
| 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 per il progetto associato alla chiave API utilizzata per l'app è abilitata solo l'API Places, quest'ultima non avrà accesso alle nuove API.
API Places (nuova): attiva tutte le nuove API e funzionalità descritte in Funzionalità principali aggiunte all'SDK Places per iOS (nuova). 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 a Ricerca nelle vicinanze (novità)
- Eseguire la migrazione a Ricerca testuale (novità)
- Eseguire la migrazione a Place Details (novità)
- Eseguire la migrazione a Place Photo (novità)
- Eseguire la migrazione a Autocomplete (novità)
Funzionalità principali aggiunte all'API Places (novità)
Questa sezione illustra le funzionalità principali aggiunte all'API Places (novità).
Implementata sulla piattaforma standard di Google Cloud
L'API Places (nuova) è implementata nell'infrastruttura dei servizi su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile, con opzioni di sicurezza avanzate come OAuth. Questa progettazione dell'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.
Determinazione del prezzo semplificata
I prezzi sono semplificati con l'API Places (nuova) in modo che paghi solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando una maschera di campo.
Con Place Details (Novità), Nearby Search (New) e Text Search (Novità) puoi utilizzare la maschera del campo 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 pratica di progettazione per evitare di richiedere dati non necessari, evitando così 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 (nuova) standardizza la risposta, in modo che tutte restituiscano gli stessi dati per un luogo.
Tipi di luogo 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 mostrati nella tabella seguente. Puoi utilizzare questi nuovi tipi, e quelli esistenti, in una ricerca con Ricerca nelle vicinanze (nuova) e Ricerca testuale (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 | 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 | 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 |
Insieme a questi nuovi tipi, l'API Places (nuova) ha spostato i seguenti tipi dalla tabella 2 per l'API Places alla tabella A per l'API Places (nuova). Ciò significa che ora puoi utilizzare i seguenti tipi come parte 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?
Per poter iniziare a sviluppare l'app, devi prima scegliere l'API:
Se sei un nuovo cliente che ha appena iniziato a utilizzare l'API Places, puoi iniziare 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 usufruire dei miglioramenti delle prestazioni e delle funzionalità dell'API Places (nuova), puoi eseguire la migrazione alle nuove API.
Per ulteriori informazioni sulla migrazione, vedi Panoramica della migrazione.