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

string

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

string

O identificador exclusivo de um local.
displayName

object (LocalizedText)

O nome localizado do lugar, adequado como uma breve descrição legível. Por exemplo, "Google São Paulo", "Starbucks", "Pyrmont" etc.
types[]

string

Um conjunto de tags de tipo para este resultado. Por exemplo, "político" e "região administrativa". Para conferir 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. Esse tipo 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 conferir 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 no idioma da solicitação, se aplicável. Para conferir 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 para o local, em formato nacional.
internationalPhoneNumber

string

Um número de telefone legível para o local, em formato internacional.
formattedAddress

string

Um endereço completo e legível do lugar.
shortFormattedAddress

string

Um endereço curto e legível para este lugar.
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 que o 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 permanecerá o mesmo entre as solicitações. Especificamente, o número de addressComponents varia de acordo com o endereço solicitado e pode mudar ao longo do tempo 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 local 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 para este lugar.
googleMapsUri

string

Um URL com mais informações sobre este lugar.
websiteUri

string

O site oficial do lugar, por exemplo, de uma empresa" página inicial. Para locais que fazem parte de uma rede (por exemplo, uma loja IKEA), este geralmente será o website da loja individual, não a rede geral.
reviews[]

object (Review)

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

object (OpeningHours)

O horário de funcionamento normal.
photos[]

object (Photo)

Informações (incluindo referências) sobre fotos deste lugar. É possível devolver 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 precisa ser mostrado com esse resultado.
iconMaskBaseUri

string

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

string

Cor de fundo de 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 da data da solicitação e termina às 23h59 seis dias depois. Esse campo inclui o subcampo specialDays de todos os horários, 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 de funcionamento principal de uma empresa. Por exemplo, um restaurante pode especificar o horário de funcionamento de drive-thru ou de entrega como horário secundário. Esse campo preenche o subcampo type, que se baseia em uma lista predefinida de tipos de horário de funcionamento (como DRIVE_THROUGH, PICKUP ou TakeOUT) com base nos tipos de local. Esse campo inclui o subcampo specialDays de todos os horários, 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 de uma empresa. O horário de funcionamento secundário é diferente do horário de funcionamento principal de uma empresa. Por exemplo, um restaurante pode especificar o horário de funcionamento de drive-thru ou de entrega como horário secundário. Esse campo preenche o subcampo type, que se baseia em uma lista predefinida de tipos de horário de funcionamento (como DRIVE_THROUGH, 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 do idioma, se aplicável. O texto de resumo precisa ser apresentado como está 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.
generativeSummary

object (GenerativeSummary)

Experimental: consulte https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para ver mais detalhes.

Resumo do lugar gerado por IA.
areaSummary

object (AreaSummary)

Experimental: consulte https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para ver mais detalhes.

Resumo gerado por IA da área em que o lugar está.
utcOffsetMinutes

integer

Número de minutos de diferença entre o fuso horário deste lugar e o UTC. Isso é expresso em minutos para suportar 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 esse lugar.
takeout

boolean

Especifica se a empresa oferece suporte para retirada de dados.
delivery

boolean

Especifica se a empresa oferece suporte ao envio.
dineIn

boolean

Especifica se a empresa oferece opções de assentos internos ou externos.
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 local serve jantar.
servesBeer

boolean

Especifica se o local serve cerveja.
servesWine

boolean

Especifica se o local serve vinho.
servesBrunch

boolean

Especifica se o lugar serve brunch.
servesVegetarianFood

boolean

Especifica se o lugar serve comida vegetariana.
outdoorSeating

boolean

O lugar tem mesas ao ar livre.
liveMusic

boolean

O local tem música ao vivo.
menuForChildren

boolean

O lugar tem cardápio infantil.
servesCocktails

boolean

Local que serve coquetéis.
servesDessert

boolean

O lugar serve sobremesa.
servesCoffee

boolean

O local serve café.
goodForChildren

boolean

O lugar é bom para crianças.
allowsDogs

boolean

O lugar permite cachorros.
restroom

boolean

O lugar tem banheiro.
goodForGroups

boolean

O lugar acomoda grupos.
goodForWatchingSports

boolean

Lugar adequado para assistir esportes.
accessibilityOptions

object (AccessibilityOptions)

Informações sobre as opções de acessibilidade oferecidas por um lugar.

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 "sr-Latn".

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 essas informações estiverem disponíveis.

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 o long_name "Austrália".
shortText

string

Um nome abreviado, no formato de texto, para o componente de endereço, se disponível. Por exemplo, um componente de endereço para o país Austrália pode ter o nome abreviado "AU".
types[]

string

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

string

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

PlusCode

O Plus Code (http://plus.codes) é uma referência de local com dois formatos: o código global que define um 14mx14m (1/8.000 de grau) ou um retângulo menor e o código composto, substituindo 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", representando uma área de 1/8.000 por 1/8.000 grau (aproximadamente 14 por 14 metros).
compoundCode

string

O código composto do lugar, como "33GV+HQ, Ramberg, Noruega", contendo o sufixo do código global e substituir 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. Salvo indicação em contrário, 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 diagonalmente opostos low e high. Uma janela de visualização é considerada uma região fechada, ou seja, inclui seus limites. Os limites de latitude devem variar entre -90 e 90 graus, e os limites de longitude devem variar entre -180 e 180 graus. Os vários casos incluem:

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

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

  • 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 está vazio.

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

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

Por exemplo, esta janela de visualização abrange totalmente 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 baixo da janela de visualização.
high

object (LatLng)

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

Revisã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

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

string

É uma string de horário recente formatada para expressar o horário da 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 RFC3339 UTC "Zulu", 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 da Review.
uri

string

URI do autor da Photo ou da Review.
photoUri

string

URI da foto do perfil do autor da Photo ou da 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 esse lugar fica aberto durante a semana. Os períodos estão em ordem cronológica, começando com o domingo no fuso horário local-local. Um valor vazio (mas não ausente) indica um lugar que nunca fica aberto, por exemplo, porque está temporariamente fechado para reformas.
weekdayDescriptions[]

string

Strings localizadas que descrevem o horário de funcionamento do lugar, uma para cada dia da semana. Será vazio se os horários forem desconhecidos ou não puderem ser convertidos em texto localizado. Exemplo: "Dom: 18h às 06h"
secondaryHoursType

enum (SecondaryHoursType)

Um tipo de string usado 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, Dia de Natal. Definido como currentOpeningHours e currentsecondaryOpeningHours se o horário for excepcional.
openNow

boolean

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

Período

Um período em que o lugar permanece no status openNow.

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

object (Point)

O horário em que o lugar começa a estar aberto.
close

object (Point)

O horário em que o lugar começa a estar fechado.

Ponto

Pontos de mudança do 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 este endpoint foi truncado ou não. O truncamento ocorre quando o horário real está fora do intervalo entre os quais estamos dispostos a retornar. Por isso, truncamos as horas com esses 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 com 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 um ano zero (por exemplo, uma data comemorativa);
  • um ano sozinho, com um mês zero e um dia zero;
  • um ano e 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 de drive-through de bancos, restaurantes ou farmácias.
HAPPY_HOUR O happy hour.
DELIVERY O horário de entrega.
TAKEOUT O horário da retirada de dados.
KITCHEN A hora da cozinha.
BREAKFAST A hora do café da manhã.
LUNCH A hora do almoço.
DINNER A hora do jantar.
BRUNCH A hora do brunch.
PICKUP O horário de retirada.
ACCESS As horas de acesso aos locais de armazenamento.
SENIOR_HOURS O horário de funcionamento especial para idosos.
ONLINE_SERVICE_HOURS O horário de atendimento 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, Dia de Natal.

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

object (Date)

A data deste 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. Uma referência que representa a foto desse lugar e que pode ser usada para procurar a foto do lugar novamente (também chamada de nome do "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)

Os 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á em funcionamento, 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 local oferece serviços baratos.
PRICE_LEVEL_MODERATE O lugar oferece serviços com preço moderado.
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 os provedores de dados deste lugar.

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

string

Nome do provedor de dados do local.
providerUri

string

URI para o provedor de dados do local.

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 só aceita dinheiro como pagamento. Locais 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 aceitar 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

Estacionamento gratuito.
paidParkingLot

boolean

O local tem estacionamento pago.
freeStreetParking

boolean

O local oferece estacionamento gratuito na rua.
paidStreetParking

boolean

O local oferece estacionamento público pago.
valetParking

boolean

O local oferece estacionamento com manobrista.
freeGarageParking

boolean

Estacionamento coberto sem custo financeiro.
paidGarageParking

boolean

Estacionamento coberto pago.

SubDestination

Insira o nome do recurso e o ID dos subdestinos relacionados ao lugar. Por exemplo, terminais diferentes 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 do lugar do subdestino.

AccessibilityOptions

Informações sobre as opções de acessibilidade oferecidas por um lugar.

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

boolean

Estacionamento acessível a pessoas em cadeira de rodas.
wheelchairAccessibleEntrance

boolean

Os lugares têm entrada acessível a pessoas em cadeira de rodas.
wheelchairAccessibleRestroom

boolean

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

boolean

O local tem assento com acessibilidade para 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 conhecido para cada tipo de combustível que este posto tem. Há uma entrada por tipo de combustível no posto. A ordem não é importante.

FuelPrice

Informações sobre preços de combustíveis 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 RFC3339 UTC "Zulu", 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 Regular sem lead.
MIDGRADE Grau intermediário.
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 Caminhão a diesel.

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 equivalerá 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 precisará 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 segue 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ó conseguem carregar um carro por vez (por exemplo, o número de conectores pode ser maior do que o total de carros que podem carregar simultaneamente).
connectorAggregation[]

object (ConnectorAggregation)

Uma lista de agregações do conector de carregamento de VE que contêm conectores do mesmo tipo e taxa de carregamento.

ConnectorAggregation

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

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áximo estático 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 nesta agregação foram atualizadas pela última vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", 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 disponíveis nesta agregação que estão disponíveis no momento.
outOfServiceCount

integer

Número de conectores nesta agregação que estão atualmente fora de serviço.

EVConnectorType

Consulte http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 para conferir mais informações e 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. Muitas vezes chamadas 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 na 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. É o NACS da América do Norte, mas pode não ser NACS em outras partes do mundo (por exemplo, CCS Combo 2 (CCS2) ou GB/T). Esse valor é menos representativo de um tipo de conector real e mais representa 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 de GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Tomada não especificada.

GenerativeSummary

Experimental: consulte https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para ver mais detalhes.

Resumo do lugar gerado por IA.

Representação JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Campos
overview

object (LocalizedText)

A visão geral do lugar.
description

object (LocalizedText)

A descrição detalhada do lugar.
references

object (References)

Referências usadas para gerar a descrição resumida.

Referências

Experimental: consulte https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para ver mais detalhes.

Referência a que o conteúdo generativo está relacionado.

Representação JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Campos
reviews[]

object (Review)

Avaliações que servem como referências.
places[]

string

A lista de nomes de recursos dos lugares referenciados. Esse nome pode ser usado em outras APIs que aceitam nomes de recursos de lugar.

AreaSummary

Experimental: consulte https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para ver mais detalhes.

Resumo gerado por IA da área em que o lugar está.

Representação JSON 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}
Campos
contentBlocks[]

object (ContentBlock)

Blocos de conteúdo que compõem o resumo da área. Cada bloco tem um tópico separado sobre a área.

ContentBlock

Um bloco de conteúdo que pode ser veiculado individualmente.

Representação JSON 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Campos
topic

string

O tópico do conteúdo, por exemplo, "visão geral" ou "restaurante".
content

object (LocalizedText)

Conteúdo relacionado ao tema.
references

object (References)

Experimental: consulte https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para ver mais detalhes.

Referências relacionadas a este bloco de conteúdo.

Métodos

autocomplete

 Retorna previsões para a entrada especificada.

get

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

searchNearby

 Pesquise lugares próximos.

searchText

 Pesquisa de local baseada em consulta de texto.