Questo prodotto o questa funzionalità è in stato Legacy. Per ulteriori informazioni sullo stato Legacy, consulta Funzionalità e prodotti legacy. Per eseguire la migrazione all'API Places (nuova), consulta la guida alla migrazione.

Trova luogo (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

Nota: librerie lato server e lato client

L'API Places è disponibile anche con il client Java, il client Python, il client Go e il client Node.js per i servizi Google Maps. L'API Places e le librerie client sono destinate all'uso nelle applicazioni server.

Se stai creando un'applicazione lato client, dai un'occhiata a Places SDK for Android (New), a Places SDK for iOS (New) e alla libreria Places, API Maps JavaScript.

Una richiesta Trova luogo (legacy) accetta un input di testo e restituisce un luogo. L'input può essere qualsiasi tipo di dati di Places in formato testo, ad esempio un nome, un indirizzo o un numero di telefono. La richiesta deve essere una stringa. Una richiesta Trova luogo (legacy) che utilizza dati non stringa come una coordinata di latitudine/longitudine o un Plus Code genera un errore.

Una richiesta Find Place (legacy) restituisce un sottoinsieme dei campi restituiti da una richiesta Places Details (legacy). Per ulteriori informazioni sui campi non disponibili in una richiesta Trova luogo (legacy), consulta Supporto dei campi dell'API Places. Se il campo che ti interessa non viene restituito, puoi utilizzare Trova luogo (legacy) per ottenere un place_id, quindi utilizzare questo ID per effettuare una richiesta Place Details (legacy).

Richieste Trova luogo (legacy)

Una richiesta Trova luogo (legacy) è un URL HTTP nel seguente formato:

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

dove output può avere 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 Trova luogo (legacy), sono necessari alcuni parametri. Come di consueto negli URL, tutti i parametri sono separati dal carattere e commerciale (&).

Parametri obbligatori

immissione

La stringa di testo su cui eseguire la ricerca, ad esempio "ristorante" o "Via Principale 123". Deve essere un toponimo, un indirizzo o una categoria di attività. Qualsiasi altro tipo di input può generare errori e non garantisce la restituzione di risultati validi. L'API Places restituirà corrispondenze candidate in base a questa stringa e ordinerà i risultati in base alla loro pertinenza percepita.
inputtype

Il tipo di input. Può essere textquery o phonenumber. I numeri di telefono devono essere in formato internazionale (preceduti da un segno più ("+"), seguito dal codice paese e poi dal numero di telefono). Per ulteriori informazioni, consulta la raccomandazione E.164 dell'ITU.

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 un place_id, quindi utilizzare questo ID luogo per effettuare una richiesta Place Details. Per ulteriori informazioni sui campi non disponibili in una richiesta Place Search, 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. I campi Basic vengono fatturati alla tariffa di base, mentre i campi Contact e Atmosphere vengono fatturati a una tariffa superiore. 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, 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 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 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 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.
locationbias

Preferisci i risultati in un'area specificata, indicando un raggio più latitudine/longitudine o due coppie di latitudine/longitudine che rappresentano i punti di un rettangolo. Se questo parametro non è specificato, l'API utilizza la ponderazione dell'indirizzo IP per impostazione predefinita.
- Bias IP: indica all'API di utilizzare la ponderazione dell'indirizzo IP. Trasmetti la stringa ipbias (questa opzione non ha parametri aggiuntivi).
- Circolare: una stringa che specifica il raggio in metri, più lat/lng in gradi decimali. Utilizza il formato seguente: circle:radius@lat,lng.
- Rettangolare: una stringa che specifica due coppie di latitudine/longitudine in gradi decimali, che rappresentano i punti sud/ovest e nord/est di un rettangolo. Utilizza il seguente formato:rectangle:south,west|north,east. Nota che i valori est/ovest sono inclusi nell'intervallo -180, 180 e i valori nord/sud sono inclusi nell'intervallo -90, 90.

Nota: se ometti il parametro fields da una richiesta Trova luogo (legacy), verrà restituito solo il place_id per il risultato.

Esempi di Trova luogo (legacy)

L'esempio seguente mostra una richiesta Find Place (legacy) per "Museum of Contemporary Art Australia", inclusi i campi photos, formatted_address, name, rating, opening_hours e geometry:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

L'esempio seguente mostra una richiesta Trova luogo (legacy) per "Mongolian Grill", utilizzando il parametro locationbias per preferire i risultati entro 2000 metri dalle coordinate specificate:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

L'esempio seguente mostra una richiesta Trova luogo (legacy) per un numero di telefono. Tieni presente che il prefisso della chiamata internazionale "+" è stato codificato in %2B in modo che questa richiesta sia un URL conforme. Se non viene codificato, il prefisso + viene decodificato in uno spazio sul server, il che comporta una ricerca del numero di telefono non valida.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Risposte di Trova luogo (legacy)

Una risposta Trova luogo (legacy) contiene solo i tipi di dati specificati utilizzando il parametro fields, più html_attributions. L'esempio seguente mostra la risposta a una richiesta Find Place (legacy) per "Museum of Contemporary Art Australia", inclusi i campi formatted_address, geometry, name, opening_hours, photos, rating.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

Campo	Obbligatorio	Tipo	Descrizione
`candidates`	obbligatorio	Array<Place>	Contiene un array di luoghi consigliati. Le richieste di ricerca di luoghi restituiscono un sottoinsieme dei campi restituiti dalle richieste Places Details. Se il campo che ti interessa non viene restituito dalla ricerca di luoghi, puoi utilizzare la ricerca di luoghi per ottenere un place_id, quindi utilizzare questo ID luogo per effettuare una richiesta Place Details. Per saperne di più, consulta Luogo.
`status`	obbligatorio	PlacesSearchStatus	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 PlacesSearchStatus.
`error_message`	facoltativo	stringa	Quando il servizio restituisce un codice di stato diverso da `OK<`, potrebbe essere presente un campo `error_message` aggiuntivo all'interno dell'oggetto risposta. Questo campo contiene informazioni più dettagliate sui motivi alla base del codice di stato specificato. Questo campo non viene restituito sempre e i suoi contenuti sono soggetti a modifiche.
`info_messages`	facoltativo	Array<stringa>	Quando il servizio restituisce ulteriori informazioni 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 riuscite. Potrebbe non essere sempre restituito e il suo contenuto è soggetto a modifiche.

PlacesSearchStatus

Codici di stato restituiti dal servizio.

OK che indica che la richiesta API è andata a buon fine.
ZERO_RESULTS che indica che la ricerca è andata a buon fine, ma non ha restituito risultati. Ciò può verificarsi se nella ricerca è stato passato un latlng in una posizione remota.
INVALID_REQUEST che indica che la richiesta API non è formattata correttamente, in genere a causa della mancanza del parametro di query obbligatorio (location o radius).
OVER_QUERY_LIMIT che 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).
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 include 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
`address_components`	facoltativo	Array<`AddressComponent`>	Un array contenente i componenti separati applicabili a questo indirizzo. Per saperne di più, consulta `AddressComponent`.
`adr_address`	facoltativo	stringa	Una rappresentazione dell'indirizzo del luogo nel microformato adr.
`business_status`	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`
`curbside_pickup`	facoltativo	booleano	Specifica se l'attività supporta il ritiro all'esterno.
`current_opening_hours`	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 `special_days` di tutte le ore, impostato per le date con orari eccezionali. Per saperne di più, consulta PlaceOpeningHours.
`delivery`	facoltativo	booleano	Specifica se l'attività supporta la consegna.
`dine_in`	facoltativo	booleano	Specifica se l'attività supporta opzioni di posti a sedere al chiuso o all'aperto.
`editorial_summary`	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.
`formatted_address`	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.
`formatted_phone_number`	facoltativo	stringa	Contiene il numero di telefono del luogo nel suo formato locale.
`geometry`	facoltativo	`Geometry`	Contiene la posizione e l'area visibile per la posizione. Consulta `Geometry` per saperne di più.
`icon`	facoltativo	stringa	Contiene l'URL di un'icona suggerita che potrebbe essere visualizzata all'utente quando indica questo risultato su una mappa.
`icon_background_color`	facoltativo	stringa	Contiene il codice colore esadecimale predefinito per la categoria del luogo.
`icon_mask_base_uri`	facoltativo	stringa	Contiene l'URL di un'icona consigliata, senza l'estensione del tipo di file `.svg` o `.png`.
`international_phone_number`	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, è `+61 2 9374 4000`.
`name`	facoltativo	stringa	Contiene il nome leggibile del risultato restituito. Per i risultati `establishment`, in genere si tratta del nome dell'attività canonico.
`opening_hours`	facoltativo	PlaceOpeningHours	Contiene l'orario di apertura normale. Per saperne di più, consulta PlaceOpeningHours.
`permanently_closed`	facoltativo	booleano	`permanently_closed` è deprecato. Utilizza `business_status` per ottenere lo stato operativo delle attività.
`photos`	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.
`place_id`	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 dell'API Places. Per saperne di più sugli ID luogo, consulta la panoramica degli ID luogo.
`plus_code`	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 `PlusCode` per saperne di più.
`price_level`	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: 0 Nessun costo 1 Economico 2 Moderato 3 Costoso 4 Molto costoso
`rating`	facoltativo	numero	Contiene la valutazione del luogo, da 1,0 a 5,0, in base alle recensioni aggregate degli utenti.
`reference`	facoltativo	stringa	`reference` è deprecato.
`reservable`	facoltativo	booleano	Specifica se il luogo supporta le prenotazioni.
`reviews`	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 `reviews_sort` per controllare l'ordinamento. Per `most_relevant` (impostazione predefinita), le recensioni vengono ordinate in base alla pertinenza; il servizio orienta i risultati in modo da restituire le recensioni scritte originariamente nella lingua preferita. Per `newest`, le recensioni sono ordinate cronologicamente; la lingua preferita non influisce sull'ordine di ordinamento. Google consiglia di indicare agli utenti se i risultati sono ordinati per `most_relevant` o `newest`. Per ulteriori informazioni, consulta PlaceReview.
`scope`	facoltativo	stringa	`scope` è deprecato.
`secondary_opening_hours`	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 `type`, che attinge a 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 campo secondario `special_days` di tutte le ore impostate per le date con orari eccezionali. Per saperne di più, consulta PlaceOpeningHours.
`serves_beer`	facoltativo	booleano	Specifica se il luogo serve birra.
`serves_breakfast`	facoltativo	booleano	Specifica se il luogo serve la colazione.
`serves_brunch`	facoltativo	booleano	Specifica se il luogo serve il brunch.
`serves_dinner`	facoltativo	booleano	Specifica se il luogo serve la cena.
`serves_lunch`	facoltativo	booleano	Specifica se il luogo serve il pranzo.
`serves_vegetarian_food`	facoltativo	booleano	Specifica se il luogo serve cibo vegetariano.
`serves_wine`	facoltativo	booleano	Specifica se il luogo serve vino.
`takeout`	facoltativo	booleano	Specifica se l'attività supporta il servizio d'asporto.
`types`	facoltativo	Array<stringa>	Contiene un array di tipi di funzionalità che descrivono il risultato specificato. Consulta l'elenco dei tipi supportati.
`url`	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.
`user_ratings_total`	facoltativo	numero	Il numero totale di recensioni, con o senza testo, per questo luogo.
`utc_offset`	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).
`vicinity`	facoltativo	stringa	Per i risultati relativi agli stabilimenti (`types:["establishment", ...])` ), il campo `vicinity` contiene un indirizzo semplificato del luogo, inclusi nome della via, numero civico e località, ma non provincia/stato, codice postale o paese. Per tutti gli altri risultati, il campo `vicinity` contiene il nome della funzionalità 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.
`website`	facoltativo	stringa	Il sito web autorevole di questo luogo, ad esempio la home page di un'attività.
`wheelchair_accessible_entrance`	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
`language`	facoltativo	stringa	La lingua dei campi precedenti. Potrebbe non essere sempre presente.
`overview`	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
`open_now`	facoltativo	booleano	Un valore booleano che indica se il luogo è aperto al momento.
`periods`	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.
`special_days`	facoltativo	Array<PlaceSpecialDay>	Un array di massimo sette voci corrispondenti ai prossimi sette giorni. Per ulteriori informazioni, consulta PlaceSpecialDay.
`type`	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`). Impostato solo per `secondary_opening_hours`.
`weekday_text`	facoltativo	Array<stringa>	Un array di stringhe che descrivono in testo leggibile gli orari del luogo.

PlaceOpeningHoursPeriod

Campo	Obbligatorio	Tipo	Descrizione
`open`	obbligatorio	PlaceOpeningHoursPeriodDetail	Contiene una coppia di oggetti giorno e ora che descrivono quando il luogo apre. Per saperne di più, consulta PlaceOpeningHoursPeriodDetail.
`close`	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 `0` e l'ora con valore `0000` e nessun `close`. Per saperne di più, consulta PlaceOpeningHoursPeriodDetail.

PlaceSpecialDay

Campo	Obbligatorio	Tipo	Descrizione
`date`	facoltativo	stringa	Una data espressa nel formato RFC3339 nel fuso orario locale del luogo, ad esempio 2010-12-31.
`exceptional_hours`	facoltativo	booleano	True se sono previsti orari eccezionali per questo giorno. Se `true`, significa che per questo giorno è presente almeno un'eccezione. Le eccezioni fanno sì che nei sottocampi di `current_opening_hours` e `secondary_opening_hours` si verifichino valori diversi, ad esempio `periods`, `weekday_text`, `open_now`. Le eccezioni si applicano alle ore, che vengono utilizzate per generare gli altri campi.

PlaceOpeningHoursPeriodDetail

Campo	Obbligatorio	Tipo	Descrizione
`day`	obbligatorio	numero	Un numero compreso tra 0 e 6, corrispondente ai giorni della settimana, a partire da domenica. Ad esempio, 2 indica martedì.
`time`	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.
`date`	facoltativo	stringa	Una data espressa nel formato RFC3339 nel fuso orario locale del luogo, ad esempio 2010-12-31.
`truncated`	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
`height`	obbligatorio	numero	L'altezza della foto.
`html_attributions`	obbligatorio	Array<stringa>	Le attribuzioni HTML per la foto.
`photo_reference`	obbligatorio	stringa	Una stringa utilizzata per identificare la foto quando esegui una richiesta di foto.
`width`	obbligatorio	numero	La larghezza della foto.

PlaceReview

Una recensione del luogo inviata da un utente.

Campo	Obbligatorio	Tipo	Descrizione
`author_name`	obbligatorio	stringa	Il nome dell'utente che ha inviato la recensione. Le recensioni anonime sono attribuite a "Un utente Google".
`rating`	obbligatorio	numero	La valutazione complessiva dell'utente per questo luogo. Si tratta di un numero intero compreso tra 1 e 5.
`relative_time_description`	obbligatorio	stringa	L'ora in cui è stata inviata la recensione in formato testo, rispetto all'ora attuale.
`time`	obbligatorio	numero	L'ora in cui è stata inviata la recensione, misurata in secondi dalla mezzanotte del 1° gennaio 1970 UTC.
`author_url`	facoltativo	stringa	L'URL del profilo Local Guides di Google Maps dell'utente, se disponibile.
`language`	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.
`original_language`	facoltativo	stringa	Un codice lingua IETF che indica la lingua originale della recensione. Se la recensione è stata tradotta, allora `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.
`profile_photo_url`	facoltativo	stringa	L'URL della foto del profilo dell'utente, se disponibile.
`text`	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à `&` può rappresentare il carattere e commerciale.
`translated`	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.

Trova luogo (legacy) Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Richieste Trova luogo (legacy)

Parametri obbligatori

immissione

inputtype

Parametri facoltativi

i campi

language

locationbias

Esempi di Trova luogo (legacy)

curl

HTTP

curl

HTTP

curl

HTTP

Risposte di Trova luogo (legacy)

JSON

XML

PlacesFindPlaceFromTextResponse

candidates

status

error_message

info_messages

PlacesSearchStatus

Luogo

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

Trova luogo (legacy)

`candidates`

`status`

`error_message`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`