Una volta ottenuto un ID luogo, puoi richiedere maggiori dettagli su una determinata struttura o punto d'interesse dando inizio a Dettagli del luogo (novità) richiesta. A Place Details (Novità) 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 (novità) o Ricerca nelle vicinanze (novità)
- API Geocoding
- API Routes
- API Address Validation
- Place Autocomplete
Explorer API ti consente di effettuare richieste in tempo reale per familiarizzare con l'API e Opzioni API:
Prova!Richieste Place Details (nuove)
Una richiesta Place Details è una richiesta GET HTTP nel formato:
https://places.googleapis.com/v1/places/PLACE_ID
Trasmettere tutti i parametri come parametri URL o nelle intestazioni come parte del tag 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 valore come risposta. Nella risposta:
- La risposta è rappresentata da un
Place
. L'oggettoPlace
contiene informazioni dettagliate sull'oggetto posto. - La FieldMask passata nella richiesta specifica l'elenco dei campi.
restituito 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 un maschera del campo di risposta. Passa la maschera del campo di risposta al metodo utilizzando il parametro URL
$fields
ofields
oppure tramite 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 pratica di progettazione per garantire di dati non necessari, così da evitare tempi di elaborazione non necessari addebiti di fatturazione.
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 luogo nome risorsa nel formato:places/PLACE_ID
. UsadisplayName
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
,utcOffsetMinutes
I seguenti campi attivano lo SKU Place Details (Advanced):
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
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
,servesBreakfast
,servesBrunch
,servesCocktails
,servesCoffee
,servesDessert
,servesDinner
,servesLunch
,servesVegetarianFood
,servesWine
,takeout
-
placeId
Un identificatore testuale che identifica in modo univoco un luogo, restituito da un Ricerca testuale (novità) o Ricerca nelle vicinanze (novità). Per ulteriori informazioni sugli ID luogo, consulta panoramica di Place ID.
La stringa
places/PLACE_ID
è chiamata anche il luogo nome risorsa. Nella risposta da un luogo Dettagli luogo (novità), Ricerca nelle vicinanze (novità) e Ricerca testuale (novità) questa stringa è contenuta nel camponame
della risposta. La versione autonoma L'ID luogo è contenuto nel campoid
della risposta.
Parametri facoltativi
languageCode
La lingua in cui restituire i risultati.
- Consulta le elenco delle lingue supportate. Google aggiorna spesso 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 una via facilmente leggibile sia l'utente che la gente del posto. Per raggiungere l'obiettivo, restituisce il codice nella lingua locale, traslitterati in uno script leggibile all'utente, se necessario, osservando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. I componenti dell'indirizzo tutti restituiti nella stessa lingua, che viene scelta tra la prima di strumento di authoring.
- Se un nome non è disponibile nella lingua preferita, l'API utilizza la classe la corrispondenza più simile.
- La lingua preferita ha una piccola influenza sull'insieme di risultati che che l'API sceglie di restituire e l'ordine in cui vengono restituiti. La il geocodificatore interpreta le abbreviazioni in modo diverso a seconda della lingua, come le abbreviazioni dei tipi di strada o i sinonimi che potrebbero validi in una lingua, ma non in un'altra.
regionCode
Il codice regione utilizzato per formattare la risposta, specificato come codice CLDR a due caratteri. Non esiste un valore predefinito.
Se il nome del paese nel campo
formattedAddress
nella risposta corrisponde alregionCode
, il codice paese è omesso daformattedAddress
. Questo parametro non ha effetto sul valoreadrFormatAddress
, che include sempre il paese oppure sushortFormattedAddress
, che non lo include mai.La maggior parte dei codici CLDR è identica ai codici ISO 3166-1, con alcune degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk" (.co.uk) mentre il codice ISO 3166-1 è "gb" (tecnicamente per persona giuridica del "Regno Unito di 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 monitorano il completamento automatico (Novità) chiamate come "sessioni". Il completamento automatico (novità) utilizza i token di sessione per Raggruppare le fasi di query e selezione del luogo di una ricerca con completamento automatico di un utente in una sessione discreta ai fini della fatturazione. I token di sessione vengono passati a Place Details (novità) che seguono le chiamate del completamento automatico (nuove). Per ulteriori informazioni, vedi Token di sessione.
Esempio di Place Details
Nell'esempio seguente vengono richiesti i dettagli di un luogo tramite
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
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 il parametro
e Plus Code nel
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 ti consente di effettuare richieste di esempio di acquisire familiarità con le opzioni dell'API e delle API.
Per effettuare una richiesta:
- Seleziona l'icona dell'API
. sul lato destro della pagina.
- (Facoltativo) Imposta il parametro
name
su:places/PLACE_ID
- Se vuoi, espandi Mostra parametri standard e imposta
il parametro
fields
alla maschera del campo. - Seleziona il pulsante Esegui. Nella finestra popup, scegli l'account da per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona Espandi,
, per espandere la finestra Explorer API.