REST Resource: places

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

string

Il nome della risorsa di questo luogo, in formato places/{placeId}. Consente di cercare il luogo.

string

L'identificatore univoco di un luogo.

object (LocalizedText)

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

string

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

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 principale. Per l'elenco completo dei possibili valori, consulta la tabella A e la tabella B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types

object (LocalizedText)

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

string

Un numero di telefono leggibile del luogo in formato nazionale.

string

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

string

Un indirizzo completo leggibile di questo luogo.

string

Un indirizzo breve e leggibile per questo luogo.

object (AddressComponent)

Componenti ripetuti per ogni livello di località. Nota le seguenti informazioni sull'array addresscomponents[]: - L'array di componenti 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 nell'elemento 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 le richieste. 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 la posizione nell'array. Il tipo di componente può cambiare. In una risposta successiva potrebbe mancare un componente specifico.

object (PlusCode)

Plus Code della latitudine/longitudine della posizione del luogo.

object (LatLng)

La posizione di questo luogo.

object (Viewport)

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

number

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

string

Un URL che fornisce ulteriori informazioni su questo luogo.

string

Il sito web autorevole del 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), di solito si tratta del sito web del singolo negozio, non dell'intera catena.

object (Review)

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

object (OpeningHours)

I normali orari di apertura.

object (Photo)

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

string

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

enum (BusinessStatus)

Lo stato dell'attività per il luogo.

enum (PriceLevel)

Livello dei prezzi del luogo.

object (Attribution)

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

string

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

string

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

object (OpeningHours)

Gli orari di apertura per i prossimi sette giorni (incluso oggi). Il periodo di tempo inizia a mezzanotte del giorno della richiesta e termina alle 23:59 di sei giorni dopo. Questo campo include il campo secondario specialDays di tutti gli orari, impostato per date con orari eccezionali.

object (OpeningHours)

Contiene un array di voci per i sette giorni successivi, comprese le informazioni sugli orari secondari di un'attività. Gli orari secondari sono diversi da quelli principali dell'attività. Ad esempio, un ristorante può specificare come orario secondario l'orario del drive-through o l'orario di consegna. Questo campo compila il sottocampo del tipo, che viene ricavato da un elenco predefinito dei tipi di orari di apertura (ad esempio Drive_THROUGH, PICKUP o TAKEOUT) in base alla tipologia di luogo. Questo campo include il campo secondario specialDays di tutti gli orari, impostato per date con orari eccezionali.

object (OpeningHours)

Contiene un array di voci relative a informazioni sui normali orari secondari di un'attività. Gli orari secondari sono diversi da quelli principali dell'attività. Ad esempio, un ristorante può specificare come orario secondario l'orario del drive-through o l'orario di consegna. Questo campo compila il sottocampo del tipo, che viene ricavato da un elenco predefinito dei tipi di orari di apertura (ad esempio Drive_THROUGH, PICKUP o TAKEOUT) in base alla tipologia di luogo.

object (LocalizedText)

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

object (PaymentOptions)

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

object (ParkingOptions)

Opzioni di parcheggio offerte dal luogo.

object (SubDestination)

Un elenco di destinazioni secondarie correlate a questo luogo.

object (FuelOptions)

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

object (EVChargeOptions)

Informazioni sulle opzioni di ricarica ev.

integer

Numero di minuti in cui il fuso orario di questo luogo è attualmente diverso da UTC. Questo valore è espresso in minuti per supportare i fusi orari compensati da frazioni di ora, ad esempio X ore e 15 minuti.

integer

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

boolean

Specifica se l'attività supporta l'asporto.

boolean

Specifica se l'attività supporta la consegna.

boolean

Specifica se l'attività supporta tavoli all'interno o all'esterno.

boolean

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

boolean

Specifica se il luogo supporta le prenotazioni.

boolean

Specifica se il luogo serve la colazione.

boolean

Specifica se il luogo serve il pranzo.

boolean

Specifica se il luogo serve la cena.

boolean

Specifica se questo luogo serve birra.

boolean

Specifica se il luogo serve vino.

boolean

Specifica se il luogo serve il brunch.

boolean

Specifica se il ristorante serve cibo vegetariano.

boolean

Questo locale dispone di tavoli all'aperto.

boolean

Questo luogo offre musica dal vivo.

boolean

Locale con menu per bambini.

boolean

Locale che serve cocktail.

boolean

Locale che serve dessert.

boolean

Questo posto serve caffè.

boolean

Luogo adatto ai bambini.

boolean

In questo luogo sono ammessi i cani.

boolean

Questa struttura dispone di bagno.

boolean

Questo luogo può ospitare gruppi.

boolean

Luogo adatto per guardare sport.

object (AccessibilityOptions)

Informazioni sulle opzioni di accessibilità offerte da un luogo.

{
  "text": string,
  "languageCode": string
}

string

Stringa localizzata nella lingua corrispondente a languageCode di seguito.

string

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

Per ulteriori informazioni, vedi http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

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

string

La descrizione testuale o il nome completo del componente indirizzo. Ad esempio, un componente dell'indirizzo per il paese Australia potrebbe avere "Australia" nel campo long_name.

string

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

string

Un array che indica i tipi del componente indirizzo.

string

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

{
  "globalCode": string,
  "compoundCode": string
}

string

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

string

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.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

obbligatorio. Il punto basso dell'area visibile.

object (LatLng)

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

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

string

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

string

Una stringa formattata con l'ora recente, che esprime la data e l'ora della revisione relative all'ora corrente in un formato appropriato per la lingua e il paese.

object (LocalizedText)

Il testo localizzato della recensione.

object (LocalizedText)

Il testo della recensione nella lingua originale.

number

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

object (AuthorAttribution)

L'autore di questa recensione.

string (Timestamp format)

Timestamp della revisione.

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

{
  "displayName": string,
  "uri": string,
  "photoUri": string
}

string

Nome dell'autore di Photo o Review.

string

URI dell'autore di Photo o Review.

string

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

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

object (Period)

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

string

Stringhe localizzate che descrivono gli orari di apertura di questo luogo, una stringa per ogni giorno della settimana. Il campo sarà vuoto se l'orario non è noto o se non è possibile convertirlo in testo localizzato. Esempio: "Dom: 18:00–06:00"

enum (SecondaryHoursType)

Una stringa di tipo utilizzata per identificare il tipo di orario secondario.

object (SpecialDay)

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

boolean

Questo luogo è aperto adesso? Sempre presente, a meno che non ci siano dati relativi all'ora del giorno o al fuso orario di questi orari di apertura.

{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}

object (Point)

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

object (Point)

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

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

object (Date)

Data nel fuso orario locale del luogo.

boolean

Indica se questo endpoint è stato troncato o meno. Il troncamento si verifica quando le ore reali non rientrano nei tempi in cui siamo disposti a restituire ore, quindi tronchiamo le ore tornando a questi limiti. In questo modo, verranno restituite al massimo 24 * 7 ore dalla mezzanotte del giorno della richiesta.

integer

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

integer

L'ora in due cifre. L'intervallo è compreso tra 00 e 23.

integer

Il minuto in due cifre. L'intervallo è compreso tra 00 e 59.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

integer

Mese di un anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese.

integer

Giorno di un mese. Il valore deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno e un mese in cui il giorno non sia significativo.

{
  "date": {
    object (Date)
  }
}

object (Date)

La data di questo giorno speciale.

{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}

string

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

integer

La larghezza massima disponibile, in pixel.

integer

L'altezza massima disponibile, in pixel.

object (AuthorAttribution)

Gli autori di questa foto.

{
  "provider": string,
  "providerUri": string
}

string

Nome del fornitore di dati del luogo.

string

URI del fornitore di dati di Place.

{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}

boolean

Questo luogo accetta le carte di credito come metodo di pagamento.

boolean

Questo luogo accetta le carte di debito come pagamento.

boolean

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

boolean

Place accetta pagamenti NFC.

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

boolean

Questo hotel dispone di parcheggi gratuiti.

boolean

Questo luogo offre parcheggi a pagamento.

boolean

Il parcheggio in strada è incluso nel prezzo.

boolean

Questo luogo offre parcheggio in strada a pagamento.

boolean

Offre anche il servizio di parcheggio.

boolean

Offre anche il parcheggio in garage incluso nel prezzo.

boolean

Questo luogo offre il parcheggio in garage a pagamento.

{
  "name": string,
  "id": string
}

string

Il nome della risorsa della destinazione secondaria.

string

L'ID luogo della destinazione secondaria.

{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}

boolean

Questo luogo offre un parcheggio accessibile in sedia a rotelle.

boolean

Places dispone di ingresso accessibile in sedia a rotelle.

boolean

Questa struttura dispone di bagno accessibile in sedia a rotelle.

boolean

Questa struttura dispone di tavoli accessibili in sedia a rotelle.

{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}

object (FuelPrice)

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

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

enum (FuelType)

Il tipo di carburante.

object (Money)

Il prezzo del carburante.

string (Timestamp format)

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

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Il codice valuta di tre lettere definito nello standard ISO 4217.

string (int64 format)

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

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 un numero positivo o zero. Se units è zero, nanos può essere un numero positivo, zero o negativo. Se units è negativo, nanos deve essere negativo o pari a zero. Ad esempio $-1,75 è rappresentato come units=-1 e nanos=-750.000.000.

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

integer

Numero di connettori in questa stazione. Tuttavia, poiché alcune porte possono avere più connettori ma possono caricare solo un'auto alla volta (ad es.), il numero di connettori potrebbe essere maggiore del numero totale di auto che possono essere caricate contemporaneamente.

object (ConnectorAggregation)

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

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

enum (EVConnectorType)

Il tipo di connettore di questa aggregazione.

number

La velocità di ricarica massima statica in kW di ciascun connettore nell'aggregazione.

integer

Numero di connettori in questa aggregazione.

string (Timestamp format)

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

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

integer

Numero di connettori attualmente disponibili in questa aggregazione.

integer

Numero di connettori in questa aggregazione che attualmente sono fuori servizio.