Informazioni sull'API Places (novità)

L'API Places (nuova) include le seguenti API:

Questo documento contiene una panoramica di queste nuove API.

Dettagli dei luoghi (novità)

Un ID luogo identifica in modo univoco un luogo nel database di Google Places e su Google Maps. Con un ID luogo, puoi richiedere i dettagli di un determinato esercizio o punto d'interesse avviando una richiesta Place Details (New). Una richiesta di dettagli sul luogo (nuova) restituisce informazioni complete sul luogo indicato, ad esempio indirizzo completo, numero di telefono, valutazione degli utenti e recensioni.

Esistono molti modi per ottenere un ID luogo. Puoi utilizzare:

Foto del luogo (novità)

L'API Place Photo (nuova) ti consente di aggiungere contenuti fotografici di alta qualità alla tua applicazione dandoti accesso a milioni di foto archiviate nel database di Google Places. Con l'API Place Photo (nuova), puoi accedere alle foto e ridimensionare l'immagine in base alle dimensioni ottimali per la tua applicazione.

Tutte le richieste all'API Place Photo (nuova) devono includere un nome della risorsa foto, che identifica in modo univoco la foto da restituire. Per ottenere il nome della risorsa fotografica, utilizza:

Per includere il nome della risorsa foto nella risposta di una richiesta di dettagli dei luoghi (novità), di ricerca di testo (novità) o di ricerca nelle vicinanze (novità), assicurati di includere il campo photos nella maschera di campo della richiesta.

Ricerca di testo (novità) e Ricerca nelle vicinanze (novità)

L'API Places include due API di ricerca:

  • Ricerca di testo (novità)

    Consente di specificare una stringa di testo in base alla quale cercare un luogo. Ad esempio: "Cibo vegetariano piccante a Sydney, Australia" o "Ristoranti di pesce raffinati vicino a Palo Alto, California".

    Puoi perfezionare la ricerca specificando dettagli come livelli di prezzo, stato di apertura corrente, valutazioni o tipi di luoghi specifici. Puoi anche specificare di orientare i risultati verso una località specifica o limitare la ricerca a una località specifica.

  • Ricerca nelle vicinanze (novità)

    Consente di specificare una regione in cui effettuare la ricerca e un elenco di tipi di luoghi. Specifica la regione come un cerchio definito dalle coordinate di latitudine e longitudine del punto centrale e dal raggio in metri.

    Specifica uno o più tipi di luoghi che definiscono le caratteristiche del luogo. Ad esempio, specifica "pizza_restaurant" e "shopping_mall" per cercare un ristorante di pizza situato in un centro commerciale nella regione specificata.

La differenza principale tra le due ricerche è che la ricerca di testo (nuova) consente di specificare una stringa di ricerca arbitraria, mentre la ricerca nelle vicinanze (nuova) richiede un'area specifica in cui eseguire la ricerca.

Token di completamento automatico (nuovo) e di sessione

Completamento automatico (nuovo) è un servizio web che restituisce le previsioni relative ai luoghi e alle query in risposta a una richiesta HTTP. Nella richiesta, specifica una stringa di ricerca di testo e i limiti geografici che controllano l'area di ricerca.

I token di sessione sono stringhe generate dagli utenti che monitorano le chiamate di Autocompletamento (Nuova) come sessioni. La funzionalità di completamento automatico (nuova) utilizza i token di sessione per raggruppare le fasi di query e selezione di una ricerca di completamento automatico dell'utente in una sessione distinta a fini di fatturazione.

Nuovi campi, attributi e opzioni di accessibilità

La nuova API Places include nuovi campi, attributi e opzioni di accessibilità per fornire agli utenti maggiori informazioni su un luogo. Questi aspetti sono descritti nelle sezioni seguenti.

Campi

L'API Places (nuova) include diversi nuovi campi:

Campo Descrizione
regularSecondaryOpeningHours Descrive orari specifici per determinate operazioni. Gli orari di apertura secondari sono diversi da quelli principali di un'attività. Ad esempio, un ristorante può specificare come orari secondari quelli del servizio in auto o della consegna a domicilio.
paymentOptions Le opzioni di pagamento accettate dal luogo. Un luogo può accettare più di un'opzione di pagamento. Se i dati relativi all'opzione di pagamento non sono disponibili, il campo dell'opzione di pagamento non verrà impostato. Le opzioni disponibili sono le seguenti:
  • Carta di credito
  • Carta di debito
  • Solo contanti
  • pagamento NFC
parkingOptions Opzioni di parcheggio offerte dalla struttura. Le opzioni disponibili sono le seguenti:
  • Parcheggi gratuiti
  • Parcheggi a pagamento
  • Parcheggio in strada gratuito
  • Servizio ritiro e riconsegna auto
  • Garage senza costi
  • Garage a pagamento
subDestinations Luoghi unici correlati a un determinato luogo. Ad esempio, i terminal aeroportuali sono considerati sottodestinazioni di un aeroporto.
fuelOptions Le informazioni più recenti sulle opzioni di carburante disponibili in una stazione di servizio. Queste informazioni vengono aggiornate regolarmente. Tra le opzioni disponibili sono incluse le seguenti:
  • Diesel
  • Benzina senza piombo normale
  • 89 ottani
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • GPL
  • E80
  • E85
  • Metano
  • Biodiesel
  • Camion diesel
evChargeOptions Numero di stazioni di ricarica per veicoli elettrici (EV) in questa stazione. Anche se alcuni caricabatterie EV hanno più connettori, ogni caricabatterie può ricaricare un solo veicolo alla volta. Di conseguenza, questo campo riflette il numero di caricabatterie EV disponibili in un determinato momento.
shortFormattedAddress Un indirizzo breve e leggibile per un luogo.
primaryType Il tipo principale del risultato specificato. Ad esempio, un luogo può essere classificato come cafe o airport. Un luogo può avere un solo tipo principale. Per l'elenco completo dei valori possibili, consulta Tipi supportati.
primaryTypeDisplayName Il nome visualizzato del tipo principale, localizzato nella lingua della richiesta, se applicabile. Per l'elenco completo dei valori possibili, consulta Tipi supportati.

Attributi

L'API Places (nuova) include diversi nuovi attributi:

Attributo Descrizione
outdoorSeating Il locale offre posti a sedere all'aperto.
liveMusic Il luogo offre musica dal vivo.
menuForChildren Il locale offre un menu per bambini.
servesCocktails Il locale serve cocktail.
servesDessert Il locale serve dessert.
servesCoffee Il locale serve caffè.
goodForChildren Il posto è adatto ai bambini.
allowsDogs Il luogo ammette cani.
restroom Il luogo dispone di un bagno.
goodForGroups Il luogo può ospitare gruppi.
goodForWatchingSports Il luogo è adatto per guardare sport.

Opzioni di accessibilità

L'API Places (nuova) include i seguenti campi di opzioni di accessibilità:

Campo Descrizione
wheelchairAccessibleParking La struttura offre un parcheggio accessibile in sedia a rotelle.
wheelchairAccessibleEntrance Il luogo dispone di un ingresso accessibile in sedia a rotelle.
wheelchairAccessibleRestroom Il luogo dispone di una toilette accessibile in sedia a rotelle.
wheelchairAccessibleSeating Il luogo dispone di posti a sedere accessibili in sedia a rotelle.

Eseguire la migrazione alle nuove API Places

Se sei già cliente dell'API Places e vuoi eseguire la migrazione della tua app per utilizzare le nuove API, consulta la seguente documentazione sulla migrazione: