REST Resource: places

Recurso: Place

Todas as informações que representam um lugar.

Representação 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)
  },
  "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)
  }
}
Campos
name

string

O nome do recurso deste lugar, no formato places/{placeId}. Pode ser usado para procurar o lugar.

id

string

Identificador exclusivo de um lugar.

displayName

object (LocalizedText)

O nome localizado do local, adequado como uma breve descrição legível por humanos. Por exemplo, "Google Sydney", "Starbucks", "Pyrmont" etc.

types[]

string

Um conjunto de tags de tipo para este resultado. Por exemplo, "político" e "região administrativa". Para ver a lista completa de valores possíveis, consulte as Tabelas A e B em https://developers.google.com/maps/documentation/places/web-service/place-types

primaryType

string

O tipo principal do resultado fornecido. Precisa ser um dos tipos compatíveis com a API Places. Por exemplo, "restaurante", "café", "aeroporto" etc. Um lugar só pode ter um tipo principal. Para ver a lista completa de valores possíveis, consulte as Tabelas A e B em https://developers.google.com/maps/documentation/places/web-service/place-types

primaryTypeDisplayName

object (LocalizedText)

O nome de exibição do tipo principal, localizado para o idioma da solicitação, se aplicável. Para ver a lista completa de valores possíveis, consulte as Tabelas A e B em https://developers.google.com/maps/documentation/places/web-service/place-types

nationalPhoneNumber

string

Um número de telefone legível do local, em formato nacional.

internationalPhoneNumber

string

Um número de telefone legível do lugar, em formato internacional.

formattedAddress

string

Um endereço completo legível por humanos para este lugar.

shortFormattedAddress

string

Um endereço curto e legível deste local.

addressComponents[]

object (AddressComponent)

Componentes repetidos para cada nível de localidade. Observe os seguintes fatos sobre a matriz addressComponents[]: a matriz de componentes de endereço pode conter mais componentes do que formattedAddress. - A matriz não inclui necessariamente todas as entidades políticas que contêm um endereço, além daquelas incluídas em formattedAddress. Para recuperar todas as entidades políticas que contêm um endereço específico, use a geocodificação inversa, transmitindo a latitude/longitude do endereço como um parâmetro para a solicitação. - Não há garantia de que o formato da resposta será o mesmo entre as solicitações. Especificamente, o número de addressComponents varia de acordo com o endereço solicitado e pode mudar para o mesmo endereço. Um componente pode mudar a posição na matriz. O tipo do componente pode mudar. Um componente específico pode estar ausente em uma resposta posterior.

plusCode

object (PlusCode)

Plus Code da latitude/longitude do local do lugar.

location

object (LatLng)

A posição deste lugar.

viewport

object (Viewport)

Uma janela de visualização adequada para exibir o lugar em um mapa de tamanho médio.

rating

number

Uma classificação entre 1,0 e 5,0, com base nas avaliações dos usuários sobre este lugar.

googleMapsUri

string

Um URL com mais informações sobre esse lugar.

websiteUri

string

O site oficial do lugar (por exemplo, a página inicial de uma empresa). Para lugares que fazem parte de uma rede (por exemplo, uma loja da IKEA), geralmente é o site da loja específica, não da rede geral.

reviews[]

object (Review)

Lista de avaliações sobre esse lugar, classificadas por relevância. É possível retornar até 5 avaliações.

regularOpeningHours

object (OpeningHours)

O horário de funcionamento normal.

photos[]

object (Photo)

Informações (incluindo referências) sobre fotos deste lugar. Podem ser retornadas no máximo 10 fotos.

adrFormatAddress

string

O endereço do local no microformato adr: http://microformats.org/wiki/adr.

businessStatus

enum (BusinessStatus)

O status da empresa do lugar.

priceLevel

enum (PriceLevel)

Nível de preço do lugar.

attributions[]

object (Attribution)

Um conjunto de provedor de dados que deve ser exibido com esse resultado.

iconMaskBaseUri

string

Um URL truncado para uma máscara de ícones. O usuário pode acessar outros tipos de ícone anexando o sufixo do tipo no final (por exemplo, ".svg" ou ".png").

iconBackgroundColor

string

Cor de fundo para icon_mask no formato hexadecimal, por exemplo, #909CE1.

currentOpeningHours

object (OpeningHours)

O horário de funcionamento dos próximos sete dias (incluindo hoje). O período começa à meia-noite na data da solicitação e termina às 23h59, seis dias depois. Esse campo inclui o subcampo "specialDays" de todos os horários de funcionamento, definido para datas com horários de funcionamento excepcionais.

currentSecondaryOpeningHours[]

object (OpeningHours)

Contém uma matriz de entradas para os próximos sete dias, incluindo informações sobre o horário de funcionamento secundário de uma empresa. O horário de funcionamento secundário é diferente do horário principal de uma empresa. Por exemplo, um restaurante pode especificar os horários de funcionamento de drive-thru ou de entrega como horários secundários. Esse campo preenche o subcampo "Type", que é baseado em uma lista predefinida de tipos de horário de funcionamento (como DRIVE_GOAL, PICKUP ou TakeOUT) com base nos tipos de local. Esse campo inclui o subcampo "specialDays" de todos os horários de funcionamento, definido para datas com horários de funcionamento excepcionais.

regularSecondaryOpeningHours[]

object (OpeningHours)

Contém uma matriz de entradas para informações sobre o horário de funcionamento secundário regular de uma empresa. O horário de funcionamento secundário é diferente do horário principal de uma empresa. Por exemplo, um restaurante pode especificar os horários de funcionamento de drive-thru ou de entrega como horários secundários. Esse campo preenche o subcampo "Type", que é baseado em uma lista predefinida de tipos de horário de funcionamento (como DRIVE_GOAL, PICKUP ou TakeOUT) com base nos tipos de local.

editorialSummary

object (LocalizedText)

Contém um resumo do lugar. Um resumo é composto por uma visão geral textual e também inclui o código de idioma delas, se aplicável. O texto de resumo precisa ser apresentado no estado em que se encontra e não pode ser modificado ou alterado.

paymentOptions

object (PaymentOptions)

Opções de pagamento aceitas pelo lugar. Se os dados de uma opção de pagamento não estiverem disponíveis, o campo de opção de pagamento não será definido.

parkingOptions

object (ParkingOptions)

Opções de estacionamento oferecidas pelo lugar.

subDestinations[]

object (SubDestination)

Uma lista de subdestinos relacionados ao lugar.

fuelOptions

object (FuelOptions)

As informações mais recentes sobre as opções de combustível em um posto de gasolina. Essas informações são atualizadas regularmente.

evChargeOptions

object (EVChargeOptions)

Informações sobre as opções de carregamento de VE.

utcOffsetMinutes

integer

Número de minutos em que o fuso horário desse lugar está diferente do UTC. Esse valor é expresso em minutos para aceitar fusos horários que são deslocados por frações de uma hora, por exemplo, X horas e 15 minutos.

userRatingCount

integer

O número total de avaliações (com ou sem texto) para este lugar.

takeout

boolean

Especifica se a empresa oferece suporte para retirada.

delivery

boolean

Especifica se a empresa aceita entregas.

dineIn

boolean

Especifica se a empresa oferece opções de mesas internas ou externas.

curbsidePickup

boolean

Especifica se a empresa oferece drive-thru.

reservable

boolean

Especifica se o lugar aceita reservas.

servesBreakfast

boolean

Especifica se o local serve café da manhã.

servesLunch

boolean

Especifica se o lugar serve almoço.

servesDinner

boolean

Especifica se o lugar serve jantar.

servesBeer

boolean

Especifica se o lugar serve cerveja.

servesWine

boolean

Especifica se o lugar serve vinho.

servesBrunch

boolean

Especifica se o lugar serve brunch.

servesVegetarianFood

boolean

Especifica se o lugar serve comida vegetariana.

outdoorSeating

boolean

O lugar oferece mesas ao ar livre.

liveMusic

boolean

O local oferece música ao vivo.

menuForChildren

boolean

O lugar tem um menu infantil.

servesCocktails

boolean

O local serve coquetéis.

servesDessert

boolean

O lugar serve sobremesa.

servesCoffee

boolean

O lugar serve café.

goodForChildren

boolean

O lugar é bom para crianças.

allowsDogs

boolean

O lugar aceita cães.

restroom

boolean

O lugar tem banheiro.

goodForGroups

boolean

O lugar acomoda grupos.

goodForWatchingSports

boolean

O local é adequado para assistir a esportes.

accessibilityOptions

object (AccessibilityOptions)

Informações sobre as opções de acessibilidade que um lugar oferece.

LocalizedText

Variante localizada de um texto em um idioma específico.

Representação JSON
{
  "text": string,
  "languageCode": string
}
Campos
text

string

String localizada no idioma correspondente a languageCode abaixo.

languageCode

string

O código de idioma BCP-47 do texto, como "pt-BR" ou "en-US".

Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

AddressComponent

Os componentes estruturados que formam o endereço formatado, se essa informação estiver disponível.

Representação JSON
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Campos
longText

string

A descrição completa em texto ou o nome do componente de endereço. Por exemplo, um componente de endereço para o país Austrália pode ter um long_name igual a "Austrália".

shortText

string

Um nome abreviado, no formato de texto, para o componente de endereço, se estiver disponível. Por exemplo, um componente de endereço da Austrália pode ter o nome curto "AU".

types[]

string

Uma matriz que indica os tipos do componente de endereço.

languageCode

string

A linguagem usada para formatar os componentes, em notação CLDR.

PlusCode

O Plus Code (http://plus.codes) é uma referência de local com dois formatos: código global que define um 14mx14m (1/8000o de grau) ou retângulo menor e código composto, que substitui o prefixo por um local de referência.

Representação JSON
{
  "globalCode": string,
  "compoundCode": string
}
Campos
globalCode

string

O código global (completo) do lugar, como "9FWM33GV+HQ", que representa uma área de 1/8.000 por 1/8.000 graus (aproximadamente 14 por 14 metros).

compoundCode

string

O código composto do lugar, como "33GV+HQ, Ramberg, Noruega", que contém o sufixo do código global e substitui o prefixo por um nome formatado de uma entidade de referência.

LatLng

Um objeto que representa um par de latitude/longitude. Ele é expresso como um par de valores duplos para representar graus de latitude e longitude. A menos que especificado de outra forma, esse objeto precisa estar em conformidade com o padrão WGS84. Os valores precisam estar dentro de intervalos normalizados.

Representação JSON
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].

longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

Janela de visualização

Uma janela de visualização de latitude e longitude, representada como dois pontos low e high diagonalmente opostos. Uma janela de visualização é considerada uma região fechada, ou seja, inclui seu limite. Os limites de latitude devem variar de -90 a 90 graus, inclusive, e os limites de longitude devem variar de -180 a 180 graus. Vários casos incluem:

  • Se low = high, a janela de visualização consiste nesse único ponto.

  • Se low.longitude > high.longitude, o intervalo de longitude será invertido (a janela de visualização cruza a linha de longitude de 180 graus).

  • Se low.longitude = -180 graus e high.longitude = 180 graus, a janela de visualização incluirá todas as longitudes.

  • Se low.longitude = 180 graus e high.longitude = -180 graus, o intervalo de longitude ficará vazio.

  • Se low.latitude > high.latitude, o intervalo de latitude estará vazio.

low e high precisam ser preenchidos, e a caixa representada não pode estar vazia (conforme especificado pelas definições acima). Uma janela de visualização vazia vai resultar em erro.

Por exemplo, esta janela de visualização abrange totalmente a cidade de Nova York:

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

Representação JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campos
low

object (LatLng)

Obrigatório. O ponto inferior da janela de visualização.

high

object (LatLng)

Obrigatório. O ponto alto da janela de visualização.

Avaliação

Informações sobre a avaliação de um lugar.

Representação JSON
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
Campos
name

string

Referência que representa essa avaliação de lugar que pode ser usada para procurar essa avaliação novamente (também chamada de nome de "recurso" da API: places/{placeId}/reviews/{review}).

relativePublishTimeDescription

string

É uma string de horário recente formatado, expressando o tempo de revisão em relação ao horário atual em um formato adequado para o idioma e o país.

text

object (LocalizedText)

O texto localizado da avaliação.

originalText

object (LocalizedText)

O texto da avaliação no idioma original.

rating

number

Um número entre 1,0 e 5,0, também chamado de número de estrelas.

authorAttribution

object (AuthorAttribution)

É o autor desta avaliação.

publishTime

string (Timestamp format)

Carimbo de data/hora da avaliação.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

AuthorAttribution

Informações sobre o autor dos dados de UGC. Usado em Photo e Review.

Representação JSON
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Campos
displayName

string

Nome do autor da Photo ou Review.

uri

string

URI do autor da Photo ou Review.

photoUri

string

URI da foto do perfil do autor de Photo ou Review.

OpeningHours

Informações sobre o horário de funcionamento do lugar.

Representação JSON
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
Campos
periods[]

object (Period)

Os períodos em que o lugar fica aberto durante a semana. Os períodos estão em ordem cronológica, começando com o domingo no fuso horário do local. Um valor vazio (mas não ausente) indica um lugar que nunca está aberto, por exemplo, porque está fechado temporariamente para reformas.

weekdayDescriptions[]

string

Strings localizados que descrevem o horário de funcionamento do local, uma string para cada dia da semana. Ficará vazio se o horário for desconhecido ou não puder ser convertido em texto localizado. Exemplo: "Dom: 18:00–06:00"

secondaryHoursType

enum (SecondaryHoursType)

Uma string de tipo usada para identificar o tipo de horário de funcionamento secundário.

specialDays[]

object (SpecialDay)

Informações estruturadas para dias especiais que se enquadram no período abrangido pelo horário de funcionamento retornado. Dias especiais são aqueles que podem afetar o horário de funcionamento de um lugar, por exemplo, o Natal. Definido como currentOpeningHours e currentSecondaryOpeningHours se houver horários excepcionais.

openNow

boolean

Esse lugar está aberto agora? Sempre presente, a menos que não haja dados de hora do dia ou de fuso horário para esses horários de funcionamento.

Período

Período em que o lugar permanece no status openNow.

Representação JSON
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Campos
open

object (Point)

A hora em que o lugar começa a estar aberto.

close

object (Point)

A hora em que o lugar começa a estar fechado.

Ponto

Pontos de mudança de status.

Representação JSON
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Campos
date

object (Date)

Data no fuso horário local do lugar.

truncated

boolean

Se esse endpoint foi truncado ou não. O truncamento ocorre quando o horário real está fora do intervalo de horas entre os horários em que queremos alternar. Por isso, truncamos as horas de volta nesses limites. Isso garante que no máximo 24 * 7 horas a partir da meia-noite do dia da solicitação sejam retornadas.

day

integer

Um dia da semana, como um número inteiro no intervalo de 0 a 6. 0 é domingo, 1 é segunda-feira etc.

hour

integer

A hora em dois dígitos. Varia de 00 a 23.

minute

integer

O minuto em dois dígitos. Varia de 00 a 59.

Data

Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é referente ao calendário gregoriano. Isso pode representar uma das seguintes opções:

  • Uma data completa, com valores de ano, mês e dia diferentes de zero.
  • um mês e dia, com ano zero (por exemplo, uma data comemorativa);
  • Um ano sozinho, com um mês zero e um dia zero.
  • um ano e um mês, com um dia zero (por exemplo, uma data de validade de cartão de crédito).

Tipos relacionados:

Representação JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.

month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.

day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

SecondaryHoursType

Um tipo usado para identificar o tipo de horário de funcionamento secundário.

Enums
SECONDARY_HOURS_TYPE_UNSPECIFIED Valor padrão quando o tipo de hora secundária não é especificado.
DRIVE_THROUGH O horário do drive-thru para bancos, restaurantes ou farmácias.
HAPPY_HOUR O happy hour.
DELIVERY A hora de entrega.
TAKEOUT A hora da retirada.
KITCHEN A hora da cozinha.
BREAKFAST Hora do café da manhã.
LUNCH Hora do almoço.
DINNER A hora do jantar.
BRUNCH Hora do brunch.
PICKUP O horário de retirada.
ACCESS As horas de acesso aos lugares de armazenamento.
SENIOR_HOURS O horário de funcionamento especial para idosos.
ONLINE_SERVICE_HOURS O horário de funcionamento on-line.

SpecialDay

Informações estruturadas para dias especiais que se enquadram no período abrangido pelo horário de funcionamento retornado. Dias especiais são aqueles que podem afetar o horário de funcionamento de um lugar, por exemplo, o Natal.

Representação JSON
{
  "date": {
    object (Date)
  }
}
Campos
date

object (Date)

A data desse dia especial.

Foto

Informações sobre a foto de um lugar.

Representação JSON
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
Campos
name

string

Identificador. Referência que representa a foto desse lugar que pode ser usada para procurar essa foto novamente (também chamada de nome de "recurso" da API: places/{placeId}/photos/{photo}).

widthPx

integer

A largura máxima disponível, em pixels.

heightPx

integer

A altura máxima disponível, em pixels.

authorAttributions[]

object (AuthorAttribution)

Autores desta foto.

BusinessStatus

Status da empresa do lugar.

Enums
BUSINESS_STATUS_UNSPECIFIED Valor padrão. Esse valor não é usado.
OPERATIONAL O estabelecimento está operacional, não necessariamente aberto agora.
CLOSED_TEMPORARILY O estabelecimento está temporariamente fechado.
CLOSED_PERMANENTLY O estabelecimento está permanentemente fechado.

PriceLevel

Nível de preço do lugar.

Enums
PRICE_LEVEL_UNSPECIFIED O nível de preço do lugar não foi especificado ou é desconhecido.
PRICE_LEVEL_FREE O lugar oferece serviços sem custo financeiro.
PRICE_LEVEL_INEXPENSIVE O lugar oferece serviços baratos.
PRICE_LEVEL_MODERATE O lugar oferece serviços com preços moderados.
PRICE_LEVEL_EXPENSIVE O lugar oferece serviços caros.
PRICE_LEVEL_VERY_EXPENSIVE O lugar oferece serviços muito caros.

Atribuição

Informações sobre provedores de dados deste lugar.

Representação JSON
{
  "provider": string,
  "providerUri": string
}
Campos
provider

string

Nome do provedor de dados do lugar.

providerUri

string

URI para o provedor de dados do lugar.

PaymentOptions

Opções de pagamento aceitas pelo lugar.

Representação JSON
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Campos
acceptsCreditCards

boolean

O lugar aceita cartões de crédito como pagamento.

acceptsDebitCards

boolean

O lugar aceita cartões de débito como pagamento.

acceptsCashOnly

boolean

O lugar aceita somente dinheiro como pagamento. Os lugares com esse atributo ainda podem aceitar outras formas de pagamento.

acceptsNfc

boolean

O lugar aceita pagamentos por aproximação.

ParkingOptions

Informações sobre as opções de estacionamento do lugar. Um estacionamento pode permitir mais de uma opção ao mesmo tempo.

Representação JSON
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Campos
freeParkingLot

boolean

O lugar oferece estacionamentos sem custo financeiro.

paidParkingLot

boolean

O lugar oferece estacionamento pago.

freeStreetParking

boolean

O lugar oferece estacionamento gratuito na rua.

paidStreetParking

boolean

O lugar oferece estacionamento pago na rua.

valetParking

boolean

O lugar oferece estacionamento com manobrista.

freeGarageParking

boolean

O lugar oferece estacionamento coberto sem custo financeiro.

paidGarageParking

boolean

O lugar oferece estacionamento coberto pago.

SubDestination

Coloque o nome e o ID do recurso dos subdestinos relacionados ao lugar. Por exemplo, terminais são destinos diferentes de um aeroporto.

Representação JSON
{
  "name": string,
  "id": string
}
Campos
name

string

O nome do recurso do subdestino.

id

string

O ID de lugar do subdestino.

AccessibilityOptions

Informações sobre as opções de acessibilidade que um lugar oferece.

Representação JSON
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Campos
wheelchairAccessibleParking

boolean

O lugar oferece estacionamento acessível a pessoas em cadeira de rodas.

wheelchairAccessibleEntrance

boolean

O Places tem uma entrada acessível a pessoas em cadeira de rodas.

wheelchairAccessibleRestroom

boolean

O lugar tem banheiro acessível a pessoas em cadeira de rodas.

wheelchairAccessibleSeating

boolean

O lugar tem assento acessível a pessoas em cadeira de rodas.

FuelOptions

As informações mais recentes sobre as opções de combustível em um posto de gasolina. Essas informações são atualizadas regularmente.

Representação JSON
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Campos
fuelPrices[]

object (FuelPrice)

O último preço de cada tipo de combustível conhecido neste posto. Há uma entrada por tipo de combustível que o posto possui. A ordem não é importante.

FuelPrice

Informações sobre preços de combustível para um determinado tipo.

Representação JSON
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Campos
type

enum (FuelType)

O tipo de combustível.

price

object (Money)

O preço do combustível.

updateTime

string (Timestamp format)

A hora em que o preço do combustível foi atualizado pela última vez.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

FuelType

Tipos de combustível.

Enums
FUEL_TYPE_UNSPECIFIED Tipo de combustível não especificado.
DIESEL Diesel.
REGULAR_UNLEADED Normal sem lead.
MIDGRADE Aditivada.
PREMIUM Premium.
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 GLP.
E80 E 80.
E85 E 85.
METHANE Metano.
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Disel de caminhão.

Dinheiro

Representa um montante em dinheiro com o respectivo tipo de moeda.

Representação JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campos
currencyCode

string

O código de moeda de três letras definido no ISO 4217.

units

string (int64 format)

As unidades inteiras do montante. Por exemplo, se currencyCode for "USD", 1 unidade equivale a um dólar americano.

nanos

integer

Número de unidades nano (10^-9) do montante. É necessário que o valor fique entre -999.999.999 e +999.999.999 (inclusive os dois limites). Se units for positivo, nanos terá que ser positivo ou zero. Se units for zero, nanos poderá ser positivo, zero ou negativo. Se units for negativo, nanos precisará ser negativo ou zero. Por exemplo,US $-1,75 é representado como units=-1 e nanos=-750.000.000.

EVChargeOptions

Informações sobre o eletroposto hospedado no local. A terminologia é a seguinte: https://afdc.energy.gov/fuels/electricity_infrastructure.html (link em inglês). Uma porta pode carregar um carro por vez. Uma porta tem um ou mais conectores. Uma estação tem uma ou mais portas.

Representação JSON
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Campos
connectorCount

integer

Número de conectores nesta estação. No entanto, como algumas portas podem ter vários conectores, mas só podem carregar um carro por vez (por exemplo, o número de conectores pode ser maior do que o número total de carros que podem carregar simultaneamente.

connectorAggregation[]

object (ConnectorAggregation)

Uma lista de agregações de conectores de carregamento de VE com conectores do mesmo tipo e taxa de carregamento.

ConnectorAggregation

Informações de carregamento de VE agrupadas por [type, maxChargeRateKw]. Mostra a agregação de carga do VE de conectores que têm o mesmo tipo e taxa de carga máxima em palavras-chave.

Representação JSON
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Campos
type

enum (EVConnectorType)

O tipo de conector dessa agregação.

maxChargeRateKw

number

A taxa de carregamento máxima estática em kw de cada conector na agregação.

count

integer

Número de conectores nesta agregação.

availabilityLastUpdateTime

string (Timestamp format)

O carimbo de data/hora em que as informações de disponibilidade do conector nessa agregação foram atualizadas pela última vez.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

availableCount

integer

Número de conectores nesta agregação que estão disponíveis no momento.

outOfServiceCount

integer

Número de conectores desta agregação que estão fora de serviço no momento.

EVConnectorType

Consulte http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 para mais informações/contexto sobre os tipos de conector de carregamento de VE.

Enums
EV_CONNECTOR_TYPE_UNSPECIFIED Conector não especificado.
EV_CONNECTOR_TYPE_OTHER Outros tipos de conector.
EV_CONNECTOR_TYPE_J1772 Conector J1772 tipo 1.
EV_CONNECTOR_TYPE_TYPE_2 Conector IEC 62196 tipo 2. Também chamados de MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Conector do tipo CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Sistema de carregamento combinado (CA e CC). Com base em SAE. Conector J-1772 tipo 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Sistema de carregamento combinado (CA e CC). Baseado no conector Mennekes Tipo 2
EV_CONNECTOR_TYPE_TESLA O conector TESLA genérico. Este é o NACS na América do Norte, mas pode ser não NACS em outras partes do mundo (por exemplo, CCS Combo 2 (CCS2) ou GB/T). Esse valor é menos representativo de um tipo real de conector e representa mais a capacidade de carregar um veículo da marca Tesla em uma estação de recarga da Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T O tipo GB/T corresponde ao padrão GB/T na China. Esse tipo abrange todos os tipos GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Tomada não especificada.

Métodos

autocomplete

Retorna previsões para a entrada em questão.

get

Confira os detalhes de um local com base no nome do recurso, que é uma string no formato places/{place_id}.

searchNearby

Pesquise lugares próximos aos locais.

searchText

Pesquisa de local baseada em consulta de texto.