Una volta ottenuto un place_id da una ricerca di luoghi, puoi
richiedere maggiori dettagli su una determinata attività o
punto d'interesse avviando una richiesta di Place Details (legacy). Una richiesta Place Details (legacy)
restituisce informazioni più complete sul luogo indicato,
come indirizzo completo, numero di telefono, valutazione degli utenti e recensioni.
Richieste Places Details (legacy)
Una richiesta Place Details (legacy) è un URL HTTP del seguente formato:
https://maps.googleapis.com/maps/api/place/details/output?parameters
dove output può avere uno dei seguenti valori:
json(consigliato) indica l'output in JavaScript Object Notation (JSON)xmlindica l'output in formato XML
Per avviare una richiesta di ricerca sono necessari determinati parametri. Come
standard negli URL, tutti i parametri sono separati utilizzando il carattere
e commerciale (&). Di seguito è riportato un elenco dei parametri e dei relativi
valori possibili.
Parametri obbligatori
-
place_id
Un identificatore testuale che identifica in modo univoco un luogo, restituito da una ricerca di luoghi. Per saperne di più sugli ID luogo, consulta la panoramica degli ID luogo.
Parametri facoltativi
-
i campi
Attenzione: le richieste Place Search e Place Details non restituiscono gli stessi campi. Le richieste di ricerca di luoghi restituiscono un sottoinsieme dei campi restituiti dalle richieste Place Details. Se il campo che ti interessa non viene restituito dalla ricerca di luoghi, puoi utilizzare la ricerca di luoghi per ottenere unplace_id, quindi utilizzare questo ID luogo per effettuare una richiesta Place Details. Per ulteriori informazioni sui campi non disponibili in una richiesta di ricerca di luoghi, consulta Supporto dei campi dell'API Places.Utilizza il parametro fields per specificare un elenco separato da virgole di tipi di dati dei luoghi da restituire. Ad esempio:
fields=formatted_address,name,geometry. Utilizza una barra quando specifichi valori composti. Ad esempio:opening_hours/open_now.I campi sono suddivisi in tre categorie di fatturazione: Basic, Contact e Atmosphere. Gli SKU Basic, Contact e Atmosphere vengono addebitati in aggiunta allo SKU di base (Place Details, Trova luogo, Nearby Search o Ricerca testuale) per la richiesta che li ha attivati. Per ulteriori informazioni, consulta il listino prezzi.
Basic
La categoria Base include i seguenti campi:
address_components,adr_address,business_status,formatted_address,geometry,icon,icon_mask_base_uri,icon_background_color,name,permanently_closed(ritirato),photo,place_id,plus_code,type,url,utc_offset,vicinity,wheelchair_accessible_entrance.Contatto
La categoria Contatto include i seguenti campi:
current_opening_hours,formatted_phone_number,international_phone_number,opening_hours,secondary_opening_hours,websiteAtmosfera
La categoria Atmosfera include i seguenti campi:
curbside_pickup,delivery,dine_in,editorial_summary,price_level,rating,reservable,reviews,serves_beer,serves_breakfast,serves_brunch,serves_dinner,serves_lunch,serves_vegetarian_food,serves_wine,takeout,user_ratings_total.Nota:le attribuzioni,html_attributions, vengono sempre restituite a ogni chiamata, indipendentemente dal fatto che il campo sia stato richiesto. -
language
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
languagenon viene fornito, l'API tenta di utilizzare la lingua preferita specificata nell'intestazioneAccept-Language. - L'API fa del suo meglio per fornire un indirizzo stradale leggibile sia per l'utente sia per gli abitanti del luogo. Per raggiungere questo obiettivo, restituisce gli indirizzi stradali nella lingua locale, traslitterati in un sistema di scrittura leggibile dall'utente, se necessario, rispettando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. Tutti i componenti dell'indirizzo vengono restituiti nella stessa lingua, scelta dal primo componente.
- Se un nome non è disponibile nella lingua preferita, l'API utilizza la corrispondenza più vicina.
- 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 per i tipi di strade o i sinonimi che potrebbero essere validi in una lingua ma non in un'altra. Ad esempio, utca e tér sono sinonimi di strada in ungherese.
-
regione
Il codice regione, specificato come valore di due caratteri ccTLD ("top-level domain"). La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD specifico per paese del Regno Unito è "uk" (.co.uk), mentre il suo codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord").
-
reviews_no_translations
Specifica
reviews_no_translations=trueper disattivare la traduzione delle recensioni; specificareviews_no_translations=falseper attivare la traduzione delle recensioni. Le recensioni vengono restituite nella lingua originale.Se omessa o trasmessa senza valore, la traduzione delle recensioni è attivata. Se nella richiesta è stato specificato il parametro
language, utilizza la lingua specificata come lingua preferita per la traduzione. Selanguageviene omesso, l'API tenta di utilizzare l'intestazioneAccept-Languagecome lingua preferita. -
reviews_sort
Il metodo di ordinamento da utilizzare per restituire le recensioni. Può essere impostato su
most_relevant(impostazione predefinita) onewest.-
Per
most_relevant(impostazione predefinita), le recensioni vengono ordinate in base alla pertinenza; il servizio privilegia i risultati per restituire recensioni scritte originariamente nella lingua preferita. -
Per
newest, le recensioni sono ordinate in ordine cronologico; la lingua preferita non influisce sull'ordine di ordinamento.
Google consiglia di mostrare all'utente finale come vengono ordinate le recensioni.
-
Per
-
sessiontoken
Una stringa casuale che identifica una sessione di completamento automatico ai fini della fatturazione.
La sessione inizia quando l'utente inizia a digitare una query e termina quando seleziona un luogo e viene effettuata una chiamata a Place Details. Ogni sessione può avere più query, seguite dalla selezione di un luogo. Le chiavi API utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto Google Cloud Console. Una volta terminata una sessione, il token non è più valido; la tua app deve generare un nuovo token per ogni sessione. Se il parametro
sessiontokenviene omesso o se riutilizzi un token di sessione, la sessione viene addebitata come se non fosse stato fornito alcun token di sessione (ogni richiesta viene fatturata separatamente).Ti consigliamo di seguire le seguenti linee guida:
- Utilizza i token di sessione per tutte le sessioni Autocomplete.
- Genera un nuovo token per ogni sessione. Si consiglia l'uso di UUID versione 4.
- Assicurati che le chiavi API utilizzate per tutte le richieste Place Autocomplete e Place Details all'interno di una sessione appartengano allo stesso progetto Cloud Console.
- Assicurati di trasmettere un token di sessione univoco per ogni nuova sessione. L'utilizzo dello stesso token per più sessioni comporterà l'addebito individuale di ogni richiesta.
Esempio di Place Details (legacy)
L'esempio seguente richiede i dettagli di un luogo in base a
place_id e include i campi name, rating
e formatted_phone_number:
Conchiglia
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'
HTTP
https://maps.googleapis.com/maps/api/place/details/json ?fields=name%2Crating%2Cformatted_phone_number &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4 &key=YOUR_API_KEY
Tieni presente che per far funzionare la richiesta nella tua applicazione, devi sostituire la chiave in questo esempio con la tua chiave API.
Risposta Place Details (legacy)
Le risposte a Place Details (legacy) vengono restituite nel formato indicato dal
flag output all'interno del percorso URL della richiesta.
JSON
{ "html_attributions": [], "result": { "address_components": [ { "long_name": "48", "short_name": "48", "types": ["street_number"] }, { "long_name": "Pirrama Road", "short_name": "Pirrama Rd", "types": ["route"], }, { "long_name": "Pyrmont", "short_name": "Pyrmont", "types": ["locality", "political"], }, { "long_name": "City of Sydney", "short_name": "City of Sydney", "types": ["administrative_area_level_2", "political"], }, { "long_name": "New South Wales", "short_name": "NSW", "types": ["administrative_area_level_1", "political"], }, { "long_name": "Australia", "short_name": "AU", "types": ["country", "political"], }, { "long_name": "2009", "short_name": "2009", "types": ["postal_code"], }, ], "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "business_status": "OPERATIONAL", "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "formatted_phone_number": "(02) 9374 4000", "geometry": { "location": { "lat": -33.866489, "lng": 151.1958561 }, "viewport": { "northeast": { "lat": -33.8655112697085, "lng": 151.1971156302915 }, "southwest": { "lat": -33.86820923029149, "lng": 151.1944176697085 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "international_phone_number": "+61 2 9374 4000", "name": "Google Workplace 6", "opening_hours": { "open_now": false, "periods": [ { "close": { "day": 1, "time": "1700" }, "open": { "day": 1, "time": "0900" }, }, { "close": { "day": 2, "time": "1700" }, "open": { "day": 2, "time": "0900" }, }, { "close": { "day": 3, "time": "1700" }, "open": { "day": 3, "time": "0900" }, }, { "close": { "day": 4, "time": "1700" }, "open": { "day": 4, "time": "0900" }, }, { "close": { "day": 5, "time": "1700" }, "open": { "day": 5, "time": "0900" }, }, ], "weekday_text": [ "Monday: 9:00 AM – 5:00 PM", "Tuesday: 9:00 AM – 5:00 PM", "Wednesday: 9:00 AM – 5:00 PM", "Thursday: 9:00 AM – 5:00 PM", "Friday: 9:00 AM – 5:00 PM", "Saturday: Closed", "Sunday: Closed", ], }, "photos": [ { "height": 3024, "html_attributions": [ "Cynthia Wei", ], "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX", "width": 4032, }, { "height": 3264, "html_attributions": [ "Heyang Li", ], "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI", "width": 4912, }, { "height": 3036, "html_attributions": [ "Anna Linetsky", ], "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1", "width": 4048, }, { "height": 4016, "html_attributions": [ "Jonah Dell", ], "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD", "width": 6016, }, { "height": 3024, "html_attributions": [ "Anthony Huynh", ], "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9", "width": 4032, }, { "height": 3024, "html_attributions": [ "Jasen Baker", ], "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x", "width": 4032, }, { "height": 3024, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk", "width": 4032, }, { "height": 1515, "html_attributions": [ "Andrew W", ], "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI", "width": 2048, }, { "height": 3024, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39", "width": 4032, }, { "height": 4032, "html_attributions": [ "Jeremy Hsiao", ], "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas", "width": 3024, }, ], "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "plus_code": { "compound_code": "45MW+C8 Pyrmont NSW, Australia", "global_code": "4RRH45MW+C8", }, "rating": 4, "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4", "reviews": [ { "author_name": "Luke Archibald", "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "a week ago", "text": "Beautiful building with a great view.", "time": 1652286798, }, { "author_name": "Tevita Taufoou", "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "6 months ago", "text": "Conference rooms were well equipped.", "time": 1637215605, }, { "author_name": "Jordy Baker", "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "The staff is very friendly.", "time": 1641389490, }, { "author_name": "Prem Rathod", "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "4 months ago", "text": "The location is convenient and easy to find.", "time": 1640159655, }, { "author_name": "Husuni Hamza", "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo", "rating": 5, "relative_time_description": "7 months ago", "text": "A modern and impressive facility.", "time": 1633197305, }, ], "types": ["point_of_interest", "establishment"], "url": "https://maps.google.com/?cid=10281119596374313554", "user_ratings_total": 939, "utc_offset": 600, "vicinity": "48 Pirrama Road, Pyrmont", "website": "http://google.com/", }, "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceDetailsResponse> <status>OK</status> <result> <name>Google Workplace 6</name> <vicinity>48 Pirrama Road, Pyrmont</vicinity> <type>point_of_interest</type> <type>establishment</type> <formatted_phone_number>(02) 9374 4000</formatted_phone_number> <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address> <address_component> <long_name>48</long_name> <short_name>48</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Pirrama Road</long_name> <short_name>Pirrama Rd</short_name> <type>route</type> </address_component> <address_component> <long_name>Pyrmont</long_name> <short_name>Pyrmont</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>City of Sydney</long_name> <short_name>City of Sydney</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>New South Wales</long_name> <short_name>NSW</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>Australia</long_name> <short_name>AU</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>2009</long_name> <short_name>2009</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>-33.8664890</lat> <lng>151.1958561</lng> </location> <viewport> <southwest> <lat>-33.8682092</lat> <lng>151.1944177</lng> </southwest> <northeast> <lat>-33.8655113</lat> <lng>151.1971156</lng> </northeast> </viewport> </geometry> <rating>4.0</rating> <url>https://maps.google.com/?cid=10281119596374313554</url> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference> <international_phone_number>+61 2 9374 4000</international_phone_number> <website>http://google.com/</website> <review> <time>1652286798</time> <text>Beautiful building with a great view.</text> <author_name>Luke Archibald</author_name> <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>a week ago</relative_time_description> </review> <review> <time>1637215605</time> <text>Conference rooms were well equipped.</text> <author_name>Joe Schmoe</author_name> <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>6 months ago</relative_time_description> </review> <review> <time>1641389490</time> <text>The staff is very friendly.</text> <author_name>Jordy Baker</author_name> <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1640159655</time> <text>The location is convenient and easy to find.</text> <author_name>Prem Rathod</author_name> <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>4 months ago</relative_time_description> </review> <review> <time>1633197305</time> <text>A modern and impressive facility.</text> <author_name>Husuni Hamza</author_name> <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url> <rating>5.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>7 months ago</relative_time_description> </review> <opening_hours> <open_now>false</open_now> <period> <open> <day>1</day> <time>0900</time> </open> <close> <day>1</day> <time>1700</time> </close> </period> <period> <open> <day>2</day> <time>0900</time> </open> <close> <day>2</day> <time>1700</time> </close> </period> <period> <open> <day>3</day> <time>0900</time> </open> <close> <day>3</day> <time>1700</time> </close> </period> <period> <open> <day>4</day> <time>0900</time> </open> <close> <day>4</day> <time>1700</time> </close> </period> <period> <open> <day>5</day> <time>0900</time> </open> <close> <day>5</day> <time>1700</time> </close> </period> <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Saturday: Closed</weekday_text> <weekday_text>Sunday: Closed</weekday_text> </opening_hours> <utc_offset>600</utc_offset> <photo> <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference> <width>4912</width> <height>3264</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference> <width>4048</width> <height>3036</height> <html_attribution><a href="https://maps.google.com/maps/contrib/104829437842034782235">Anna Linetsky</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference> <width>6016</width> <height>4016</height> <html_attribution><a href="https://maps.google.com/maps/contrib/107755640736541028674">Jonah Dell</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/115886271727815775491">Anthony Huynh</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102939237947063969663">Jasen Baker</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference> <width>2048</width> <height>1515</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112343109286948028063">Andrew W</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference> <width>3024</width> <height>4032</height> <html_attribution><a href="https://maps.google.com/maps/contrib/100678816592586275978">Jeremy Hsiao</a></html_attribution> </photo> <adr_address><span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span></adr_address> <user_ratings_total>939</user_ratings_total> <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id> <plus_code> <global_code>4RRH45MW+C8</global_code> <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> </PlaceDetailsResponse>
Le risposte JSON e XML contengono i seguenti elementi:
PlacesDetailsResponse
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
obbligatorio | Array<stringa> |
Potrebbe contenere un insieme di attribuzioni relative a questa scheda che devono essere mostrate all'utente (alcune schede potrebbero non avere attribuzione). |
|
obbligatorio | Luogo |
Contiene le informazioni dettagliate sul luogo richiesto. Per saperne di più, consulta Luogo. |
|
obbligatorio | PlacesDetailsStatus |
Contiene lo stato della richiesta e può contenere informazioni di debug per aiutarti a capire perché la richiesta non è andata a buon fine. Per ulteriori informazioni, consulta PlacesDetailsStatus. |
|
facoltativo | Array<stringa> |
Quando il servizio restituisce ulteriori informazioni sulla specifica della richiesta, potrebbe essere presente un campo |
In una risposta JSON, questi sono rappresentati come elementi radice. In una risposta XML, questi elementi vengono visualizzati come elementi di primo livello sotto <PlaceDetailsResponse>.
PlacesDetailsStatus
Codici di stato restituiti dal servizio.
OKche indica che la richiesta API è andata a buon fine.-
ZERO_RESULTSche indica che la località a cui viene fatto riferimento,place_id, era valida, ma non fa più riferimento a un risultato valido. Ciò può verificarsi se l'attività non è più operativa. -
NOT_FOUNDche indica che la località a cui viene fatto riferimento,place_id, non è stata trovata nel database Places. -
INVALID_REQUESTche indica che la richiesta API non è corretta. -
OVER_QUERY_LIMITche indica uno dei seguenti elementi:- Hai superato i limiti di QPS.
- La fatturazione non è stata abilitata sul tuo account.
- Il credito mensile di 200 $o un limite di utilizzo autoimposto è stato superato.
- Il metodo di pagamento fornito non è più valido (ad esempio, una carta di credito è scaduta).
-
REQUEST_DENIEDche indica che la tua richiesta è stata rifiutata, in genere perché:- La richiesta non include una chiave API.
- Il parametro
keynon è valido.
UNKNOWN_ERRORche indica un errore sconosciuto.
Luogo
Attributi che descrivono un luogo. Non tutti gli attributi saranno disponibili per tutti i tipi di luoghi.
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
facoltativo |
Array<AddressComponent>
|
Un array contenente i componenti separati applicabili a questo indirizzo.
Per saperne di più, consulta |
|
facoltativo | stringa |
Una rappresentazione dell'indirizzo del luogo nel microformato adr. |
|
facoltativo | stringa |
Indica lo stato operativo del luogo, se si tratta di un'attività.
Se non esistono dati,
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
facoltativo | booleano |
Specifica se l'attività supporta il ritiro all'esterno. |
|
facoltativo | PlaceOpeningHours |
Contiene l'orario di apertura per i prossimi sette giorni (incluso
oggi). Il periodo di tempo inizia a mezzanotte della data della
richiesta e termina alle 23:59 sei giorni dopo. Questo campo include il
campo secondario Per saperne di più, consulta PlaceOpeningHours. |
|
facoltativo | booleano |
Specifica se l'attività supporta la consegna. |
|
facoltativo | booleano |
Specifica se l'attività supporta opzioni di posti a sedere al chiuso o all'aperto. |
|
facoltativo | PlaceEditorialSummary |
Contiene un riepilogo del luogo. Un riepilogo è composto da una panoramica testuale e include anche il codice della lingua, se applicabile. Il testo del riepilogo deve essere presentato così com'è e non può essere modificato o alterato. Per saperne di più, consulta PlaceEditorialSummary. |
|
facoltativo | stringa |
Una stringa contenente l'indirizzo leggibile di questo luogo. Spesso questo indirizzo corrisponde all'indirizzo postale. Tieni presente che alcuni paesi, come il Regno Unito, non consentono la distribuzione di indirizzi postali reali a causa di limitazioni di licenza. L'indirizzo formattato è composto logicamente da uno o più componenti dell'indirizzo. Ad esempio, l'indirizzo "111 8th Avenue, New York, NY" è composto dai seguenti componenti: "111" (il numero civico), "8th Avenue" (la strada), "New York" (la città) e "NY" (lo stato degli Stati Uniti). Non analizzare l'indirizzo formattato in modo programmatico. Devi invece utilizzare i singoli componenti dell'indirizzo, che la risposta dell'API include oltre al campo dell'indirizzo formattato. |
|
facoltativo | stringa |
Contiene il numero di telefono del luogo nel suo formato locale. |
|
facoltativo | Geometry |
Contiene la posizione e l'area visibile per la posizione. Consulta |
|
facoltativo | stringa |
Contiene l'URL di un'icona suggerita che potrebbe essere visualizzata all'utente quando indica questo risultato su una mappa. |
|
facoltativo | stringa |
Contiene il codice colore esadecimale predefinito per la categoria del luogo. |
|
facoltativo | stringa |
Contiene l'URL di un'icona consigliata, senza l'estensione del tipo di file |
|
facoltativo | stringa |
Contiene il numero di telefono del luogo in formato internazionale.
Il formato internazionale include il codice paese ed è preceduto dal segno più (+). Ad esempio, international_phone_number per
l'ufficio di Google a Sydney, in Australia, è |
|
facoltativo | stringa |
Contiene il nome leggibile del risultato restituito. Per i risultati
|
|
facoltativo | PlaceOpeningHours |
Contiene l'orario di apertura normale. Per saperne di più, consulta PlaceOpeningHours. |
|
facoltativo | booleano |
Utilizza |
|
facoltativo | Array<PlacePhoto> |
Un array di oggetti foto, ognuno contenente un riferimento a un'immagine. Una richiesta può restituire fino a dieci foto. Per ulteriori informazioni sulle foto dei luoghi e su come utilizzare le immagini nella tua applicazione, consulta la documentazione relativa a Foto del luogo. Per maggiori informazioni, consulta PlacePhoto. |
|
facoltativo | stringa |
Un identificatore testuale che identifica in modo univoco un luogo. Per recuperare
informazioni sul luogo, passa questo identificatore nel
campo |
|
facoltativo | PlusCode |
Un riferimento di posizione codificato, derivato dalle coordinate di latitudine e longitudine, che rappresenta un'area: 1/8000 di grado per 1/8000 di grado (circa 14 m x 14 m all'equatore) o più piccola. I Plus Code possono essere utilizzati in sostituzione degli indirizzi stradali in luoghi in cui non esistono (dove gli edifici non sono numerati o le strade non hanno un nome). Consulta Open Location Code e plus code. Consulta |
|
facoltativo | numero |
Il livello di prezzo del luogo, su una scala da 0 a 4. L'importo esatto indicato da un valore specifico varia da regione a regione. I livelli di prezzo vengono interpretati come segue:
|
|
facoltativo | numero |
Contiene la valutazione del luogo, da 1,0 a 5,0, in base alle recensioni aggregate degli utenti. |
|
facoltativo | stringa | |
|
facoltativo | booleano |
Specifica se il luogo supporta le prenotazioni. |
|
facoltativo | Array<PlaceReview> |
Un array JSON di massimo cinque recensioni. Per impostazione predefinita, le recensioni sono
ordinate in base alla pertinenza. Utilizza il
parametro di richiesta
Google consiglia di indicare agli utenti se i risultati sono ordinati per
Per ulteriori informazioni, consulta PlaceReview. |
|
facoltativo | stringa | |
|
facoltativo | Array<PlaceOpeningHours> |
Contiene un array di voci per i sette giorni successivi, incluse
informazioni sull'orario secondario di un'attività. Gli orari secondari sono
diversi da quelli principali di un'attività. Ad esempio, un ristorante
può specificare gli orari del servizio drive-through o della consegna a domicilio come orari
secondari. Questo campo compila il sottocampo Per saperne di più, consulta PlaceOpeningHours. |
|
facoltativo | booleano |
Specifica se il luogo serve birra. |
|
facoltativo | booleano |
Specifica se il luogo serve la colazione. |
|
facoltativo | booleano |
Specifica se il luogo serve il brunch. |
|
facoltativo | booleano |
Specifica se il luogo serve la cena. |
|
facoltativo | booleano |
Specifica se il luogo serve il pranzo. |
|
facoltativo | booleano |
Specifica se il luogo serve cibo vegetariano. |
|
facoltativo | booleano |
Specifica se il luogo serve vino. |
|
facoltativo | booleano |
Specifica se l'attività supporta il servizio d'asporto. |
|
facoltativo | Array<stringa> |
Contiene un array di tipi di funzionalità che descrivono il risultato specificato. Consulta l'elenco dei tipi supportati. |
|
facoltativo | stringa |
Contiene l'URL della pagina Google ufficiale di questo luogo. Questa sarà la pagina di proprietà di Google che contiene le migliori informazioni disponibili sul luogo. Le applicazioni devono collegarsi a questa pagina o incorporarla in qualsiasi schermata che mostri all'utente risultati dettagliati sul luogo. |
|
facoltativo | numero |
Il numero totale di recensioni, con o senza testo, per questo luogo. |
|
facoltativo | numero |
Contiene il numero di minuti di differenza tra il fuso orario attuale di questo luogo e il fuso orario UTC. Ad esempio, per i luoghi di Sydney, in Australia, durante l'ora legale, questo valore sarebbe 660 (+11 ore rispetto al fuso orario UTC), mentre per i luoghi della California al di fuori dell'ora legale sarebbe -480 (-8 ore rispetto al fuso orario UTC). |
|
facoltativo | stringa |
Per i risultati relativi agli stabilimenti (
Per tutti gli altri risultati, il campo Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato in modo programmatico. |
|
facoltativo | stringa |
Il sito web autorevole di questo luogo, ad esempio la home page di un'attività. |
|
facoltativo | booleano |
Specifica se il luogo dispone di un ingresso accessibile in sedia a rotelle. |
PlaceEditorialSummary
Contiene un riepilogo del luogo. Un riepilogo è composto da una panoramica testuale e include anche il codice lingua, se applicabile. Il testo del riepilogo deve essere presentato così com'è e non può essere modificato o alterato.
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
facoltativo | stringa |
La lingua dei campi precedenti. Potrebbe non essere sempre presente. |
|
facoltativo | stringa |
Un riepilogo testuale di media lunghezza del luogo. |
PlaceOpeningHours
Un oggetto che descrive gli orari di apertura di un luogo.
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
facoltativo | booleano |
Un valore booleano che indica se il luogo è aperto al momento. |
|
facoltativo | Array<PlaceOpeningHoursPeriod> |
Un array di periodi di apertura che coprono sette giorni, a partire da domenica, in ordine cronologico. Per saperne di più, consulta PlaceOpeningHoursPeriod. |
|
facoltativo | Array<PlaceSpecialDay> |
Un array di massimo sette voci corrispondenti ai prossimi sette giorni. Per ulteriori informazioni, consulta PlaceSpecialDay. |
|
facoltativo | stringa |
Una stringa di tipo utilizzata per identificare il tipo di orario secondario (ad esempio |
|
facoltativo | Array<stringa> |
Un array di stringhe che descrivono in testo leggibile gli orari del luogo. |
PlaceOpeningHoursPeriod
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
obbligatorio | PlaceOpeningHoursPeriodDetail |
Contiene una coppia di oggetti giorno e ora che descrivono quando il luogo apre. Per saperne di più, consulta PlaceOpeningHoursPeriodDetail. |
|
facoltativo | PlaceOpeningHoursPeriodDetail |
Può contenere una coppia di oggetti giorno e ora che descrivono l'orario di chiusura del luogo. Se un luogo è sempre aperto, la sezione di chiusura non sarà presente
nella risposta. I clienti possono fare affidamento sulla rappresentazione di sempre aperto
come periodo aperto contenente il giorno con valore Per saperne di più, consulta PlaceOpeningHoursPeriodDetail. |
PlaceSpecialDay
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
facoltativo | stringa |
Una data espressa nel formato RFC3339 nel fuso orario locale del luogo, ad esempio 2010-12-31. |
|
facoltativo | booleano |
True se sono previsti orari eccezionali per questo giorno. Se
|
PlaceOpeningHoursPeriodDetail
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
obbligatorio | numero |
Un numero compreso tra 0 e 6, corrispondente ai giorni della settimana, a partire da domenica. Ad esempio, 2 indica martedì. |
|
obbligatorio | stringa |
Può contenere un'ora del giorno nel formato hhmm a 24 ore. I valori sono compresi nell'intervallo 0000-2359. L'ora verrà indicata nel fuso orario del luogo. |
|
facoltativo | stringa |
Una data espressa nel formato RFC3339 nel fuso orario locale del luogo, ad esempio 2010-12-31. |
|
facoltativo | booleano |
Vero se un determinato periodo è stato troncato a causa di un limite di sette giorni, in cui il periodo inizia prima di mezzanotte della data della richiesta e/o termina a mezzanotte o dopo mezzanotte dell'ultimo giorno. Questa proprietà indica che il periodo di apertura o chiusura può estendersi oltre questo limite di sette giorni. |
PlacePhoto
Una foto di un luogo. È possibile accedere alla foto utilizzando l'API Place Photo utilizzando un URL nel seguente pattern:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
Per saperne di più, consulta Foto del luogo.
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
obbligatorio | numero |
L'altezza della foto. |
|
obbligatorio | Array<stringa> |
Le attribuzioni HTML per la foto. |
|
obbligatorio | stringa |
Una stringa utilizzata per identificare la foto quando esegui una richiesta di foto. |
|
obbligatorio | numero |
La larghezza della foto. |
PlaceReview
Una recensione del luogo inviata da un utente.
| Campo | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
|
obbligatorio | stringa |
Il nome dell'utente che ha inviato la recensione. Le recensioni anonime sono attribuite a "Un utente Google". |
|
obbligatorio | numero |
La valutazione complessiva dell'utente per questo luogo. Si tratta di un numero intero compreso tra 1 e 5. |
|
obbligatorio | stringa |
L'ora in cui è stata inviata la recensione in formato testo, rispetto all'ora attuale. |
|
obbligatorio | numero |
L'ora in cui è stata inviata la recensione, misurata in secondi dalla mezzanotte del 1° gennaio 1970 UTC. |
|
facoltativo | stringa |
L'URL del profilo Local Guides di Google Maps dell'utente, se disponibile. |
|
facoltativo | stringa |
Un codice lingua IETF che indica la lingua della recensione restituita.Questo campo contiene solo il tag della lingua principale e non il tag secondario che indica il paese o la regione. Ad esempio, tutte le recensioni in inglese sono taggate come "en" e non "en-AU" o "en-UK" e così via.Questo campo è vuoto se è presente solo una valutazione senza testo della recensione. |
|
facoltativo | stringa |
Un codice lingua IETF che indica la lingua originale della recensione. Se la recensione è stata tradotta, allora
|
|
facoltativo | stringa |
L'URL della foto del profilo dell'utente, se disponibile. |
|
facoltativo | stringa |
La recensione dell'utente. Quando esamini una località con Google Places,
le recensioni di testo sono considerate facoltative. Pertanto, questo campo potrebbe essere
vuoto. Tieni presente che questo campo potrebbe includere il markup HTML di base. Ad esempio, il riferimento all'entità |
|
facoltativo | booleano |
Un valore booleano che indica se la recensione è stata tradotta dalla lingua originale in cui è stata scritta.Se una recensione è stata tradotta, corrispondente a un valore true, Google consiglia di indicarlo agli utenti. Ad esempio, puoi aggiungere la seguente stringa "Tradotto da Google" alla recensione. |