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)
  },
  "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)
  }
}
Campi
name

string

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 "locality". Per l'elenco completo dei valori possibili, consulta la Tabella A e la Tabella 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", "caffetteria", "aeroporto" e così via. Un luogo può avere un solo tipo di principale. Per l'elenco completo dei valori possibili, consulta la Tabella A e la Tabella 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 la Tabella A e la Tabella 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 del luogo, in formato internazionale.
formattedAddress

string

Un indirizzo completo leggibile per questo luogo.
shortFormattedAddress

string

Un breve indirizzo leggibile per questo luogo.
addressComponents[]

object (AddressComponent)

Componenti ripetuti per ogni livello di località. Tieni presenti le seguenti informazioni sull'array addressComponents[]: - L'array di componenti dell'indirizzo può contenere più componenti di formattedAddress. - L'array non include necessariamente tutte le entità politiche che contengono un indirizzo, ad eccezione di 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 lo stesso tra una richiesta e l'altra. In particolare, il numero di 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 particolare componente potrebbe mancare in una risposta successiva.
plusCode

object (PlusCode)

Plus Code della posizione del luogo latitudine/longitudine.
location

object (LatLng)

La posizione di questo luogo.
viewport

object (Viewport)

Un'area visibile adatta a mostrare il luogo su una mappa di dimensioni medie.
rating

number

Una valutazione compresa tra 1,0 e 5,0, basata sulle recensioni degli utenti di questo luogo.
googleMapsUri

string

Un URL che fornisce ulteriori informazioni su questo luogo.
websiteUri

string

Il sito web autorevole di questo luogo, ad es. un'attività commerciale" homepage. 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 dell'intera catena.
reviews[]

object (Review)

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

object (OpeningHours)

Orario di apertura regolare.
photos[]

object (Photo)

Informazioni (inclusi 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)

Livello di prezzo del luogo.
attributions[]

object (Attribution)

Un insieme di fornitore di dati che deve essere mostrato con questo risultato.
iconMaskBaseUri

string

Un URL troncato a una maschera icona. 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)

Gli orari di servizio per i prossimi sette giorni (incluso oggi). Il periodo di tempo inizia a mezzanotte della data della richiesta e termina alle 23:59 di 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, comprese informazioni sugli orari secondari di un'attività. Gli orari secondari sono diversi dall'orario principale di un'attività. Ad esempio, un ristorante può specificare gli orari di drive-through o di consegna come orari secondari. Questo campo compila il campo secondario Tipo, 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 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 dall'orario principale di un'attività. Ad esempio, un ristorante può specificare gli orari di drive-through o di consegna come orari secondari. Questo campo compila il campo secondario Tipo, 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.
editorialSummary

object (LocalizedText)

Contiene un riepilogo del luogo. Il riepilogo è composto da una panoramica testuale e include anche il relativo codice lingua, se applicabile. Il testo di riepilogo deve essere presentato così com'è e non può essere modificato o alterato.
paymentOptions

object (PaymentOptions)

Opzioni di pagamento accettate dal luogo. Se i dati relativi a un'opzione di pagamento non sono disponibili, il campo relativo all'opzione di pagamento non verrà impostato.
parkingOptions

object (ParkingOptions)

Opzioni di parcheggio offerte dal luogo.
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, consulta 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, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

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

integer

Numero di minuti rispetto al fuso orario UTC di questo luogo. Questo valore viene espresso in minuti per supportare i fusi orari sfalsati con 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 l'estrazione.
delivery

boolean

Specifica se l'attività supporta la pubblicazione.
dineIn

boolean

Specifica se l'attività supporta la possibilità di tavoli al coperto 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 nel luogo viene servita 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

Locale con tavoli all'aperto.
liveMusic

boolean

Questo luogo offre musica dal vivo.
menuForChildren

boolean

Questo luogo offre un menu per bambini.
servesCocktails

boolean

Locale che serve cocktail.
servesDessert

boolean

Locale che serve dessert.
servesCoffee

boolean

Locale che serve caffè.
goodForChildren

boolean

Questo posto è adatto ai bambini.
allowsDogs

boolean

In questo posto sono ammessi i cani.
restroom

boolean

Questo luogo dispone di bagno.
goodForGroups

boolean

Questo luogo può ospitare gruppi.
goodForWatchingSports

boolean

Questo luogo è adatto per guardare sport.
accessibilityOptions

object (AccessibilityOptions)

Informazioni sulle opzioni di accessibilità offerte da un luogo.

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 riportata di seguito.
languageCode

string

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

Per ulteriori informazioni, consulta 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 testuale completa o il nome del componente dell'indirizzo. Ad esempio, un componente indirizzo per il paese Australia potrebbe avere "Australia" come long_name.
shortText

string

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

string

Un array che indica i tipi del componente dell'indirizzo.
languageCode

string

Il linguaggio utilizzato per formattare questi componenti, in notazione CLDR.

PlusCode

Il Plus Code (http://plus.codes) è un riferimento di località con due formati: il codice globale che definisce un rettangolo di 14mx14 m 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) di Place, ad esempio "9FWM33GV + HQ", che rappresenta un'area di 1/8000 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 che sostituisce il prefisso con un nome formattato di un'entità di riferimento.

LatLng

Un oggetto che rappresenta una coppia latitudine/longitudine. Questo valore è espresso come coppia di doppi per rappresentare i gradi di latitudine e i gradi di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono essere compresi negli 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

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 diagonalmente opposti a low e high. Un'area visibile è considerata un'area chiusa, ovvero include il proprio confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi, mentre quelli di longitudine devono essere compresi tra -180 e 180 gradi inclusi. I vari casi includono:

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

  • Se low.longitude > high.longitude, l'intervallo di longitudine è invertito (l'area visibile supera 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.

È necessario compilare entrambi i campi low e high e la casella rappresentata non può essere vuota (come specificato dalle definizioni precedenti). Un'area visibile vuota genererà un errore.

Ad esempio, questa area visibile racchiude completamente New York City:

{ "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 inferiore dell'area visibile.
high

object (LatLng)

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

Rivedi

Informazioni sulla recensione di un luogo.

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

string

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

string

Una stringa formattata per l'ora recente, che esprime l'ora della revisione rispetto all'ora corrente in un formato appropriato 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 nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

AuthorAttribution

Informazioni sull'autore dei dati generati dagli utenti. In uso in Photo e Review.

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

string

Nome dell'autore della Photo o Review.
uri

string

URI dell'autore di Photo o Review.
photoUri

string

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

OpeningHours

Informazioni sull'orario di apertura del luogo.

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

object (Period)

I periodi in cui questo luogo è aperto durante la settimana. I periodi sono in ordine cronologico, a partire dalla domenica nel fuso orario locale del luogo. 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 di questo luogo, una stringa per ogni giorno della settimana. Il campo sarà vuoto se gli orari non sono noti o non possono essere convertiti in testo localizzato. Esempio: "Dom: 18:00–06:00"
secondaryHoursType

enum (SecondaryHoursType)

Stringa di tipo utilizzata per identificare il tipo di orari secondari.
specialDays[]

object (SpecialDay)

Informazioni strutturate per i giorni speciali che rientrano nel periodo compreso nell'orario di apertura restituito. I giorni speciali sono quelli che potrebbero influire sull'orario di apertura di un luogo, ad esempio Natale. Imposta il valore su currentOpeningHours e currentSecondaryOpeningHours se ci sono orari eccezionali.
openNow

boolean

Questo luogo è aperto in questo momento? Sono sempre presenti, a meno che i dati relativi all'ora del giorno o al fuso orario non siano disponibili per questi orari di apertura.

Periodo

Un periodo in cui il luogo rimane in stato openNow.

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

object (Point)

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

object (Point)

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

Punto

Punti per cambiare 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 l'endpoint è stato troncato o meno. Il troncamento si verifica quando le ore reali sono al di fuori degli orari in cui siamo disposti a ripartire, quindi le ore vengono troncate in base a questi limiti. Ciò garantisce che vengano restituite al massimo 24 * 7 ore dalla mezzanotte del giorno della richiesta.
day

integer

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

integer

L'ora in 2 cifre. È compreso tra 00 e 23.
minute

integer

Il minuto in due cifre. È compreso tra 00 e 59.

Data

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

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • Un mese e un giorno con zero anni (ad esempio, un anniversario).
  • Un anno a sé stante, con uno zero mese e uno zero-day.
  • Un anno e un mese, con zero day (ad esempio, la data di scadenza della carta di credito).

Tipi correlati:

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

integer

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

integer

Mese dell'anno. Il valore 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 deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo.

SecondaryHoursType

Tipo utilizzato per identificare il tipo di orari secondari.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Valore predefinito quando il tipo di ora secondaria non è specificato.
DRIVE_THROUGH L'ora di passaggio in auto per banche, ristoranti o farmacie.
HAPPY_HOUR L'happy hour.
DELIVERY L'ora di consegna.
TAKEOUT L'ora dell'estrazione.
KITCHEN L'ora della cucina.
BREAKFAST L'ora della colazione.
LUNCH L'ora di pranzo.
DINNER L'ora di cena.
BRUNCH L'ora del brunch.
PICKUP L'ora di ritiro.
ACCESS Gli orari di accesso ai luoghi di archiviazione.
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 compreso nell'orario di apertura restituito. I giorni speciali sono quelli che potrebbero influire sull'orario di apertura di un luogo, ad esempio 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)
    }
  ]
}
Campi
name

string

Identificatore. Un riferimento che rappresenta la foto del luogo, che può essere utilizzato per cercare di nuovo la foto del luogo (detto 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.

BusinessStatus

Stato dell'attività per il luogo.

Enum
BUSINESS_STATUS_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
OPERATIONAL Il locale è operativo, non necessariamente aperto al momento.
CLOSED_TEMPORARILY La struttura è temporaneamente chiusa.
CLOSED_PERMANENTLY La struttura è chiusa definitivamente.

PriceLevel

Livello di prezzo del luogo.

Enum
PRICE_LEVEL_UNSPECIFIED Livello di prezzo del luogo non specificato o sconosciuto.
PRICE_LEVEL_FREE Place offre servizi senza costi.
PRICE_LEVEL_INEXPENSIVE Questo luogo offre servizi economici.
PRICE_LEVEL_MODERATE Questo luogo offre servizi a prezzi moderati.
PRICE_LEVEL_EXPENSIVE Place offre servizi costosi.
PRICE_LEVEL_VERY_EXPENSIVE Place offre servizi molto costosi.

Attribuzione

Informazioni sui fornitori di dati per 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

Opzioni di pagamento accettate dal luogo.

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

boolean

Place accetta carte di credito come pagamento.
acceptsDebitCards

boolean

Place accetta carte di debito come pagamento.
acceptsCashOnly

boolean

Questo luogo accetta solo pagamenti in contanti. I luoghi con questo attributo possono 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

Questo luogo offre parcheggi gratuiti.
paidParkingLot

boolean

Questo luogo offre parcheggi a pagamento.
freeStreetParking

boolean

Questo luogo offre il parcheggio in strada senza costi.
paidStreetParking

boolean

Questo luogo offre un parcheggio in strada a pagamento.
valetParking

boolean

Questo luogo offre il servizio di ritiro e riconsegna dell'auto.
freeGarageParking

boolean

Questo hotel offre il parcheggio in garage senza costi.
paidGarageParking

boolean

Questo luogo offre il parcheggio in garage a pagamento.

SubDestination

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

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

string

Il nome della risorsa della destinazione secondaria.
id

string

L'ID luogo 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

Dispone inoltre di parcheggio accessibile in sedia a rotelle.
wheelchairAccessibleEntrance

boolean

In alcuni luoghi è possibile accedere in sedia a rotelle.
wheelchairAccessibleRestroom

boolean

Questo luogo dispone di bagno accessibile in sedia a rotelle.
wheelchairAccessibleSeating

boolean

Questo luogo dispone di tavoli 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 noto del carburante per ogni tipo di carburante presente in questa stazione. In questa stazione è presente una voce per tipo di carburante. 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)

Data e ora dell'ultimo aggiornamento del prezzo del carburante.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi 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 Diesel.
REGULAR_UNLEADED Normale senza piombo.
MIDGRADE 89 ottani.
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 di denaro con il 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à della quantità. Il valore deve essere compreso tra -999.999.999 e +999.999.999 (inclusi). 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 zero. Ad esempio -1,75 $ è rappresentato come units=-1 e nanos=-750.000.000.

EVChargeOptions

Informazioni sulla stazione di ricarica EV ospitata in loco. La terminologia segue https://afdc.energy.gov/fuels/electricity_infrastructure.html Una porta può caricare un'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 porte possono avere più connettori, ma in grado di caricare una sola auto alla volta (ad es.), il numero di connettori può essere maggiore del numero totale di auto che possono ricaricare contemporaneamente.
connectorAggregation[]

object (ConnectorAggregation)

Un elenco di aggregazioni di connettori di ricarica EV che contengono connettori dello stesso tipo e con la stessa velocità di ricarica.

ConnectorAggregation

Informazioni sulla ricarica EV raggruppate per [type, maxChargeRateKw]. Mostra l'aggregazione della carica EV dei connettori che hanno lo stesso tipo e velocità 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 velocità di ricarica massima statica in kW di ciascun connettore nell'aggregazione.
count

integer

Numero di connettori in questa aggregazione.
availabilityLastUpdateTime

string (Timestamp format)

Il timestamp dell'ultimo aggiornamento delle informazioni sulla disponibilità dei connettori in questa aggregazione.

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

integer

Numero di connettori attualmente disponibili in questa aggregazione.
outOfServiceCount

integer

Numero di connettori in questa aggregazione attualmente fuori servizio.

EVConnectorType

Visita la pagina http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 per ulteriori informazioni/contesti sui tipi di connettori di ricarica EV.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Connettore non specificato.
EV_CONNECTOR_TYPE_OTHER Altri tipi di connettori.
EV_CONNECTOR_TYPE_J1772 Connettore di tipo 1 J1772.
EV_CONNECTOR_TYPE_TYPE_2 Connettore tipo 2 IEC 62196. Chiamato anche MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO connettore di tipo CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Sistema di ricarica combinato (CA e CC). In base alla SAE. Connettore J-1772 di tipo 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Sistema di ricarica combinato (CA e CC). 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 più rappresenta la capacità di ricaricare un veicolo di marca 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 di GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Presa a muro non specificata.

GenerativeSummary

Sperimentale: per ulteriori dettagli, consulta 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)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Campi
overview

object (LocalizedText)

La panoramica del luogo.
description

object (LocalizedText)

La descrizione dettagliata del luogo.
references

object (References)

Riferimenti utilizzati per generare la descrizione di riepilogo.

Riferimenti

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

Riferimenti a cui sono correlati i contenuti generativi.

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

object (Review)

Recensioni che fungono da riferimento.
places[]

string

L'elenco dei nomi delle risorse dei luoghi di riferimento. Questo nome può essere utilizzato in altre API che accettano nomi di risorse Luogo.

AreaSummary

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

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

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

object (ContentBlock)

Blocchi di contenuti che compongono il riepilogo dell'area. Ogni blocco ha un argomento diverso sull'area.

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, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riferimenti correlati a questo blocco di contenuti.

Metodi

autocomplete

 Restituisce previsioni per l'input specificato.

get

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

searchNearby

 Cercare luoghi nelle vicinanze.

searchText

 Ricerca di luoghi basata su query di testo.