Informazioni sull'API Places (novità)

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

Questo documento contiene una panoramica di queste nuove API.

Dettagli luogo (novità)

Un place ID 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 particolare stabilimento o punto d'interesse avviando una richiesta Dettagli luogo (nuova). Una richiesta Place Details (nuova) restituisce informazioni complete sul luogo indicato, come l'indirizzo completo, il numero di telefono, la valutazione degli utenti e le 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 fornendoti l'accesso ai milioni di foto archiviate nel database di Google Places. Con l'API Place Photo (nuova), puoi accedere alle foto e ridimensionarle in base alle dimensioni ottimali per la tua applicazione.

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

Per includere il nome della risorsa di foto nella risposta di una richiesta Dettagli luogo (nuova), Ricerca testuale (nuova) o Ricerca nelle vicinanze (nuova), assicurati di includere il campo photos nella maschera dei campi della richiesta.

Ricerca testuale (novità) e Ricerca nelle vicinanze (novità)

L'API Places include due API di ricerca:

  • Ricerca testuale (novità)

    Consente di specificare una stringa di testo in base alla quale cercare un luogo. Ad esempio: "Spicy Vegetarian Food in Sydney, Australia" o "Cucina di pesce raffinato vicino a Palo Alto, CA".

    Puoi perfezionare la ricerca specificando dettagli come livelli di prezzo, stato di apertura attuale, valutazioni o tipi di luogo specifici. Puoi anche specificare di differenziare i risultati per una località specifica o limitare la ricerca a una località specifica.

  • Ricerca nelle vicinanze (novità)

    Ti consente di specificare una regione in cui eseguire la ricerca insieme a un elenco di tipi di luogo. Specifica la regione come un cerchio definito dalle coordinate di latitudine e longitudine del punto centrale e del raggio in metri.

    Specifica uno o più tipi di luogo che definiscono le caratteristiche del luogo. Ad esempio, specifica "pizza_restaurant" e "shopping_mall" per cercare una pizzeria che si trova in un centro commerciale nella regione specificata.

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

Completamento automatico (nuovo) e token di sessione

Autocomplete (New) è un servizio web che restituisce previsioni sui luoghi e sulle query in risposta a una richiesta HTTP. Nella richiesta, specifica una stringa di ricerca testuale e limiti geografici che controllano l'area di ricerca.

I token di sessione sono stringhe generate dall'utente che tracciano le chiamate di completamento automatico (nuove) come sessioni. Il completamento automatico (novità) utilizza i token di sessione per raggruppare le fasi di query e selezione della ricerca di completamento automatico di un utente in una sessione distinta ai fini della fatturazione.

Nuovi campi, attributi e opzioni di accessibilità

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

Campi

L'API Places (Novità) include diversi nuovi campi:

Campo Descrizione
regularSecondaryOpeningHours Descrive gli orari specifici per determinate operazioni. Gli orari di apertura secondari sono diversi dall'orario principale di un'attività. Ad esempio, un ristorante può specificare gli orari di drive-through o di consegna come orari secondari.
paymentOptions Opzioni di pagamento accettate dal luogo. Un luogo può accettare più di un'opzione di pagamento. Se i dati dell'opzione di pagamento non sono disponibili, il campo dell'opzione di pagamento non verrà impostato. Sono incluse le seguenti opzioni:
  • Carta di credito
  • Carta di debito
  • Solo contanti
  • pagamento NFC
parkingOptions Opzioni di parcheggio offerte dal luogo. Sono incluse le seguenti opzioni:
  • Parcheggi gratuiti
  • Parcheggi a pagamento
  • Parcheggio in strada senza costi
  • Servizio di ritiro e riconsegna auto
  • Parcheggio in garage senza costi
  • Parcheggio in garage a pagamento
subDestinations Luoghi unici correlati a un luogo specifico. Ad esempio, i terminal aeroportuali sono considerati destinazioni secondarie di un aeroporto.
fuelOptions Le informazioni più recenti sulle opzioni di carburante disponibili presso una stazione di servizio. Queste informazioni vengono aggiornate regolarmente. Sono incluse le seguenti opzioni:
  • Diesel
  • Normale senza piombo
  • 89 ottani
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • GPL
  • E80
  • E85
  • Metano
  • Biodiesel
  • Autocarri diesel
evChargeOptions Numero di stazioni di ricarica di veicoli elettrici (EV) in questa stazione. Anche se alcuni caricabatterie EV hanno più connettori, ogni caricabatterie può caricare un solo veicolo alla volta; di conseguenza, questo campo riflette il numero di stazioni di ricarica EV disponibili in un determinato momento.
shortFormattedAddress Un indirizzo breve e leggibile di 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 la sezione Tipi supportati.
primaryTypeDisplayName Il nome visualizzato del tipo principale, localizzato nella lingua della richiesta, se applicabile. Per l'elenco completo dei valori possibili, consulta la sezione Tipi supportati.

Attributi

L'API Places (Novità) include diversi nuovi attributi:

Attributo Descrizione
outdoorSeating Locale con tavoli all'aperto.
liveMusic Questo luogo offre musica dal vivo.
menuForChildren Questo luogo offre un menu per bambini.
servesCocktails Locale che serve cocktail.
servesDessert Locale che serve dessert.
servesCoffee Locale che serve caffè.
goodForChildren Questo posto è adatto ai bambini.
allowsDogs In questo posto sono ammessi i cani.
restroom Questo luogo dispone di una toilette.
goodForGroups Questo luogo può ospitare gruppi.
goodForWatchingSports Questo luogo è adatto per guardare sport.

Opzioni di accessibilità

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

Campo Descrizione
wheelchairAccessibleParking Questo luogo offre un parcheggio accessibile in sedia a rotelle.
wheelchairAccessibleEntrance Questo luogo ha un ingresso accessibile in sedia a rotelle.
wheelchairAccessibleRestroom Questo luogo dispone di un bagno accessibile in sedia a rotelle.
wheelchairAccessibleSeating Questo luogo dispone di tavoli accessibili in sedia a rotelle.

Esegui 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: