REST Resource: places

Risorsa: luogo

Tutte le informazioni che rappresentano un luogo.

Rappresentazione JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
Campi
name

string

Il nome della risorsa di questo luogo, in formato places/{placeId}. Può essere utilizzato per cercare il luogo.
id

string

L'identificatore univoco di un luogo.
displayName

object (LocalizedText)

Il nome localizzato del luogo, adatto come breve descrizione leggibile. Ad esempio, "Google Sydney", "Starbucks", "Pyrmont" e così via.
types[]

string

Un insieme di tag di tipo per questo risultato. Ad esempio, "politico" e "località". Per l'elenco completo dei valori possibili, consulta le tabelle A e B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types
primaryType

string

Il tipo principale del risultato specificato. Questo tipo deve essere uno dei tipi supportati dall'API Places. Ad esempio, "ristorante", "bar", "aeroporto" e così via. Un luogo può avere un solo tipo principale. Per l'elenco completo dei valori possibili, consulta le tabelle A e B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types
primaryTypeDisplayName

object (LocalizedText)

Il nome visualizzato del tipo principale, localizzato nella lingua della richiesta, se applicabile. Per l'elenco completo dei valori possibili, consulta le tabelle A e B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types
nationalPhoneNumber

string

Un numero di telefono leggibile per il luogo, in formato nazionale.
internationalPhoneNumber

string

Un numero di telefono leggibile per il luogo, in formato internazionale.
formattedAddress

string

Un indirizzo completo e leggibile per questo luogo.
shortFormattedAddress

string

Un indirizzo breve e leggibile per questo luogo.
addressComponents[]

object (AddressComponent)

Componenti ripetuti per ogni livello di località. Tieni presente i seguenti aspetti relativi all'array addressComponents[]: - L'array di componenti dell'indirizzo può contenere più componenti rispetto all'indirizzoFormattato. - L'array non include necessariamente tutte le entità politiche che contengono un indirizzo, a parte quelle incluse in formattedAddress. Per recuperare tutte le entità politiche che contengono un indirizzo specifico, devi utilizzare la geocodifica inversa, passando la latitudine/longitudine dell'indirizzo come parametro alla richiesta. - Non è garantito che il formato della risposta rimanga invariato tra le richieste. In particolare, il numero di elementi addressComponents varia in base all'indirizzo richiesto e può cambiare nel tempo per lo stesso indirizzo. Un componente può cambiare posizione nell'array. Il tipo di componente può cambiare. Un determinato componente potrebbe non essere presente in una risposta successiva.
plusCode

object (PlusCode)

Plus Code della latitudine/longitudine della posizione del luogo.
location

object (LatLng)

La posizione di questo luogo.
viewport

object (Viewport)

Un'area visibile adatta per la visualizzazione del luogo su una mappa di dimensioni medie. Questo viewport non deve essere utilizzato come confine fisico o area di servizio dell'attività.
rating

number

Una valutazione compresa tra 1,0 e 5,0, in base alle recensioni degli utenti su questo luogo.
googleMapsUri

string

Un URL che fornisce ulteriori informazioni su questo luogo.
websiteUri

string

Il sito web autorevole per questo luogo, ad esempio la home page di un'attività. Tieni presente che per i luoghi che fanno parte di una catena (ad es. un negozio IKEA), in genere si tratta del sito web del singolo negozio, non della catena nel suo complesso.
reviews[]

object (Review)

Elenco di recensioni su questo luogo, ordinate per pertinenza. È possibile restituire un massimo di 5 recensioni.
regularOpeningHours

object (OpeningHours)

Gli orari di apertura normali. Tieni presente che se un luogo è sempre aperto (24 ore), il campo close non verrà impostato. I clienti possono fare affidamento sul fatto che l'apertura continua (24 ore) sia rappresentata come un periodo [open][OpeningHours.Period.open] contenente [day][Point.day] con valore 0, [hour][Point.hour] con valore 0 e [minute][Point.minute] con valore 0.
photos[]

object (Photo)

Informazioni (inclusi i riferimenti) sulle foto di questo luogo. È possibile restituire un massimo di 10 foto.
adrFormatAddress

string

L'indirizzo del luogo nel microformato adr: http://microformats.org/wiki/adr.
businessStatus

enum (BusinessStatus)

Lo stato dell'attività per il luogo.
priceLevel

enum (PriceLevel)

Il livello di prezzo del luogo.
attributions[]

object (Attribution)

Un insieme di fornitori di dati che devono essere mostrati con questo risultato.
iconMaskBaseUri

string

Un URL troncato a una maschera di icone. L'utente può accedere a diversi tipi di icone aggiungendo il suffisso del tipo alla fine (ad es. ".svg" o ".png").
iconBackgroundColor

string

Colore di sfondo per icon_mask in formato esadecimale, ad esempio #909CE1.
currentOpeningHours

object (OpeningHours)

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 sottocampo specialDays di tutte le ore, impostato per le date con orari eccezionali.
currentSecondaryOpeningHours[]

object (OpeningHours)

Contiene un array di voci per i sette giorni successivi, incluse informazioni sugli orari secondari di un'attività. Gli orari secondari sono diversi da quelli principali di un'attività. Ad esempio, un ristorante può specificare come orari secondari quelli del servizio in auto o della consegna a domicilio. Questo campo compila il sottocampo type, che viene ricavato da un elenco predefinito di tipi di orario di apertura (ad esempio DRIVE_THROUGH, PICKUP o TAKEOUT) in base ai tipi di luogo. Questo campo include il sottocampo specialDays di tutte le ore, impostato per le date con orari eccezionali.
regularSecondaryOpeningHours[]

object (OpeningHours)

Contiene un array di voci per informazioni sugli orari secondari regolari di un'attività. Gli orari secondari sono diversi da quelli principali di un'attività. Ad esempio, un ristorante può specificare come orari secondari quelli del servizio in auto o della consegna a domicilio. Questo campo compila il sottocampo type, che viene ricavato da un elenco predefinito di tipi di orario di apertura (ad esempio DRIVE_THROUGH, PICKUP o TAKEOUT) in base ai tipi di luogo.
editorialSummary

object (LocalizedText)

Contiene un riepilogo del luogo. Un riepilogo è costituito 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.
paymentOptions

object (PaymentOptions)

Le opzioni di pagamento accettate dal luogo. Se i dati di un'opzione di pagamento non sono disponibili, il campo dell'opzione di pagamento non verrà impostato.
parkingOptions

object (ParkingOptions)

Opzioni di parcheggio offerte dalla struttura.
subDestinations[]

object (SubDestination)

Un elenco di destinazioni secondarie correlate al luogo.
fuelOptions

object (FuelOptions)

Le informazioni più recenti sulle opzioni di carburante in una stazione di servizio. Queste informazioni vengono aggiornate regolarmente.
evChargeOptions

object (EVChargeOptions)

Informazioni sulle opzioni di ricarica EV.
generativeSummary

object (GenerativeSummary)

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riepilogo del luogo creato con l'IA.
areaSummary

object (AreaSummary)

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riepilogo dell'area in cui si trova il luogo creato con l'IA.
containingPlaces[]

object (ContainingPlace)

Elenco di località in cui si trova la località corrente.
addressDescriptor

object (AddressDescriptor)

Il descrittore dell'indirizzo del luogo. I descrittori degli indirizzi includono informazioni aggiuntive che aiutano a descrivere una località utilizzando punti di riferimento e aree. Consulta la copertura regionale dei descrittori degli indirizzi all'indirizzo https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
priceRange

object (PriceRange)

La fascia di prezzo associata a un luogo.
utcOffsetMinutes

integer

Numero di minuti di differenza tra il fuso orario di questo luogo e UTC. Questo valore è espresso in minuti per supportare i fusi orari con uno scarto di frazioni di un'ora, ad esempio X ore e 15 minuti.
userRatingCount

integer

Il numero totale di recensioni (con o senza testo) per questo luogo.
takeout

boolean

Specifica se l'attività supporta il salvataggio.
delivery

boolean

Specifica se l'attività supporta la consegna.
dineIn

boolean

Specifica se l'attività supporta opzioni di posti a sedere al chiuso o all'aperto.
curbsidePickup

boolean

Specifica se l'attività supporta il ritiro all'esterno.
reservable

boolean

Specifica se il luogo supporta le prenotazioni.
servesBreakfast

boolean

Specifica se la struttura serve la colazione.
servesLunch

boolean

Specifica se il luogo serve il pranzo.
servesDinner

boolean

Specifica se il luogo serve la cena.
servesBeer

boolean

Specifica se il luogo serve birra.
servesWine

boolean

Specifica se il luogo serve vino.
servesBrunch

boolean

Specifica se il luogo serve il brunch.
servesVegetarianFood

boolean

Specifica se il luogo serve cibo vegetariano.
outdoorSeating

boolean

Il locale offre posti a sedere all'aperto.
liveMusic

boolean

Il locale offre musica dal vivo.
menuForChildren

boolean

Il locale offre un menu per bambini.
servesCocktails

boolean

Il locale serve cocktail.
servesDessert

boolean

Il locale serve dessert.
servesCoffee

boolean

Il locale serve caffè.
goodForChildren

boolean

Il posto è adatto ai bambini.
allowsDogs

boolean

Il luogo ammette cani.
restroom

boolean

Il luogo dispone di toilette.
goodForGroups

boolean

Il luogo può ospitare gruppi.
goodForWatchingSports

boolean

Il luogo è adatto per guardare sport.
accessibilityOptions

object (AccessibilityOptions)

Informazioni sulle opzioni di accessibilità offerte da un luogo.
pureServiceAreaBusiness

boolean

Indica se il luogo è un'attività con area coperta dal servizio. Un'attività al domicilio del cliente è un'attività che effettua consegne a domicilio o raggiunge direttamente i clienti, ma non presta servizio ai clienti presso l'indirizzo aziendale. Ad esempio, attività come servizi di pulizia o idraulici. Queste attività potrebbero non avere un indirizzo fisico o una sede su Google Maps.

LocalizedText

Variante localizzata di un testo in una determinata lingua.

Rappresentazione JSON 
{
  "text": string,
  "languageCode": string
}
Campi
text

string

Stringa localizzata nella lingua corrispondente a languageCode di seguito.
languageCode

string

Il codice lingua BCP-47 del testo, ad esempio "en-US" o "sr-Latn".

Per ulteriori informazioni, visita la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

AddressComponent

I componenti strutturati che formano l'indirizzo formattato, se queste informazioni sono disponibili.

Rappresentazione JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Campi
longText

string

La descrizione completa del testo o il nome del componente dell'indirizzo. Ad esempio, un componente dell'indirizzo per il paese Australia potrebbe avere un valore long_name di "Australia".
shortText

string

Un nome testuale abbreviato per il componente dell'indirizzo, se disponibile. Ad esempio, un componente dell'indirizzo per il paese Australia potrebbe avere un valore short_name di "AU".
types[]

string

Un array che indica i tipi di componenti dell'indirizzo.
languageCode

string

La lingua utilizzata per formattare questi componenti, in notazione CLDR.

PlusCode

Il Plus Code (http://plus.codes) è un riferimento di posizione con due formati: il codice globale che definisce un rettangolo di 14 m x 14 m (1/8000 di grado) o più piccolo e il codice composto, che sostituisce il prefisso con una posizione di riferimento.

Rappresentazione JSON 
{
  "globalCode": string,
  "compoundCode": string
}
Campi
globalCode

string

Il codice globale (completo) del luogo, ad esempio "9FWM33GV+HQ ", che rappresenta un'area di 1/8000 gradi per 1/8000 gradi (~14 per 14 metri).
compoundCode

string

Il codice composto del luogo, ad esempio "33GV+HQ, Ramberg, Norvegia ", contenente il suffisso del codice globale e sostituendo il prefisso con il nome formattato di un'entità di riferimento.

LatLng

Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore è espresso come una coppia di numeri doppi per rappresentare i gradi di latitudine e di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono rientrare in intervalli normalizzati.

Rappresentazione JSON 
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].
longitude

number

La longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

Area visibile

Un'area visibile di latitudine e longitudine, rappresentata da due punti low e high diagonalmente opposti. Un viewport è considerato una regione chiusa, ovvero include il suo confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi e i limiti di longitudine tra -180 e 180 gradi inclusi. Vari casi includono:

  • Se low = high, l'area visibile è costituita da quel singolo punto.

  • Se low.longitude > high.longitude, l'intervallo di longitudine è invertito (l'area visibile attraversa la linea di longitudine di 180 gradi).

  • Se low.longitude = -180 gradi e high.longitude = 180 gradi, l'area visibile include tutte le longitudini.

  • Se low.longitude = 180 gradi e high.longitude = -180 gradi, l'intervallo di longitudine è vuoto.

  • Se low.latitude > high.latitude, l'intervallo di latitudine è vuoto.

Sia low che high devono essere compilati e la casella rappresentata non può essere vuota (come specificato dalle definizioni precedenti). Un viewport vuoto comporterà un errore.

Ad esempio, questa visualizzazione inclusa racchiude completamente New York:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Rappresentazione JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campi
low

object (LatLng)

Obbligatorio. Il punto più basso dell'area visibile.
high

object (LatLng)

Obbligatorio. Il punto più alto dell'area visibile.

Rivedi

Informazioni su una recensione di un luogo.

Rappresentazione JSON 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
Campi
name

string

Un riferimento che rappresenta questa recensione del luogo e che può essere utilizzato per cercarla di nuovo (chiamato anche nome della "risorsa" dell'API: places/{placeId}/reviews/{review}).
relativePublishTimeDescription

string

Una stringa di ora recente formattata, che esprime l'ora della recensione rispetto all'ora corrente in una forma appropriata per la lingua e il paese.
text

object (LocalizedText)

Il testo localizzato della recensione.
originalText

object (LocalizedText)

Il testo della recensione nella lingua originale.
rating

number

Un numero compreso tra 1,0 e 5,0, chiamato anche numero di stelle.
authorAttribution

object (AuthorAttribution)

L'autore di questa recensione.
publishTime

string (Timestamp format)

Timestamp della recensione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
flagContentUri

string

Un link tramite il quale gli utenti possono segnalare un problema con la recensione.
googleMapsUri

string

Un link per mostrare la recensione su Google Maps.

AuthorAttribution

Informazioni sull'autore dei dati relativi ai contenuti generati dagli utenti. Utilizzata in Photo e Review.

Rappresentazione JSON 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Campi
displayName

string

Nome dell'autore del Photo o del Review.
uri

string

URI dell'autore del Photo o del Review.
photoUri

string

URI della foto del profilo dell'autore del Photo o del Review.

OpeningHours

Informazioni sull'orario di apertura del luogo.

Rappresentazione JSON 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Campi
periods[]

object (Period)

I periodi in cui il luogo è aperto durante la settimana. I periodi sono in ordine cronologico, a partire da domenica nel fuso orario locale della località. Un valore vuoto (ma non assente) indica un luogo che non è mai aperto, ad esempio perché è chiuso temporaneamente per lavori di ristrutturazione.
weekdayDescriptions[]

string

Stringhe localizzate che descrivono gli orari di apertura del luogo, una stringa per ogni giorno della settimana. Sarà vuoto se l'orario è sconosciuto o non è stato possibile convertirlo in testo localizzato. Esempio: "Dom: 18:00-06:00"
secondaryHoursType

enum (SecondaryHoursType)

Una stringa di tipo utilizzata per identificare il tipo di ore secondarie.
specialDays[]

object (SpecialDay)

Informazioni strutturate per i giorni speciali che rientrano nel periodo coperto dagli orari di apertura restituiti. I giorni speciali sono giorni che potrebbero influire sull'orario di apertura di un luogo, ad esempio il giorno di Natale. Imposta per currentOpeningHours e currentSecondaryOpeningHours se sono presenti orari eccezionali.
nextOpenTime

string (Timestamp format)

La prossima volta che inizia il periodo di apertura attuale fino a 7 giorni nel futuro. Questo campo viene compilato solo se il periodo di apertura non è attivo al momento della pubblicazione della richiesta.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
nextCloseTime

string (Timestamp format)

La prossima volta che termina il periodo dell'orario di apertura attuale fino a 7 giorni nel futuro. Questo campo viene compilato solo se il periodo di apertura è attivo al momento della pubblicazione della richiesta.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
openNow

boolean

Indica se il periodo di apertura è attualmente attivo. Per gli orari di apertura normali e quelli attuali, questo campo indica se il luogo è aperto. Per gli orari di apertura secondari e gli orari di apertura secondari attuali, questo campo indica se gli orari secondari di questo luogo sono attivi.

Periodo

Un periodo in cui il luogo rimane nello stato openNow.

Rappresentazione JSON 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Campi
open

object (Point)

L'ora in cui il luogo inizia a essere aperto.
close

object (Point)

L'ora in cui il luogo inizia a essere chiuso.

Punto

Punti di variazione dello stato.

Rappresentazione JSON 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Campi
date

object (Date)

Data nel fuso orario locale del luogo.
truncated

boolean

Indica se questo endpoint è stato troncato o meno. Il troncamento si verifica quando le ore reali non rientrano nell'intervallo di ore che siamo disposti a restituire, quindi le tronchiamo in base a questi limiti. In questo modo vengono restituite al massimo 24 * 7 ore dalla mezzanotte del giorno della richiesta.
day

integer

Un giorno della settimana, come numero intero compreso tra 0 e 6. 0 è domenica, 1 è lunedì e così via.
hour

integer

L'ora in formato 24 ore. Intervallo da 0 a 23.
minute

integer

Il minuto. Intervallo da 0 a 59.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno pari a zero (ad esempio un anniversario).
  • Un anno da solo, con un mese e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

SecondaryHoursType

Un tipo utilizzato per identificare il tipo di ore secondarie.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Valore predefinito quando non è specificato il tipo di ora secondaria.
DRIVE_THROUGH L'orario di apertura del servizio drive-through per banche, ristoranti o farmacie.
HAPPY_HOUR L'happy hour.
DELIVERY L'ora di consegna.
TAKEOUT L'ora di ritiro.
KITCHEN L'ora della cucina.
BREAKFAST L'ora della colazione.
LUNCH L'ora di pranzo.
DINNER L'ora della cena.
BRUNCH L'ora del brunch.
PICKUP L'ora di ritiro.
ACCESS L'orario di accesso ai luoghi di stoccaggio.
SENIOR_HOURS Gli orari speciali per gli anziani.
ONLINE_SERVICE_HOURS Gli orari di servizio online.

SpecialDay

Informazioni strutturate per i giorni speciali che rientrano nel periodo coperto dagli orari di apertura restituiti. I giorni speciali sono giorni che potrebbero influire sull'orario di apertura di un luogo, ad esempio il giorno di Natale.

Rappresentazione JSON 
{
  "date": {
    object (Date)
  }
}
Campi
date

object (Date)

La data di questo giorno speciale.

Foto

Informazioni su una foto di un luogo.

Rappresentazione JSON 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
Campi
name

string

Identificatore. Un riferimento che rappresenta la foto del luogo e che può essere utilizzato per cercarla di nuovo (chiamato anche nome della "risorsa" dell'API: places/{placeId}/photos/{photo}).
widthPx

integer

La larghezza massima disponibile, in pixel.
heightPx

integer

L'altezza massima disponibile, in pixel.
authorAttributions[]

object (AuthorAttribution)

Gli autori di questa foto.
flagContentUri

string

Un link tramite il quale gli utenti possono segnalare un problema con la foto.
googleMapsUri

string

Un link per mostrare la foto su Google Maps.

BusinessStatus

Stato dell'attività per il luogo.

Enum
BUSINESS_STATUS_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
OPERATIONAL L'attività è operativa, ma non necessariamente aperta al momento.
CLOSED_TEMPORARILY L'attività è temporaneamente chiusa.
CLOSED_PERMANENTLY L'attività è chiusa definitivamente.

PriceLevel

Il livello di prezzo del luogo.

Enum
PRICE_LEVEL_UNSPECIFIED Il livello del prezzo del luogo non è specificato o è sconosciuto.
PRICE_LEVEL_FREE Il luogo offre servizi senza costi.
PRICE_LEVEL_INEXPENSIVE Il luogo offre servizi economici.
PRICE_LEVEL_MODERATE Il luogo offre servizi a prezzi moderati.
PRICE_LEVEL_EXPENSIVE Il luogo offre servizi costosi.
PRICE_LEVEL_VERY_EXPENSIVE Il luogo offre servizi molto costosi.

Attribuzione

Informazioni sui fornitori di dati di questo luogo.

Rappresentazione JSON 
{
  "provider": string,
  "providerUri": string
}
Campi
provider

string

Nome del fornitore di dati del luogo.
providerUri

string

URI del fornitore di dati del luogo.

PaymentOptions

Le opzioni di pagamento accettate dal luogo.

Rappresentazione JSON 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Campi
acceptsCreditCards

boolean

Il luogo accetta carte di credito come forma di pagamento.
acceptsDebitCards

boolean

Il luogo accetta carte di debito come metodo di pagamento.
acceptsCashOnly

boolean

Il luogo accetta solo pagamenti in contanti. I luoghi con questo attributo potrebbero comunque accettare altri metodi di pagamento.
acceptsNfc

boolean

Il luogo accetta pagamenti NFC.

ParkingOptions

Informazioni sulle opzioni di parcheggio per il luogo. Un parcheggio potrebbe supportare più di un'opzione contemporaneamente.

Rappresentazione JSON 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Campi
freeParkingLot

boolean

La struttura offre parcheggi gratuiti.
paidParkingLot

boolean

Il luogo offre parcheggi a pagamento.
freeStreetParking

boolean

Il parcheggio in strada è senza costi.
paidStreetParking

boolean

La struttura offre parcheggio in strada a pagamento.
valetParking

boolean

La struttura offre il servizio di parcheggio.
freeGarageParking

boolean

La struttura offre un garage con parcheggio gratuito.
paidGarageParking

boolean

La struttura offre un garage a pagamento.

SubDestination

Inserisci il nome e l'ID della risorsa luogo delle destinazioni secondarie correlate al luogo. Ad esempio, i terminal diversi sono le diverse destinazioni di un aeroporto.

Rappresentazione JSON 
{
  "name": string,
  "id": string
}
Campi
name

string

Il nome della risorsa della destinazione secondaria.
id

string

L'ID posizione della destinazione secondaria.

AccessibilityOptions

Informazioni sulle opzioni di accessibilità offerte da un luogo.

Rappresentazione JSON 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Campi
wheelchairAccessibleParking

boolean

La struttura offre un parcheggio accessibile in sedia a rotelle.
wheelchairAccessibleEntrance

boolean

I luoghi dispongono di un ingresso accessibile in sedia a rotelle.
wheelchairAccessibleRestroom

boolean

Il luogo dispone di una toilette accessibile in sedia a rotelle.
wheelchairAccessibleSeating

boolean

Il luogo dispone di posti accessibili in sedia a rotelle.

FuelOptions

Le informazioni più recenti sulle opzioni di carburante in una stazione di servizio. Queste informazioni vengono aggiornate regolarmente.

Rappresentazione JSON 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Campi
fuelPrices[]

object (FuelPrice)

L'ultimo prezzo del carburante noto per ogni tipo di carburante disponibile nella stazione di servizio. Esiste una voce per ogni tipo di carburante disponibile nella stazione di servizio. L'ordine non è importante.

FuelPrice

Informazioni sui prezzi del carburante per un determinato tipo.

Rappresentazione JSON 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Campi
type

enum (FuelType)

Il tipo di carburante.
price

object (Money)

Il prezzo del carburante.
updateTime

string (Timestamp format)

L'ora dell'ultimo aggiornamento del prezzo del carburante.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

FuelType

Tipi di carburante.

Enum
FUEL_TYPE_UNSPECIFIED Tipo di carburante non specificato.
DIESEL Carburante diesel.
REGULAR_UNLEADED Benzina normale senza piombo.
MIDGRADE Benzina media.
PREMIUM Alta qualità
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG GPL.
E80 E 80.
E85 E 85.
METHANE Metano.
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Camion diesel.

Denaro

Rappresenta un importo con il relativo tipo di valuta.

Rappresentazione JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campi
currencyCode

string

Il codice valuta di tre lettere definito in ISO 4217.
units

string (int64 format)

Le unità intere dell'importo. Ad esempio, se currencyCode è "USD", 1 unità equivale a un dollaro statunitense.
nanos

integer

Numero di nano (10^-9) unità dell'importo. Il valore deve essere compreso tra -999.999.999 e +999.999.999 compresi. Se units è positivo, nanos deve essere positivo o zero. Se units è zero, nanos può essere positivo, zero o negativo. Se units è negativo, nanos deve essere negativo o uguale a zero. Ad esempio, -1,75 $ è rappresentato come units=-1 e nanos=-750.000.000.

EVChargeOptions

Informazioni sulla stazione di ricarica EV ospitata nel luogo. La terminologia segue le indicazioni riportate all'indirizzo https://afdc.energy.gov/fuels/electricity_infrastructure.html. Una porta potrebbe ricaricare una sola auto alla volta. Una porta ha uno o più connettori. Una stazione ha una o più porte.

Rappresentazione JSON 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Campi
connectorCount

integer

Numero di connettori in questa stazione. Tuttavia, poiché alcune stazioni di ricarica possono avere più connettori, ma essere in grado di ricaricare una sola auto alla volta (ad es.), il numero di connettori potrebbe essere superiore al numero totale di auto che possono essere ricaricate contemporaneamente.
connectorAggregation[]

object (ConnectorAggregation)

Un elenco di aggregazioni di connettori di ricarica EV che contengono connettori dello stesso tipo e della stessa potenza di ricarica.

ConnectorAggregation

Informazioni sulla ricarica EV raggruppate per [type, maxChargeRateKw]. Mostra l'aggregazione della ricarica EV dei connettori che hanno lo stesso tipo e la stessa potenza di ricarica massima in kW.

Rappresentazione JSON 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Campi
type

enum (EVConnectorType)

Il tipo di connettore di questa aggregazione.
maxChargeRateKw

number

La potenza di ricarica massima statica in kW di ogni connettore nell'aggregazione.
count

integer

Numero di connettori in questa aggregazione.
availabilityLastUpdateTime

string (Timestamp format)

Il timestamp dell'ultimo aggiornamento delle informazioni sulla disponibilità del connettore in questa aggregazione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
availableCount

integer

Numero di connettori in questa aggregazione attualmente disponibili.
outOfServiceCount

integer

Numero di connettori in questa aggregazione attualmente fuori servizio.

EVConnectorType

Per ulteriori informazioni/contesto sui tipi di connettori di ricarica per veicoli elettrici, visita la pagina http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Connettore non specificato.
EV_CONNECTOR_TYPE_OTHER Altri tipi di connettori.
EV_CONNECTOR_TYPE_J1772 Connettore J1772 di tipo 1.
EV_CONNECTOR_TYPE_TYPE_2 Connettore IEC 62196 di tipo 2. Spesso indicato come MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Connettore di tipo CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (AC e DC). In base al SAE. Connettore J-1772 di tipo 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (AC e DC). In base al connettore Mennekes di tipo 2
EV_CONNECTOR_TYPE_TESLA Il connettore TESLA generico. Si tratta di NACS in Nord America, ma può essere non NACS in altre parti del mondo (ad es. CCS Combo 2 (CCS2) o GB/T). Questo valore è meno rappresentativo di un tipo di connettore effettivo e rappresenta piuttosto la possibilità di ricaricare un veicolo del marchio Tesla presso una stazione di ricarica di proprietà di Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Il tipo GB/T corrisponde allo standard GB/T in Cina. Questo tipo copre tutti i tipi GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Presa a muro non specificata.

GenerativeSummary

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riepilogo del luogo creato con l'IA.

Rappresentazione JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "description": {
    object (LocalizedText)
  },
  "descriptionFlagContentUri": string,
  "references": {
    object (References)
  }
}
Campi
overview

object (LocalizedText)

La panoramica del luogo.
overviewFlagContentUri

string

Un link tramite il quale gli utenti possono segnalare un problema con il riepilogo della panoramica.
description

object (LocalizedText)

La descrizione dettagliata del luogo.
descriptionFlagContentUri

string

Un link in cui gli utenti possono segnalare un problema con il riepilogo della descrizione.
references

object (References)

Riferimenti utilizzati per generare la descrizione del riepilogo.

Riferimenti

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riferimento a cui si riferiscono i contenuti generativi.

Rappresentazione JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Campi
reviews[]

object (Review)

Recensioni che fungono da riferimenti.
places[]

string

L'elenco dei nomi delle risorse dei luoghi a cui si fa riferimento. Questo nome può essere utilizzato in altre API che accettano nomi di risorse Place.

AreaSummary

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riepilogo dell'area in cui si trova il luogo creato con l'IA.

Rappresentazione JSON 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ],
  "flagContentUri": string
}
Campi
contentBlocks[]

object (ContentBlock)

Blocchi di contenuti che compongono il riepilogo dell'area. Ogni blocco ha un argomento separato relativo all'area.
flagContentUri

string

Un link tramite il quale gli utenti possono segnalare un problema con il riepilogo.

ContentBlock

Un blocco di contenuti che può essere pubblicato singolarmente.

Rappresentazione JSON 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Campi
topic

string

L'argomento dei contenuti, ad esempio "panoramica" o "ristorante".
content

object (LocalizedText)

Contenuti correlati all'argomento.
references

object (References)

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riferimenti correlati a questo blocco di contenuti.

ContainingPlace

Informazioni sul luogo in cui si trova questo luogo.

Rappresentazione JSON 
{
  "name": string,
  "id": string
}
Campi
name

string

Il nome della risorsa del luogo in cui si trova questo luogo.
id

string

L'ID luogo in cui si trova il luogo.

AddressDescriptor

Una descrizione relazionale di una località. Include un insieme classificato di punti di riferimento nelle vicinanze e aree contenenti precise e la loro relazione con la località target.

Rappresentazione JSON 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Campi
landmarks[]

object (Landmark)

Un elenco classificato di punti di riferimento nelle vicinanze. I punti di riferimento più riconoscibili e vicini sono classificati per primi.
areas[]

object (Area)

Un elenco classificato di aree contenenti o adiacenti. Le aree più riconoscibili e precise vengono classificate per prime.

Punto di riferimento

Informazioni di base sul punto di riferimento e sulla sua relazione con la località di destinazione.

I punti di riferimento sono luoghi ben visibili che possono essere utilizzati per descrivere una località.

Rappresentazione JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Campi
name

string

Il nome della risorsa del punto di riferimento.
placeId

string

L'ID posizione del punto di riferimento.
displayName

object (LocalizedText)

Il nome visualizzato del punto di riferimento.
types[]

string

Un insieme di tag di tipo per questo punto di riferimento. Per un elenco completo dei valori possibili, visita la pagina https://developers.google.com/maps/documentation/places/web-service/place-types.
spatialRelationship

enum (SpatialRelationship)

Definisce la relazione spaziale tra la località di destinazione e il punto di riferimento.
straightLineDistanceMeters

number

La distanza in linea retta, in metri, tra il punto centrale del target e il punto centrale del punto di riferimento. In alcuni casi, questo valore può essere più lungo di travelDistanceMeters.
travelDistanceMeters

number

La distanza percorsa, in metri, lungo la rete stradale dal target al punto di riferimento, se noto. Questo valore non tiene conto della modalità di trasporto, ad esempio a piedi, in auto o in bicicletta.

SpatialRelationship

Definisce la relazione spaziale tra la località di destinazione e il punto di riferimento.

Enum
NEAR Questa è la relazione predefinita quando non si applica nulla di più specifico di seguito.
WITHIN Il punto di riferimento ha una geometria spaziale e il target si trova all'interno dei suoi limiti.
BESIDE Il target è direttamente adiacente al punto di riferimento.
ACROSS_THE_ROAD Il target si trova direttamente di fronte al punto di riferimento sull'altro lato della strada.
DOWN_THE_ROAD Sullo stesso percorso del punto di riferimento, ma non accanto o di fronte.
AROUND_THE_CORNER Non sullo stesso percorso del punto di riferimento, ma a una sola svolta di distanza.
BEHIND Vicino alla struttura del punto di riferimento, ma più lontano dagli ingressi sulla strada.

Area

Informazioni sull'area e sulla sua relazione con la località target.

Le aree includono frazioni precise, quartieri e complessi di grandi dimensioni utili per descrivere una località.

Rappresentazione JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Campi
name

string

Il nome della risorsa dell'area.
placeId

string

L'ID posizione dell'area.
displayName

object (LocalizedText)

Il nome visualizzato dell'area.
containment

enum (Containment)

Definisce la relazione spaziale tra la località di destinazione e l'area.

Contenimento

Definisce la relazione spaziale tra la località di destinazione e l'area.

Enum
CONTAINMENT_UNSPECIFIED Il contenimento non è specificato.
WITHIN La località di destinazione si trova all'interno della regione dell'area, vicino al centro.
OUTSKIRTS La località target si trova all'interno della regione dell'area, vicino al bordo.
NEAR La località di destinazione si trova al di fuori della regione dell'area, ma nelle vicinanze.

PriceRange

La fascia di prezzo associata a un luogo. endPrice potrebbe non essere impostato, il che indica un intervallo senza limite superiore (ad es. "Più di 100 $").

Rappresentazione JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Campi
startPrice

object (Money)

La fascia di prezzo più bassa (inclusa). Il prezzo deve essere uguale o superiore a questo importo.
endPrice

object (Money)

La fascia di prezzo più alta (esclusiva). Il prezzo deve essere inferiore a questo importo.

Metodi

autocomplete

 Restituisce le previsioni per l'input specificato.

get

 Visualizza i dettagli di un luogo in base al nome della risorsa, che è una stringa nel formato places/{place_id}.

searchNearby

 Cerca luoghi nelle vicinanze di una località.

searchText

 Ricerca di luoghi basata su query di testo.