Una volta che disponi di un ID luogo, puoi richiedere ulteriori dettagli su una determinata struttura o un punto d'interesse avviando una richiesta Dettagli luogo (nuova). Una richiesta Place Details (nuova) restituisce informazioni più 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 (nuova) o Ricerca nelle vicinanze (nuova)
- API Geocoding
- API Routes
- API Address Validation
- Place Autocomplete
Explorer API ti consente di effettuare richieste in tempo reale per acquisire familiarità con l'API e le relative opzioni:
Prova!Richieste Place Details (nuove)
Una richiesta Place Details è una richiesta GET HTTP nel formato:
https://places.googleapis.com/v1/places/PLACE_ID
Passa tutti i parametri come parametri URL o nelle intestazioni come parte della richiesta GET. Ad esempio:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
Oppure in un comando cURL:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Risposte Place Details (nuove)
Place Details (New) restituisce un oggetto JSON come risposta. Nella risposta:
- La risposta è rappresentata da un oggetto
Place
. L'oggettoPlace
contiene informazioni dettagliate sul luogo. - La FieldMask passata nella richiesta specifica l'elenco dei campi restituiti nell'oggetto
Place
.
L'oggetto JSON completo ha il seguente formato:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
Parametri obbligatori
-
FieldMask
Specifica l'elenco dei campi da restituire nella risposta creando una maschera del campo di risposta. Trasmetti la maschera del campo di risposta al metodo utilizzando il parametro URL
$fields
ofields
oppure l'intestazione HTTPX-Goog-FieldMask
. La risposta non contiene un elenco predefinito dei campi restituiti. Se ometti la maschera di campo, il metodo restituisce un errore.Il mascheramento dei campi è una buona prassi di progettazione per evitare di richiedere dati non necessari, evitando così tempi di elaborazione e addebiti di fatturazione superflui.
Specifica un elenco separato da virgole dei tipi di dati dei luoghi da restituire. Ad esempio, per recuperare il nome visualizzato e l'indirizzo del luogo.
X-Goog-FieldMask: displayName,formattedAddress
Utilizza
*
per recuperare tutti i campi.X-Goog-FieldMask: *
Specifica uno o più dei seguenti campi:
I seguenti campi attivano lo SKU Place Details (solo ID):
attributions
,id
,name
*,photos
* Il camponame
contiene il nome della risorsa del luogo nel formato:places/PLACE_ID
. UtilizzadisplayName
per accedere al nome testuale del luogo.I seguenti campi attivano lo SKU Place Details (solo posizione):
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
I seguenti campi attivano lo SKU Place Details (di base):
accessibilityOptions
,businessStatus
,displayName
,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,subDestinations
eutcOffsetMinutes
I seguenti campi attivano lo SKU Place Details (Advanced):
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
ewebsiteUri
I seguenti campi attivano lo SKU Place Details (preferito):
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
,reviews
,servesBeer
,delivery
,delivery
,delivery
,delivery
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
-
placeId
Un identificatore testuale che identifica in modo univoco un luogo, restituito da una ricerca testuale (nuova) o ricerca nelle vicinanze (nuova). Per ulteriori informazioni sugli ID luogo, consulta la panoramica degli ID luogo.
La stringa
places/PLACE_ID
è denominata anche il nome risorsa del luogo. Nella risposta a una richiesta Place Details (Nuova), Nearby Search (Nuova) e Text Search (Nuova) ricerca, questa stringa è contenuta nel camponame
della risposta. L'ID luogo autonomo è contenuto nel campoid
della risposta.
Parametri facoltativi
languageCode
La lingua in cui restituire i risultati.
- Consulta l'elenco delle lingue supportate. Google aggiorna spesso le lingue supportate, pertanto questo elenco potrebbe non essere esaustivo.
-
Se
languageCode
non viene fornito, l'API predefinita saràen
. Se specifichi un codice lingua non valido, l'API restituisce un erroreINVALID_ARGUMENT
. - L'API fa del suo meglio per fornire un indirizzo che sia leggibile sia per l'utente sia per la gente del posto. Per raggiungere questo obiettivo, restituisce gli indirizzi nella lingua locale, traslitterati in uno script leggibile dall'utente se necessario, osservando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. I componenti degli indirizzi vengono restituiti nella stessa lingua, che viene scelta dal primo componente.
- Se un nome non è disponibile nella lingua preferita, l'API utilizza la corrispondenza più simile.
- La lingua preferita ha una piccola influenza sull'insieme di risultati che l'API sceglie di restituire e sull'ordine in cui vengono restituiti. Il geocodificatore interpreta le abbreviazioni in modo diverso a seconda della lingua, ad esempio le abbreviazioni dei tipi di strada o i sinonimi che possono essere validi in una lingua ma non in un'altra.
regionCode
Il codice regione utilizzato per formattare la risposta, specificato come valore di codice CLDR a due caratteri. Non esiste un valore predefinito.
Se il nome del paese del campo
formattedAddress
nella risposta corrisponde aregionCode
, il codice paese viene omesso daformattedAddress
. Questo parametro non ha effetto suadrFormatAddress
, che include sempre il nome del paese, oppure sushortFormattedAddress
, che non lo include mai.La maggior parte dei codici CLDR è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk" (.co.uk), mentre il codice ISO 3166-1 è"gb " (tecnicamente per l'entità "The United Kingdom of Gran Bretagna e Irlanda del Nord"). Il parametro può influire sui risultati in base alla legge vigente.
-
sessionToken
I token di sessione sono stringhe generate dall'utente che tracciano le chiamate di completamento automatico (nuove) come "sessioni". Autocomplete (Nuovo) utilizza i token di sessione per raggruppare le fasi di query e posizionare la selezione di una ricerca di completamento automatico di un utente in una sessione distinta ai fini della fatturazione. I token di sessione vengono passati nelle chiamate Place Details (Nuova) che seguono le chiamate Autocomplete (New). Per maggiori informazioni, consulta Token di sessione.
Esempio di Place Details
Nell'esempio seguente vengono richiesti i dettagli di un luogo per placeId
:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Tieni presente che l'intestazione X-Goog-FieldMask
specifica che la risposta contiene i seguenti campi di dati: id,displayName
.
La risposta avrà quindi il seguente formato:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
Aggiungi altri tipi di dati alla maschera del campo per restituire informazioni aggiuntive.
Ad esempio, aggiungi formattedAddress,plusCode
per includere l'indirizzo e il Plus Code nella risposta:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
La risposta è ora nel formato:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
Prova.
Explorer API consente di effettuare richieste di esempio, per acquisire familiarità con le opzioni API e API.
Per effettuare una richiesta:
- Seleziona l'icona dell'API sul lato destro della pagina.
- Se vuoi, puoi impostare il parametro
name
su:places/PLACE_ID
- Se vuoi, espandi Mostra parametri standard e imposta il parametro
fields
sulla maschera del campo. - Seleziona il pulsante Esegui. Nel popup, scegli l'account che vuoi utilizzare per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona Espandi, , per espandere la finestra di Explorer API.