L'API Places supporta due versioni API: L'API Places API esistenti e API Places (Novità) sono le successive delle API di Google Cloud.
Con il rilascio dell'API Places (Novità), la prima attività consiste nel decidere quale una serie di API da utilizzare. Ciò vale se sei un nuovo cliente o un cliente esistente che già utilizza le API. Utilizza questa guida per comprendere i concetti chiave le differenze tra le due API.
Elenco delle API
La tabella seguente elenca entrambi i set di API. Se sei già cliente, utilizza questa tabella per determinare la nuova API che sostituisce un'API che stai attualmente in uso.
| 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 devono usare Ricerca testuale (novità) 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 sulla chiave API controlla le API utilizzate dalla tua app:
API Places: abilita le API esistenti. Se solo L'API Places è abilitata per il progetto associato a la chiave API utilizzata per l'app, quest'ultima non avrà accesso alle nuove API.
API Places (nuova): abilita tutte le nuove API e descritte in Funzionalità principali aggiunte a SDK Places per iOS (novità). La tua app non hanno accesso alle API esistenti.
Entrambe: abilita tutte le funzionalità e le API per entrambi SDK Places per iOS (novità) e 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 ciascuna 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 nella infrastruttura di servizi su Google Cloud. Questa implementazione comporta una maggiore sicurezza e affidabilità piattaforma con opzioni di sicurezza avanzate come OAuth. Questa API standard la progettazione fornisce un livello di coerenza tra le API che migliora l'efficienza di sviluppo con l'API Places (Novità).
Prestazioni migliorate
L'API Places (Novità) offre prestazioni migliorate, vale la pena sostituire le app che utilizzano l'API Places esistente.
Determinazione del prezzo semplificata
La determinazione dei prezzi è semplificata con l'API Places (nuova), in modo che paghi solo per i dati che utilizzi. La determinazione del prezzo semplificata viene implementata utilizzando maschera del campo.
Con Place Details (novità), Ricerca nelle vicinanze (novità) e Ricerca testuale (Novità): utilizzi la maschera dei campi per controllare le l'elenco dei campi da restituire nella risposta. Ti verranno quindi addebitati solo i dati richiesto. Il mascheramento dei campi è una buona pratica di progettazione per garantire non richiedono dati non necessari, così eviterai inutili tempi di elaborazione e addebiti di fatturazione.
Dati di risposta coerenti per un luogo
Con le API esistenti, Place Details Nearby Search e Text Search Le API hanno restituito dati di risposta diversi per un luogo. API Places (novità) standardizza la risposta in modo che tutte queste API 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 in Tabella A.
Inoltre, la nuova API aggiunge i tipi di luogo mostrati nella tabella seguente. Puoi utilizza questi nuovi tipi e quelli esistenti in una ricerca con Ricerca nelle vicinanze (novità) e Ricerca testuale (novità). I nuovi tipi sono tutti inclusi in 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 |
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
Dati dei luoghi dinamici
L'API Places (nuova) supporta dati di risposta dinamica, come la disponibilità di una stazione di ricarica EV o i prezzi del carburante di una stazione di servizio. Utilizza le funzionalità di 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 ha appena iniziato a utilizzare l'API Places, quindi iniziamo con le nuove API.
Se sei un nuovo cliente e non esiste ancora un sostituto per un API esistente, come Place Autocomplete o Query con il completamento automatico, puoi usare una combinazione di API nuove ed esistenti.
Se sei un cliente esistente, puoi continuare a utilizzare su quelle di livello inferiore. Tuttavia, per sfruttare i miglioramenti delle prestazioni e funzionalità migliorate dell'API Places (novità), puoi eseguire la migrazione nuove API.
Per ulteriori informazioni sulla migrazione, vedi Migrazione Panoramica.