L'API Places (nuova) include le seguenti API:
- Dettagli del luogo (novità)
- Foto del luogo (novità)
- Ricerca nelle vicinanze (novità)
- Ricerca testuale (novità)
- Completamento automatico (novità)
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 Google Maps. Con un ID luogo, puoi richiedere dettagli su un particolare attività o punto d'interesse avviando una Dettagli luogo (nuova) richiesta. Una richiesta Place Details (nuova) restituisce informazioni complete su il luogo indicato, ad esempio indirizzo completo, numero di telefono, 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
Foto del luogo (novità)
L'API Place Photo (New) ti consente di aggiungere contenuti fotografici di alta qualità. alla tua applicazione dandoti accesso ai milioni di foto archiviate nell' Database di Google Places. Tramite l'API Place Photo (novità), puoi accedere foto e ridimensionarle alle dimensioni ottimali per la tua applicazione.
Tutte le richieste all'API Place Photo (nuova) devono includere un nome risorsa per le foto. che identifica in modo univoco la foto da restituire. Puoi ottenere la risorsa foto nome utilizzando:
Per includere il nome della risorsa di foto nella risposta di un evento Dettagli luogo (novità),
Ricerca testuale (nuova) o Ricerca nelle vicinanze (nuova), assicurati di includere
il campo photos
nella maschera del campo della richiesta.
Ricerca testuale (novità) e Ricerca nelle vicinanze (novità)
L'API Places 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 "Cucina di pesce raffinata vicino Palo Alto, California".
Puoi perfezionare la ricerca specificando dettagli quali livelli di prezzo, stato di apertura attuale, valutazioni o tipi di luoghi specifici. Puoi anche specificare se differenziare i risultati in base a una località specifica o limitare la ricerca in 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 sotto forma di cerchio definito da latitudine e longitudine coordinate del centro e del raggio in metri.
Specifica uno o più tipi di luogo che definiscono le caratteristiche del posto. Ad esempio, specifica "
pizza_restaurant
" e "shopping_mall
" a cerca una pizzeria situata in un centro commerciale nella regione.
La differenza principale tra le due ricerche è che la Ricerca testuale (nuova) ti consente specificare una stringa di ricerca arbitraria, mentre Ricerca nelle vicinanze (nuova) richiede una specifica in cui effettuare la ricerca.
Completamento automatico (nuovo) e token di sessione
Completamento automatico (novità) è un servizio web che restituisce previsioni sui luoghi e per le query in risposta a una richiesta HTTP. Nella richiesta, specifica un testo stringa di ricerca e confini geografici che controllano l'area di ricerca.
I token di sessione sono stringhe generate dall'utente che tengono traccia delle chiamate di completamento automatico (nuove) come sessioni. Il completamento automatico (novità) utilizza i token di sessione per raggruppare la query fasi di selezione della ricerca di completamento automatico di un utente in una sessione discreta 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. Secondarie orari di apertura sono diversi da quelli principali dell'attività. Per Ad esempio, un ristorante può specificare l'orario di drive-through o la consegna ore come ore secondarie. |
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,
l'impostazione del campo delle opzioni di pagamento. Sono incluse le seguenti opzioni:
|
parkingOptions |
Opzioni di parcheggio offerte dal luogo. Sono incluse le seguenti opzioni:
|
subDestinations |
Luoghi unici correlati a un luogo specifico. Per Ad esempio, i terminal aeroportuali sono considerati destinazioni secondarie di un aeroporto. |
fuelOptions |
Le informazioni più recenti sulle opzioni di carburante disponibili a
stazione di servizio. Queste informazioni vengono aggiornate regolarmente. Le opzioni includono
quanto segue:
|
evChargeOptions |
Numero di stazioni di ricarica di veicoli elettrici (EV) in questa stazione. Mentre alcuni caricabatterie EV hanno più connettori, ogni caricabatterie può ricaricare un veicolo alla volta; di conseguenza, questo campo riflette di stazioni di ricarica EV disponibili in un dato 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 . R
può avere un solo tipo principale. Per l'elenco completo
i valori possibili, consulta la sezione Tipi supportati. |
primaryTypeDisplayName |
Il nome visualizzato del tipo principale, localizzato nella richiesta lingua, 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 a utilizzare le nuove API, consulta la seguente documentazione sulla migrazione: