La nuova API Places include le seguenti API:
Questo documento contiene una panoramica di queste nuove API.
API Place Details
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 stabilimento o punto d'interesse avviando una richiesta Dettagli luogo (nuovo). Una richiesta Dettagli luogo (Nuovo) 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à)
- Ricerca nelle vicinanze (novità)
- API Geocoding
- API Routes
- API Address Validation
- Place Autocomplete
API Place Photo
L'API Place Photo (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. Con l'API Place Photo (New) puoi accedere alle foto e ridimensionarle in base alle dimensioni ottimali per l'applicazione.
Tutte le richieste all'API Place Photo (New) devono includere un nome di risorsa foto che identifichi 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 testuale (Nuova) o Ricerca nelle vicinanze (Nuova), assicurati di includere il campo photos nella maschera del campo della richiesta.
Ricerca testuale e Ricerca nelle vicinanze
L'API Places include due API di ricerca:
-
Consente di specificare una stringa di testo in cui cercare un luogo. Ad esempio: "Cibo vegetariano piccante a Sydney, Australia" o "Cena di pesce raffinata vicino a Palo Alto, CA".
Puoi perfezionare la ricerca specificando dettagli come livelli di prezzo, stato di apertura attuale, valutazioni o tipi specifici di luoghi. Puoi anche specificare di escludere i risultati per una località specifica o limitare la ricerca a una località specifica.
Ricerca nelle vicinanze (novità)
Ti consente di specificare una regione da cercare e un elenco di tipi di luoghi. 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 ne definiscono le caratteristiche. Ad esempio, specifica "
pizza_restaurant" e "shopping_mall" per cercare una pizzeria situata in un centro commerciale nell'area geografica 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.
API di completamento automatico e token sessione
L'API 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 controlli l'area di ricerca.
I token di sessione sono stringhe generate dall'utente che monitorano le chiamate di completamento automatico (nuovo) come sessioni. Il completamento automatico (nuova) utilizza i token di sessione per raggruppare le fasi di query e selezione della ricerca con completamento automatico di un utente in una sessione discreta ai fini della fatturazione.
Nuovi campi, attributi e opzioni di accessibilità
L'API Places (Nuovo) 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 i momenti particolari per determinate operazioni. Gli orari di apertura secondari sono diversi da quelli principali dell'attività. Ad esempio, un ristorante può specificare come orario secondario l'orario drive-through o l'orario di consegna per la consegna. |
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. Le opzioni sono le seguenti:
|
parkingOptions |
Opzioni di parcheggio offerte dal luogo. Le opzioni sono le seguenti:
|
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. Le opzioni sono le seguenti:
|
evChargeOptions |
Numero di stazioni di ricarica per veicoli elettrici (EV) in questa stazione. Sebbene alcuni caricabatterie EV dispongano di più connettori, ciascuno di questi può ricaricare un solo veicolo alla volta. Di conseguenza, in questo campo viene indicato il numero di caricabatterie 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 possibili valori, vedi Tipi supportati. |
primaryTypeDisplayName |
Il nome visualizzato del tipo principale, localizzato nella lingua della richiesta, se applicabile. Per l'elenco completo dei possibili valori, consulta la sezione Tipi supportati. |
Attributi
L'API Places (Novità) include diversi nuovi attributi:
| Attributo | Descrizione |
|---|---|
outdoorSeating |
Questo locale dispone di tavoli all'aperto. |
liveMusic |
Questo luogo offre musica dal vivo. |
menuForChildren |
Locale con menu per bambini. |
servesCocktails |
Locale che serve cocktail. |
servesDessert |
Locale che serve dessert. |
servesCoffee |
Questo posto serve caffè. |
goodForChildren |
Luogo adatto ai bambini. |
allowsDogs |
In questo luogo sono ammessi i cani. |
restroom |
Questa struttura dispone di servizi igienici. |
goodForGroups |
Questo luogo può ospitare gruppi. |
goodForWatchingSports |
Luogo adatto per guardare sport. |
Opzioni di accessibilità
L'API Places (nuova) include i seguenti campi di opzioni di accessibilità:
| Campo | Descrizione |
|---|---|
wheelchairAccessibleParking |
Questo luogo offre un parcheggio accessibile in sedia a rotelle. |
wheelchairAccessibleEntrance |
Questa struttura dispone di ingresso accessibile in sedia a rotelle. |
wheelchairAccessibleRestroom |
Questa struttura dispone di servizi igienici accessibili in sedia a rotelle. |
wheelchairAccessibleSeating |
Questo locale 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: