Dettagli del luogo (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

Una volta ottenuto un place_id da una ricerca Place Search, puoi richiedere ulteriori dettagli su una determinata attività o un punto d'interesse avviando una richiesta Place Details (Legacy). Una richiesta Place Details (Legacy) restituisce informazioni più complete sul luogo indicato, come l'indirizzo completo, il numero di telefono, la valutazione degli utenti e le recensioni.

Richieste Place Details (Legacy)

Una richiesta Place Details (Legacy) è un URL HTTP nel seguente formato:

https://maps.googleapis.com/maps/api/place/details/output?parameters

dove output può essere uno dei seguenti valori:

  • json (consigliato) indica l'output in JavaScript Object Notation (JSON)
  • xml indica l'output in formato XML

Per avviare una richiesta di ricerca sono necessari alcuni parametri. Come è consuetudine negli URL, tutti i parametri sono separati utilizzando il carattere e commerciale (&). Le sezioni seguenti elencano i parametri e i relativi valori possibili.

Parametri obbligatori

Parametri facoltativi

  • i campi

    Attenzione:le richieste Place Search (Legacy) e Place Details (Legacy) non restituiscono gli stessi campi. Le richieste Place Search (Legacy) restituiscono un sottoinsieme dei campi restituiti dalle richieste Place Details (Legacy). Se il campo che ti interessa non viene restituito da Place Search (Legacy), puoi utilizzare Place Search (Legacy) per ottenere un place_id, quindi utilizzare questo ID luogo per effettuare una richiesta Place Details (Legacy). Per ulteriori informazioni sui campi non disponibili in una richiesta Place Search (Legacy), consulta Campi di dati dei luoghi (Legacy).

    Utilizza il parametro fields per specificare un elenco separato da virgole dei 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, Find Place, Nearby Search o Ricerca testuale) per la richiesta che li ha attivati. Per saperne di più, 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, website

    Atmosfera

    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 con 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 language non viene fornito, l'API tenta di utilizzare la lingua preferita specificata nell'intestazione Accept-Language.
    • L'API fa del suo meglio per fornire un indirizzo leggibile sia per l'utente sia per le persone del posto. Per raggiungere questo obiettivo, restituisce gli indirizzi nella lingua locale, traslitterati in un alfabeto leggibile dall'utente, se necessario, rispettando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. I componenti dell'indirizzo vengono restituiti tutti nella stessa lingua, che viene 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 ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD 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=true per disattivare la traduzione delle recensioni; specifica reviews_no_translations=false per attivare la traduzione delle recensioni. Le recensioni vengono restituite nella lingua originale.

    Se omesso o trasmesso senza valore, la traduzione delle recensioni è abilitata. Se nella richiesta è stato specificato il parametro language, utilizza la lingua specificata come lingua preferita per la traduzione. Se language viene omesso, l'API tenta di utilizzare l'intestazione Accept-Language come lingua preferita.

  • reviews_sort

    Il metodo di ordinamento da utilizzare per la restituzione delle recensioni. Può essere impostato su most_relevant (predefinito) o newest.

    • Per most_relevant (valore predefinito), le recensioni vengono ordinate in base alla pertinenza; il servizio darà la priorità ai risultati per restituire le recensioni scritte originariamente nella lingua preferita.
    • Per newest, le recensioni sono ordinate in ordine cronologico; la lingua preferita non influisce sull'ordinamento.

    Google consiglia di mostrare all'utente finale il modo in cui vengono ordinate le recensioni.

  • 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 (Legacy). 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 della console Google Cloud. Una volta conclusa una sessione, il token non è più valido; l'app deve generare un nuovo token per ogni sessione. Se il parametro sessiontoken viene 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 queste linee guida:

    • Utilizza i token di sessione per tutte le sessioni di completamento automatico.
    • 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 della console Cloud.
    • Assicurati di passare un token di sessione univoco per ogni nuova sessione. Se utilizzi lo stesso token per più di una sessione, ogni richiesta verrà fatturata singolarmente.

Esempio di Place Details (Legacy)

L'esempio seguente richiede i dettagli di un luogo tramite 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

Sostituisci la chiave in questo esempio con la tua chiave API in modo che la richiesta funzioni nella tua applicazione.

Risposta di Place Details (Legacy)

Le risposte di Place Details (Legacy) vengono restituite nel formato indicato dal flag output nel percorso dell'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,
          },
          // ...
        ],
      "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,
          },
          // ...
        ],
      "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>
  <!-- ... -->
  <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>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <!-- ... -->
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</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 ciascuna i seguenti elementi:

PlacesDetailsResponse

Campo Obbligatorio Tipo Descrizione
required Array<string>

Può contenere un insieme di attribuzioni relative a questa scheda che devono essere mostrate all'utente (alcune schede potrebbero non avere attribuzioni).

required Luogo

Contiene informazioni dettagliate sul luogo richiesto.

Per saperne di più, consulta Place.

required PlacesDetailsStatus

Contiene lo stato della richiesta e può contenere informazioni di debug per aiutarti a individuare il motivo per cui la richiesta non è andata a buon fine.

Per saperne di più, consulta PlacesDetailsStatus.

facoltativo Array<string>

Quando il servizio restituisce informazioni aggiuntive sulla specifica della richiesta, potrebbe essere presente un campo info_messages aggiuntivo all'interno dell'oggetto della risposta. Questo campo viene restituito solo per le richieste andate a buon fine. Potrebbe non essere sempre restituito e i suoi contenuti sono soggetti a modifiche.

In una risposta JSON, questi sono rappresentati come elementi root. In una risposta XML, questi vengono visualizzati come elementi di primo livello sotto <PlaceDetailsResponse>.

PlacesDetailsStatus

Codici di stato restituiti dal servizio.

  • OK, che indica che la richiesta API è andata a buon fine.
  • ZERO_RESULTS indica che la posizione di riferimento, place_id, era valida, ma non fa più riferimento a un risultato valido. Questo può accadere se l'attività non è più operativa.
  • NOT_FOUND indica che la località di riferimento, place_id, non è stata trovata nel database di Places.
  • INVALID_REQUEST che indica che la richiesta API non è corretta.
  • OVER_QUERY_LIMIT che indica uno dei seguenti elementi:
    • Hai superato i limiti di QPS.
    • La fatturazione non è stata abilitata sul tuo account.
    • È stato superato il credito mensile di 200 $o un limite di utilizzo autoimposto.
    • Il metodo di pagamento fornito non è più valido (ad esempio, una carta di credito è scaduta).
    Per saperne di più su come risolvere questo errore, consulta le Domande frequenti su Maps.
  • REQUEST_DENIED che indica che la tua richiesta è stata rifiutata, in genere perché:
    • La richiesta non contiene una chiave API.
    • Il parametro key non è valido.
  • UNKNOWN_ERROR che 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 singoli componenti applicabili a questo indirizzo.

Consulta AddressComponent per saperne di più.

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, business_status non viene restituito.

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 sette giorni successivi (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 sottocampo special_days di tutti gli orari, impostato per le date con orari eccezionali.

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 delle licenze.

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 della località.

Consulta Geometry per saperne di più.

facoltativo stringa

Contiene l'URL di un'icona suggerita che potrebbe essere mostrata 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 .svg o .png.

facoltativo stringa

Contiene il numero di telefono del luogo in formato internazionale. Il formato internazionale include il prefisso internazionale ed è preceduto dal segno più (+). Ad esempio, il valore di international_phone_number per l'ufficio di Google a Sydney, in Australia, è +61 2 9374 4000.

facoltativo stringa

Contiene il nome leggibile del risultato restituito. Per i risultati di establishment, in genere si tratta del nome dell'attività canonizzato.

facoltativo PlaceOpeningHours

Contiene l'orario di apertura standard.

Per saperne di più, consulta PlaceOpeningHours.

facoltativo booleano

Utilizza business_status per ottenere lo stato di attività delle attività.

facoltativo Array<PlacePhoto>

Un array di oggetti foto, ciascuno contenente un riferimento a un'immagine. Una richiesta può restituire fino a dieci foto. Per saperne di più sulle foto dei luoghi e su come utilizzare le immagini nella tua applicazione, consulta la documentazione relativa alle foto dei luoghi.

Per saperne di più, consulta PlacePhoto.

facoltativo stringa

Un identificatore testuale che identifica in modo univoco un luogo. Per recuperare informazioni sul luogo, passa questo identificatore nel campo place_id di una richiesta API Places. Per saperne di più sugli ID luogo, consulta la panoramica degli ID luogo.

facoltativo PlusCode

Un riferimento alla località 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 inferiore. I Plus Code possono essere utilizzati in sostituzione degli indirizzi nei 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 PlusCode per saperne di più.

facoltativo numero

Il livello di prezzo del luogo, su una scala da 0 a 4. L'importo esatto indicato da un valore specifico varia in base alla regione. I livelli di prezzo vengono interpretati come segue:

  • 0 Free
  • 1 Economico
  • 2 Moderato
  • 3 Costoso
  • 4 Molto costoso
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 un massimo di cinque recensioni. Per impostazione predefinita, le recensioni sono ordinate in base alla pertinenza. Utilizza il parametro di richiesta reviews_sort per controllare l'ordinamento.

  • Per most_relevant (valore predefinito), le recensioni vengono ordinate per pertinenza; il servizio darà la priorità ai risultati per restituire le recensioni scritte originariamente nella lingua preferita.
  • Per newest, le recensioni sono ordinate in ordine cronologico; la lingua preferita non influisce sull'ordinamento.

Google consiglia di indicare agli utenti se i risultati sono ordinati in base a most_relevant o newest.

Per ulteriori informazioni, consulta PlaceReview.

facoltativo stringa
facoltativo Array<PlaceOpeningHours>

Contiene un array di voci per i sette giorni successivi, incluse informazioni sugli orari secondari di un'attività. Gli orari secondari sono diversi dagli orari principali di un'attività. Ad esempio, un ristorante può specificare gli orari del servizio drive-through o di consegna come orari secondari. Questo campo compila il sottocampo type, che attinge da un elenco predefinito di tipi di orari di apertura (ad esempio DRIVE_THROUGH, PICKUP o TAKEOUT) in base ai tipi di luogo. Questo campo include il sottocampo special_days di tutti gli orari, impostato per le date con orari eccezionali.

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 l'asporto.

facoltativo Array<string>

Contiene un array di tipi di elementi 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 le località di Sydney, in Australia, durante l'ora legale, questo valore sarà 660 (+11 ore rispetto all'ora UTC), mentre per le località della California al di fuori dell'ora legale, questo valore sarà -480 (-8 ore rispetto all'ora UTC).

facoltativo stringa

Solo per i risultati relativi alle attività (types:["establishment", ...])), il campo vicinity contiene un indirizzo semplificato del luogo, inclusi il nome della via, il numero civico e la località, ma non la provincia/lo stato, il codice postale o il paese.

Per tutti gli altri risultati, il campo vicinity contiene il nome della caratteristica politica (types:["political", ...]) più specifica presente nell'indirizzo del risultato.

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 ha 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 di 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 l'orario 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 sette giorni successivi.

Per saperne di più, consulta PlaceSpecialDay.

facoltativo stringa

Una stringa di tipo utilizzata per identificare il tipo di orario secondario (ad esempio DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). Impostata solo per secondary_opening_hours.

facoltativo Array<string>

Un array di stringhe che descrivono in testo leggibile gli orari del luogo.

PlaceOpeningHoursPeriod

Campo Obbligatorio Tipo Descrizione
required PlaceOpeningHoursPeriodDetail

Contiene una coppia di oggetti giorno e ora che descrivono l'orario di apertura del luogo.

Per saperne di più, consulta PlaceOpeningHoursPeriodDetail.

facoltativo PlaceOpeningHoursPeriodDetail

Può contenere una coppia di oggetti giorno e ora che descrivono quando il luogo chiude. Se un luogo è sempre aperto, la sezione di chiusura non sarà presente nella risposta. I client possono fare affidamento sul fatto che l'apertura continua sia rappresentata come un periodo di apertura contenente il giorno con valore 0 e l'ora con valore 0000, senza close.

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 true, significa che esiste almeno un'eccezione per questo giorno. Le eccezioni causano valori diversi nei campi secondari di current_opening_hours e secondary_opening_hours, ad esempio periods, weekday_text, open_now. Le eccezioni si applicano agli orari, che vengono utilizzati per generare gli altri campi.

PlaceOpeningHoursPeriodDetail

Campo Obbligatorio Tipo Descrizione
required numero

Un numero compreso tra 0 e 6, corrispondente ai giorni della settimana, a partire dalla domenica. Ad esempio, 2 indica martedì.

required 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

True se un determinato periodo è stato troncato a causa di un limite di sette giorni, dove il periodo inizia prima della mezzanotte della data della richiesta e/o termina a mezzanotte o dopo l'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 con 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 dei luoghi.

Campo Obbligatorio Tipo Descrizione
required numero

L'altezza della foto.

required Array<string>

Le attribuzioni HTML della foto.

required stringa

Una stringa utilizzata per identificare la foto quando esegui una richiesta di foto.

required numero

La larghezza della foto.

PlaceReview

Una recensione del luogo inviata da un utente.

Campo Obbligatorio Tipo Descrizione
required stringa

Il nome dell'utente che ha inviato la recensione. Le recensioni anonime vengono attribuite a "Un utente Google".

required numero

La valutazione complessiva dell'utente per questo luogo. Si tratta di un numero intero compreso tra 1 e 5.

required stringa

L'ora in cui la recensione è stata inviata in formato testo, rispetto all'ora corrente.

required numero

L'ora di invio della recensione, misurata in numero di 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, original_language != language.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

L'URL della foto del profilo dell'utente, se disponibile.

facoltativo stringa

La recensione dell'utente. Quando recensisci una località con Google Places, le recensioni di testo sono considerate facoltative. Pertanto, questo campo potrebbe essere vuoto. Tieni presente che questo campo può includere un markup HTML di base. Ad esempio, il riferimento entità &amp; può rappresentare un carattere e commerciale.

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 alla recensione la stringa "Tradotto da Google".