Introduzione
L'API Places (novità) include le seguenti API:
- Place Details (New)
- Place Photos (New)
- Nearby Search (New)
- Ricerca testuale (novità)
- Autocomplete (New)
Questo documento contiene una panoramica di queste nuove API.
Place Details (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 dettagli su una determinata attività o un punto di interesse avviando una richiesta Place Details (New). Una richiesta Place Details (New) 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:
- Ricerca testuale (novità)
- Nearby Search (New)
- API Geocoding
- API Routes
- API Address Validation
- Autocomplete (New)
Place Photos (novità)
Place Photos (New) ti consente di aggiungere contenuti fotografici di alta qualità alla tua applicazione, dandoti accesso ai milioni di foto archiviate nel database di Google Places. Utilizzando l'API Place Photos (New), puoi accedere alle foto e ridimensionare l'immagine alle 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 di una richiesta Place Details (New), Ricerca testuale (New) o Nearby Search (New), assicurati di includere il campo photos nella maschera di campo della richiesta.
Ricerca testuale (Nuovo) e Nearby Search (Nuovo)
L'API Places (nuova) include due API di ricerca:
-
Consente di specificare una stringa di testo in base alla quale cercare un luogo. Ad esempio: "Cibo vegetariano 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 dare priorità ai risultati per una località specifica o limitare la ricerca a una località specifica.
-
Consente di specificare una regione in cui eseguire 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 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 eseguire la ricerca.
Autocomplete (New) e token di sessione
Autocomplete (New) è un servizio web che restituisce previsioni relative ai luoghi e alle query in risposta a una richiesta HTTP. Nella richiesta, specifica una stringa di ricerca testuale e i confini geografici che controllano l'area di ricerca.
I token di sessione sono stringhe generate dall'utente che monitorano le chiamate di Autocomplete (New) come sessioni. Autocomplete (New) utilizza i token di sessione per raggruppare le fasi di query e selezione di una ricerca con completamento automatico dell'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 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 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 di consegna come orari secondari. |
paymentOptions |
Opzioni di pagamento accettate dal luogo. Un'attività 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:
|
parkingOptions |
Opzioni di parcheggio fornite dal luogo. Sono incluse le seguenti opzioni:
|
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 presso una stazione di servizio. Queste informazioni vengono aggiornate regolarmente. Sono incluse le seguenti opzioni:
|
evChargeOptions |
Numero di caricabatterie per veicoli elettrici (EV) presso questa stazione. Sebbene alcuni caricabatterie EV abbiano 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. |
entrances |
Ingressi per la destinazione. Un ingresso è una singola coppia di coordinate di latitudine/longitudine che definisce la posizione di un punto di ingresso e di uscita per un luogo. |
navigationPoints |
Punti di navigazione per la destinazione. Un punto di navigazione è una località accanto a una strada in cui la navigazione può terminare, incluse le modalità di viaggio e gli utilizzi supportati. |
Attributi
L'API Places (nuova) include diversi nuovi attributi:
| Attributo | Descrizione |
|---|---|
outdoorSeating |
Il luogo offre tavoli 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 luogo serve caffè. |
goodForChildren |
Il luogo è adatto ai bambini. |
allowsDogs |
Il luogo ammette i cani. |
restroom |
Il luogo dispone di un bagno. |
goodForGroups |
Il luogo è adatto ai gruppi. |
goodForWatchingSports |
Il luogo è adatto per guardare sport. |
Opzioni di accessibilità
L'API Places (nuova) include i seguenti campi delle opzioni di accessibilità:
| Campo | Descrizione |
|---|---|
wheelchairAccessibleParking |
Il luogo 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 un bagno accessibile in sedia a rotelle. |
wheelchairAccessibleSeating |
Il luogo dispone di tavoli accessibili in sedia a rotelle. |
Riepiloghi basati sull'AI
I riepiloghi basati sull'AI dell'API Places (nuova) utilizzano le funzionalità del modello Gemini per restituire riepiloghi di luoghi e aree che possono aiutare gli utenti a decidere dove andare.
I riepiloghi basati sull'AI sintetizzano i dati provenienti da una serie di input per aiutare gli utenti a prendere decisioni più informate su un luogo. Ad esempio, se stai pensando di provare un nuovo ristorante, un riepilogo basato sull'AI può mostrare i piatti più apprezzati del menu, darti un'idea dell'atmosfera o raggruppare i temi delle recensioni degli utenti. Se stai visitando una nuova città, un riepilogo basato sull'AI può fornirti una panoramica delle attrazioni e dei servizi nelle vicinanze.
Funzionalità basate sull'AI aggiunte all'API Places (novità)
I riepiloghi basati sull'AI sono supportati da Place Details (New), Ricerca testuale (New) e Nearby Search (New). Nelle risposte dell'API Places (nuova) sono disponibili i seguenti riepiloghi basati sull'AI:
- Riepiloghi dei luoghi, ovvero brevi riepiloghi relativi a un luogo specifico.
- Riepiloghi delle recensioni, che sono riepiloghi di facile lettura di ciò che i recensori hanno detto su un luogo.
- Riepiloghi delle aree, che forniscono panoramiche dei luoghi più popolari e nelle vicinanze nell'area circostante. Questi includono i riepiloghi dei quartieri e delle stazioni di ricarica EV.
Google rigenera spesso questi riepiloghi per assicurarsi che siano aggiornati in base alle informazioni più recenti disponibili. Quando effettui una richiesta all'API Places (nuova), nell'app vengono visualizzati i dati più aggiornati.
Esegui la migrazione all'API Places (novità)
Se sei un cliente esistente dell'API Places (legacy) e vuoi eseguire la migrazione della tua app per utilizzare l'API Places (novità), consulta la seguente documentazione sulla migrazione:
- Esegui la migrazione a Place Details (New)
- Esegui la migrazione a Nearby Search (New)
- Esegui la migrazione a Ricerca testuale (Nuovo)
- Esegui la migrazione a Foto dei luoghi (novità)
- Esegui la migrazione ad Autocomplete (New)