Scegli la versione dell'API

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:

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:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

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:

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

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

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