Informazioni sull'API Places (novità)

Sviluppatori dello Spazio economico europeo (SEE)

Introduzione

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

Questo documento contiene una panoramica di queste nuove API.

Place Details (nuovo)

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

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

Place Photos (nuovo)

Place Photos (New) ti consente di aggiungere contenuti fotografici di alta qualità alla tua applicazione dandoti accesso a milioni di foto archiviate nel database di Google Places. Utilizzando l'API Place Photos (New), puoi accedere alle foto e ridimensionare l'immagine in modo che abbia le dimensioni ottimali per la tua applicazione.

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

Per includere il nome della risorsa foto nella risposta a una richiesta Dettagli luogo (nuovo), Ricerca di testo (nuova) o Ricerca nelle vicinanze (nuova), assicurati di includere il campo photos nella maschera del campo della richiesta.

Ricerca testuale (nuova) e Ricerca nelle vicinanze (nuova)

L'API Places include due API di ricerca:

  • Ricerca di testo (novità)

    Consente di specificare una stringa di testo su cui cercare un luogo. Ad esempio: "Cucina vegetariana piccante a Sydney, Australia" o "Ristorante 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 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 insieme a 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 luogo che definiscono le caratteristiche del luogo. Ad esempio, specifica "pizza_restaurant" e "shopping_mall" per cercare una pizzeria situata in un centro commerciale nella regione specificata.

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

Autocomplete (New) e token di sessione

Completamento automatico (nuovo) è un servizio web che restituisce previsioni sui luoghi e sulle 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 dall'utente che monitorano le chiamate Autocomplete (New) come sessioni. Autocomplete (New) utilizza i token di sessione per raggruppare le fasi di query e selezione di una ricerca di completamento automatico dell'utente in una sessione discreta ai fini della fatturazione.

Nuovi campi, attributi e opzioni di accessibilità

L'API Places (New) 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 (New) include diversi nuovi campi:

Campo Descrizione
regularSecondaryOpeningHours Descrive orari particolari per determinate operazioni. L'orario di apertura secondario è diverso dall'orario principale di un'attività. Ad esempio, un ristorante può specificare gli orari del servizio drive-through o della consegna a domicilio 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 verrà deselezionato. Le opzioni includono quanto segue:
  • Carta di credito
  • Carta di debito
  • Solo contanti
  • pagamento NFC
parkingOptions Opzioni di parcheggio offerte dal luogo. Le opzioni includono quanto segue:
  • Parcheggi gratuiti
  • Parcheggi a pagamento
  • Parcheggio in strada gratuito
  • Servizio ritiro e riconsegna auto
  • Garage gratuito
  • Garage a pagamento
subDestinations Luoghi unici correlati a un luogo specifico. 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. Le opzioni includono le seguenti:
  • Diesel
  • Senza piombo normale
  • 89 ottani
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • GPL
  • E80
  • E85
  • Metano
  • Biodiesel
  • Diesel per camion
evChargeOptions Numero di stazioni di ricarica per veicoli elettrici (EV) in questa stazione. Sebbene alcune stazioni di ricarica EV abbiano più connettori, ogni stazione può ricaricare 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 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 (New) include diversi nuovi attributi:

Attributo Descrizione
outdoorSeating Il locale offre tavoli all'aperto.
liveMusic Il locale 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 luogo è adatto ai bambini.
allowsDogs Il luogo ammette cani.
restroom Il locale dispone di una toilette.
goodForGroups La struttura può ospitare gruppi.
goodForWatchingSports Il luogo è adatto per guardare sport.

Opzioni di accessibilità

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

Campo Descrizione
wheelchairAccessibleParking Il posto offre un parcheggio accessibile alle sedie a rotelle.
wheelchairAccessibleEntrance Il luogo ha un ingresso accessibile in sedia a rotelle.
wheelchairAccessibleRestroom Il luogo dispone di una toilette accessibile in sedia a rotelle.
wheelchairAccessibleSeating Il locale è dotato di posti a sedere accessibili alle sedie a rotelle.

Riepiloghi basati sull'AI

API Places (Novità) I riepiloghi basati sull'intelligenza artificiale sfruttano le funzionalità del modello Gemini per restituire riepiloghi su luoghi e aree che possono aiutare gli utenti a decidere dove andare.

I riepiloghi basati sull'intelligenza artificiale sintetizzano i dati provenienti da una varietà di input per aiutare gli utenti a prendere decisioni più consapevoli su un luogo. Ad esempio, se stai pensando di provare un nuovo ristorante, un riepilogo basato sull'intelligenza artificiale può evidenziare i punti salienti del menu, darti un'idea dell'atmosfera o raccogliere argomenti dalle recensioni degli utenti. Se stai visitando una nuova città, un riepilogo basato sull'intelligenza artificiale può fornirti una panoramica delle attrazioni e dei servizi nelle vicinanze.

Funzionalità basate sull'intelligenza artificiale aggiunte all'API Places (Novità)

I riepiloghi basati sull'intelligenza artificiale sono supportati da Dettagli luogo (nuovo), Ricerca testuale (nuovo) e Ricerca nelle vicinanze (nuovo). Nelle risposte dell'API Places (New) sono disponibili i seguenti riepiloghi basati sull'AI:

  • Riepiloghi dei luoghi, che sono brevi riepiloghi relativi a un luogo specifico.
  • Riepiloghi delle recensioni, che sono riepiloghi di facile lettura di ciò che hanno detto i recensori di un luogo.
  • Riepiloghi delle aree, che forniscono panoramiche dei luoghi vicini e più popolari nelle vicinanze. Questi includono i riepiloghi dei quartieri e delle stazioni di ricarica EV.

Google rigenera frequentemente questi riepiloghi per garantire che siano aggiornati in base alle informazioni più recenti disponibili. Quando effettui una richiesta API Places (nuova), nella tua app verranno visualizzati i dati più recenti.

Esegui la migrazione alle nuove API Places

Se sei un cliente esistente dell'API Places (New) e vuoi eseguire la migrazione della tua app per utilizzare le nuove API, consulta la seguente documentazione sulla migrazione: