Scegli la versione dell'API

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:

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
Insieme a questi nuovi tipi, l'API Places (Nuova) ha spostato i seguenti tipi dalla Tabella B dalla Tabella A. Ciò significa che ora puoi utilizzare i seguenti tipi in una ricerca:
  • 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:

  1. Se sei un nuovo cliente che ha appena iniziato a utilizzare l'API Places, inizia con le nuove API.

  2. 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.

  3. 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.