REST Resource: places

Recurso: lugar

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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
Campos
name

string

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

string

O identificador exclusivo de um lugar.
displayName

object (LocalizedText)

O nome localizado do lugar, adequado como uma descrição curta legível por humanos. Por exemplo, "Google Sydney", "Starbucks", "Pyrmont" etc.
types[]

string

Um conjunto de tags de tipo para esse resultado. Por exemplo, "político" e "localidade". 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 aceitos pela 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 para o 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 por humanos para o local, no formato nacional.
internationalPhoneNumber

string

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

string

Um endereço completo e legível para humanos.
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 do 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 vai permanecer 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. Pode faltar um componente específico em uma resposta posterior.
plusCode

object (PlusCode)

Plus Code do local (lat/long).
location

object (LatLng)

A posição do lugar.
viewport

object (Viewport)

Uma janela de visualização adequada para mostrar o lugar em um mapa de tamanho médio. Essa viewport não deve ser usada como limite físico ou área de cobertura da empresa.
rating

number

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

string

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

string

O site oficial do local, 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 individual, não da rede em geral.
reviews[]

object (Review)

Lista de avaliações sobre esse lugar, classificadas por relevância. É possível retornar no máximo cinco avaliações.
regularOpeningHours

object (OpeningHours)

O horário de funcionamento normal. Se um lugar estiver sempre aberto (24 horas), o campo close não será definido. Os clientes podem confiar que sempre aberto (24 horas) será representado como um período [open][google.foo.OpeningHours.Period.open] contendo [day][google.foo.Point.day] com valor 0, [hour][google.foo.Point.hour] com valor 0 e [minute][google.foo.Point.minute] com valor 0.
photos[]

object (Photo)

Informações (incluindo referências) sobre as fotos desse lugar. É possível retornar no máximo 10 fotos.
adrFormatAddress

string

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

enum (BusinessStatus)

O status da empresa para o 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 ícone. O usuário pode acessar diferentes tipos de ícone anexando o sufixo de tipo ao final (por exemplo, ".svg" ou ".png").
iconBackgroundColor

string

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

object (OpeningHours)

O horário de funcionamento para os 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 todas as horas, definido para datas com horários excepcionais.
currentSecondaryOpeningHours[]

object (OpeningHours)

Contém uma matriz de entradas para os próximos sete dias, incluindo informações sobre os horários secundários de uma empresa. Os horários secundários são diferentes dos principais de uma empresa. Por exemplo, um restaurante pode especificar o horário de funcionamento do drive-thru ou de entrega como horário secundário. Esse campo preenche o subcampo "type", que é extraído de uma lista predefinida de tipos de horário de funcionamento (como DRIVE_THROUGH, PICKUP ou TAKEOUT) com base nos tipos do lugar. Esse campo inclui o subcampo "specialDays" de todas as horas, definido para datas com horários excepcionais.
regularSecondaryOpeningHours[]

object (OpeningHours)

Contém uma matriz de entradas com informações sobre o horário de funcionamento normal de uma empresa. Os horários secundários são diferentes dos principais de uma empresa. Por exemplo, um restaurante pode especificar o horário de funcionamento do drive-thru ou de entrega como horário secundário. Esse campo preenche o subcampo "type", que é extraído de uma lista predefinida de tipos de horário de funcionamento (como DRIVE_THROUGH, PICKUP ou TAKEOUT) com base nos tipos do lugar.
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, se aplicável. O texto do resumo precisa ser apresentado como está e não pode ser modificado.
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 da 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 VEs.
generativeSummary

object (GenerativeSummary)

Experimental: consulte https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para 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 mais detalhes.

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

object (ContainingPlace)

Lista de lugares em que o local atual está localizado.
addressDescriptor

object (AddressDescriptor)

O descritor de endereço do lugar. Os descritores de endereço incluem informações adicionais que ajudam a descrever um local usando pontos de referência e áreas. Consulte a cobertura regional do descritor de endereço em https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
priceRange

object (PriceRange)

O intervalo de preços associado a um lugar.
utcOffsetMinutes

integer

Número de minutos de diferença entre o fuso horário do local e o UTC. Isso é expresso em minutos para oferecer suporte a fusos horários que são compensados 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 comida para viagem.
delivery

boolean

Especifica se a empresa oferece entrega.
dineIn

boolean

Especifica se a empresa oferece mesas internas ou externas.
curbsidePickup

boolean

Especifica se a empresa aceita retirada na calçada.
reservable

boolean

Especifica se o lugar aceita reservas.
servesBreakfast

boolean

Especifica se o lugar serve café da manhã.
servesLunch

boolean

Especifica se o local serve almoço.
servesDinner

boolean

Especifica se o lugar serve jantar.
servesBeer

boolean

Especifica se o local 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 tem mesas ao ar livre.
liveMusic

boolean

O lugar tem música ao vivo.
menuForChildren

boolean

O lugar tem um cardápio infantil.
servesCocktails

boolean

O lugar 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 permite cães.
restroom

boolean

O lugar tem banheiro.
goodForGroups

boolean

O local acomoda grupos.
goodForWatchingSports

boolean

O lugar é adequado para assistir esportes.
accessibilityOptions

object (AccessibilityOptions)

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

boolean

Indica se o lugar é uma empresa de serviço local. Uma empresa de serviço local é aquela que faz visitas ou entregas, mas não atende clientes no endereço comercial dela. Por exemplo, prestadores de serviços de limpeza ou encanadores. Essas empresas podem não ter um endereço físico ou local no Google Maps.

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 do endereço. Por exemplo, um componente de endereço para o país Austrália pode ter um long_name de "Austrália".
shortText

string

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

string

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

string

A linguagem usada para formatar esses componentes, na 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 retângulo de 14 m x 14 m (1/8000 de um grau) ou menor, e o 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/8000 por 1/8000 grau (aproximadamente 14 x 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 seguir 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 viewport de latitude-longitude, representada como dois pontos low e high diagonalmente opostos. Uma viewport é considerada uma região fechada, ou seja, ela inclui o limite. Os limites de latitude precisam variar entre -90 e 90 graus, e os limites de longitude precisam variar entre -180 e 180 graus. Vários casos incluem:

  • Se low = high, a viewport consiste nesse único ponto.

  • Se low.longitude > high.longitude, o intervalo de longitude é 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 viewport inclui todas as longitudes.

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

  • Se low.latitude for maior que 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 nas definições acima). Uma viewport vazia vai resultar em um erro.

Por exemplo, esta viewport inclui toda 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 mais baixo da janela de visualização.
high

object (LatLng)

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

Revisão

Informações sobre uma 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,
  "flagContentUri": string,
  "googleMapsUri": string
}
Campos
name

string

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

string

Uma string de horário recente formatado, que expressa o horário da avaliação em relação ao horário atual de uma forma adequada 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)

Autor da 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".
flagContentUri

string

Um link para que os usuários possam sinalizar um problema com a avaliação.
googleMapsUri

string

Um link para mostrar a avaliação no Google Maps.

AuthorAttribution

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

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

string

Nome do autor do Photo ou Review.
uri

string

URI do autor do Photo ou Review.
photoUri

string

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

OpeningHours

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

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

object (Period)

Os períodos em que o local fica aberto durante a semana. Os períodos estão em ordem cronológica, começando pelo domingo no fuso horário 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 localizadas que descrevem os horários de funcionamento do local, uma string para cada dia da semana. Vai estar vazio se os horários forem desconhecidos ou não puderem ser convertidos em texto localizado. Exemplo: "Dom: 18:00–06:00"
secondaryHoursType

enum (SecondaryHoursType)

Uma string de tipo usada para identificar o tipo de horas secundárias.
specialDays[]

object (SpecialDay)

Informações estruturadas sobre dias especiais que ocorrem no período coberto 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. Defina para currentOpeningHours e currentSecondaryOpeningHours se houver horários excepcionais.
nextOpenTime

string (Timestamp format)

A próxima vez que o período de funcionamento atual começará em até sete dias. Esse campo só é preenchido se o período de horário de funcionamento não estiver ativo no momento da veiculação da solicitaçã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".
nextCloseTime

string (Timestamp format)

A próxima vez que o período de funcionamento atual terminar até sete dias no futuro. Esse campo só é preenchido se o período de horário de funcionamento estiver ativo no momento da veiculação da solicitaçã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".
openNow

boolean

Indica se o período de funcionamento está ativo no momento. Para horários de funcionamento normais e atuais, esse campo indica se o lugar está aberto. Para os horários de funcionamento secundários e atuais, esse campo indica se o horário secundário do lugar está ativo.

Período

Período em que o lugar permanece no status "Aberto agora".

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

object (Point)

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

object (Point)

O horário em que o lugar começa a ficar 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

Indica se esse endpoint foi truncado ou não. O truncamento ocorre quando as horas reais estão fora dos horários que queremos retornar. Por isso, truncamos as horas de volta para 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 no formato de 24 horas. Varia de 0 a 23.
minute

integer

O minuto. Varia de 0 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 horas secundárias.

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

SpecialDay

Informações estruturadas sobre dias especiais que ocorrem no período coberto 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 uma foto de um lugar.

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

string

Identificador. Uma referência que representa essa foto de lugar e pode ser usada para pesquisar a foto de 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 da foto.
flagContentUri

string

Um link em que os usuários podem sinalizar um problema com a foto.
googleMapsUri

string

Um link para mostrar a foto no Google Maps.

BusinessStatus

Status da empresa para o local.

Enums
BUSINESS_STATUS_UNSPECIFIED Valor padrão. Esse valor não é usado.
OPERATIONAL O estabelecimento está operacional, mas não necessariamente aberto.
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 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 os provedores de dados desse lugar.

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

string

Nome do provedor de dados do lugar.
providerUri

string

URI do 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 forma de pagamento.
acceptsDebitCards

boolean

O local aceita cartões de débito como forma de pagamento.
acceptsCashOnly

boolean

O lugar só aceita pagamentos em dinheiro. Os lugares com esse atributo ainda podem aceitar outras formas de pagamento.
acceptsNfc

boolean

O lugar aceita pagamentos por NFC.

ParkingOptions

Informações sobre as opções de estacionamento do local. Um estacionamento pode oferecer 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 estacionamento gratuito.
paidParkingLot

boolean

O lugar oferece estacionamento pago.
freeStreetParking

boolean

O lugar oferece estacionamento público sem custo financeiro.
paidStreetParking

boolean

O lugar oferece estacionamento público pago.
valetParking

boolean

O lugar oferece estacionamento com manobrista.
freeGarageParking

boolean

O lugar oferece estacionamento gratuito na garagem.
paidGarageParking

boolean

O lugar oferece estacionamento em garagem pago.

SubDestination

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

O lugar oferece estacionamento com acessibilidade para cadeirantes.
wheelchairAccessibleEntrance

boolean

O lugar tem entrada acessível para cadeirantes.
wheelchairAccessibleRestroom

boolean

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

boolean

O lugar tem assentos acessíveis 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 combustível conhecido para cada tipo de combustível que o posto tem. Há uma entrada para cada tipo de combustível que a estação tem. A ordem não é importante.

FuelPrice

Informações sobre o preço do 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 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 Combustível diesel.
REGULAR_UNLEADED Gasolina comum.
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 Diesel para caminhões.

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", então 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 será positivo ou zero. Se units for zero, nanos poderá ser positivo, zero ou negativo. Se units for negativo, nanos será negativo ou zero. Por exemplo,US $-1,75 é representado como units=-1 e nanos=-750.000.000.

EVChargeOptions

Informações sobre a estação de recarga de VEs hospedada no Place. A terminologia segue https://afdc.energy.gov/fuels/electricity_infrastructure.html. 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 na estação. No entanto, como algumas portas podem ter vários conectores, mas carregar apenas 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 de conectores de carregamento de VE que contêm conectores do mesmo tipo e com a mesma taxa de carga.

ConnectorAggregation

Informações sobre recarga de VEs agrupadas por [type, maxChargeRateKw]. Mostra a agregação de recarga de VEs de conectores com o mesmo tipo e taxa de recarga 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á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 da última atualização das informações de disponibilidade do conector nessa agregaçã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".
availableCount

integer

Número de conectores disponíveis na agregação.
outOfServiceCount

integer

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

EVConnectorType

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

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 chamado 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). Com base no conector Mennekes tipo 2
EV_CONNECTOR_TYPE_TESLA O conector TESLA genérico. Esse é o padrão NACS na América do Norte, mas pode não ser 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 carregamento da Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T O tipo GB/T corresponde ao padrão GB/T da 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 mais detalhes.

Resumo do lugar gerado por IA.

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

object (LocalizedText)

Informações gerais do lugar.
overviewFlagContentUri

string

Um link em que os usuários podem sinalizar um problema com o resumo geral.
description

object (LocalizedText)

A descrição detalhada do lugar.
descriptionFlagContentUri

string

Um link em que os usuários podem sinalizar um problema com o resumo da descrição.
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 mais detalhes.

Referência relacionada ao conteúdo generativo.

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

object (Review)

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

string

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

AreaSummary

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

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

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

object (ContentBlock)

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

string

Um link em que os usuários podem sinalizar um problema com o resumo.

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 tema 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 mais detalhes.

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

ContainingPlace

Informações sobre o local em que o lugar está localizado.

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

string

O nome do recurso do lugar em que esse lugar está localizado.
id

string

O ID do lugar em que o lugar está localizado.

AddressDescriptor

Uma descrição relacional de um local. Inclui um conjunto classificado de pontos de referência e áreas de contenção precisas nas proximidades e a relação deles com o local de destino.

Representação JSON 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Campos
landmarks[]

object (Landmark)

Uma lista classificada de pontos de referência por perto. Os pontos de referência mais conhecidos e próximos são classificados primeiro.
areas[]

object (Area)

Uma lista classificada de áreas adjacentes ou que contêm outras. As áreas mais reconhecíveis e precisas são classificadas primeiro.

Ponto de referência

Informações básicas do marco e a relação dele com o local de destino.

Os pontos de referência são lugares importantes que podem ser usados para descrever um local.

Representação JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Campos
name

string

O nome do recurso do marco.
placeId

string

O ID do lugar do marco.
displayName

object (LocalizedText)

O nome de exibição do marco.
types[]

string

Um conjunto de tags de tipo para esse marco. Para conferir uma lista completa de valores possíveis, acesse https://developers.google.com/maps/documentation/places/web-service/place-types.
spatialRelationship

enum (SpatialRelationship)

Define a relação espacial entre o local de destino e o marco.
straightLineDistanceMeters

number

A distância em linha reta, em metros, entre o ponto central do alvo e o ponto central do ponto de referência. Em algumas situações, esse valor pode ser maior que travelDistanceMeters.
travelDistanceMeters

number

A distância de deslocamento, em metros, ao longo da rede rodoviária do destino até o marco, se conhecido. Esse valor não considera o modo de transporte, como a pé, de carro ou de bicicleta.

SpatialRelationship

Define a relação espacial entre o local de destino e o marco.

Enums
NEAR Essa é a relação padrão quando nada mais específico abaixo se aplica.
WITHIN O ponto de referência tem uma geometria espacial, e o alvo está dentro dos limites dele.
BESIDE O destino está diretamente ao lado do marco.
ACROSS_THE_ROAD O destino está diretamente oposto ao marco no outro lado da estrada.
DOWN_THE_ROAD Na mesma rota do ponto de referência, mas não ao lado ou em frente.
AROUND_THE_CORNER Não na mesma rota do ponto de referência, mas a uma única curva de distância.
BEHIND Perto da estrutura do ponto turístico, mas mais distante das entradas das ruas.

Área

Informações sobre a área e a relação dela com o local de destino.

As áreas incluem sublocalidades precisas, bairros e grandes complexos que são úteis para descrever um local.

Representação JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Campos
name

string

O nome do recurso da área.
placeId

string

O ID de lugar da área.
displayName

object (LocalizedText)

O nome de exibição da área.
containment

enum (Containment)

Define a relação espacial entre o local de destino e a área.

Contenção

Define a relação espacial entre o local de destino e a área.

Enums
CONTAINMENT_UNSPECIFIED A contenção não foi especificada.
WITHIN O local de destino está dentro da região da área, próximo ao centro.
OUTSKIRTS O local de destino está dentro da área, perto da borda.
NEAR O local de destino está fora da área, mas por perto.

PriceRange

O intervalo de preços associado a um lugar. endPrice pode ser desativado, o que indica um intervalo sem limite superior (por exemplo, "Mais de US $100").

Representação JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Campos
startPrice

object (Money)

O valor mínimo da faixa de preço (inclusive). O preço precisa ser igual ou superior a esse valor.
endPrice

object (Money)

O limite máximo do intervalo de preço (exclusivo). O preço precisa ser menor que esse valor.

Métodos

autocomplete

 Retorna previsões para a entrada especificada.

get

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

searchNearby

 Pesquise lugares perto de outros lugares.

searchText

 Pesquisa de lugares com base em consultas de texto.