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 cosa da fare è decidere quale insieme di API utilizzare. Questo vale se sei un nuovo cliente o un cliente esistente che utilizza già le API. Consulta 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 che stai utilizzando.
| API Places | API Places (Novità) | Nota |
|---|---|---|
| Trova un luogo | Ricerca di testo (novità) | Non è disponibile una nuova versione di Trova posto. La ricerca di testo (nuova) lo ha sostituito. |
| Ricerca nelle vicinanze | Ricerca nelle vicinanze (nuova) | 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 | Place Details (versione nuova) | |
| Inserisci foto | 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 dell'API Places che attivi sulla tua chiave API controlla le API utilizzate dalla tua app:
API Places: abilita le API esistenti. Se solo l'API Places è attivata 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 all'SDK Places per iOS (novità). La tua app non avrà accesso alle API esistenti.
Entrambe: abilita tutte le funzionalità e le API sia per SDK Places per iOS (nuovo) sia per 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 eseguirne 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 di luoghi (novità)
- Eseguire la migrazione a Completamento automatico (novità)
Funzionalità principali aggiunte all'API Places (novità)
Questa sezione illustra le funzionalità chiave 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. Questo design dell'API standard offre un livello di coerenza tra le API che migliora l'efficienza sviluppo con l'API Places (nuova).
Prestazioni migliorate
L'API Places (nuova) offre un rendimento migliore, quindi vale la pena sostituire le app che utilizzano l'API Places esistente.
Prezzi semplificati
I prezzi sono semplificati con l'API Places (nuova) in modo da pagare solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando una maschera di campo.
Con Dettagli sui luoghi (novità), Ricerca nelle vicinanze (novità) e Ricerca di testo (novità) utilizzi la maschera di campo per controllare l'elenco di campi da restituire nella risposta. Ti verrà addebitato solo il costo dei dati richiesti. L'utilizzo della maschera dei campi è una buona prassi di progettazione per assicurarti di non richiedere dati non necessari, il che consente di evitare tempi di elaborazione e addebiti in fatturazione non necessari.
Dati di risposta coerenti per un luogo
Con le API esistenti, le API Place Details, Nearby Search e Text Search restituivano 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 | sarto |
| 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 sui luoghi dinamici
La nuova API Places supporta i dati di risposta dinamica, come la disponibilità di una stazione di ricarica EV o i prezzi più recenti del carburante 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 Autocompletamento di luoghi o Autocompletamento di query, 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.