REST Resource: places

{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "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)
  }
}

string

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

string

O identificador exclusivo de um local.

object (LocalizedText)

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

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

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

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

string

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

string

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

string

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

string

Um endereço curto e legível para este lugar.

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.

object (PlusCode)

Plus Code da latitude/longitude do local do lugar.

object (LatLng)

A posição deste lugar.

object (Viewport)

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

number

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

string

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

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.

object (Review)

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

object (OpeningHours)

O horário de funcionamento normal.

object (Photo)

Informações (incluindo referências) sobre fotos deste lugar. É possível devolver no máximo 10 fotos.

string

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

enum (BusinessStatus)

O status da empresa do lugar.

enum (PriceLevel)

Nível de preço do lugar.

object (Attribution)

Um conjunto de provedor de dados que precisa ser mostrado com esse resultado.

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").

string

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

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.

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.

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.

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.

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.

object (ParkingOptions)

Opções de estacionamento oferecidas pelo lugar.

object (SubDestination)

Uma lista de subdestinos relacionados ao lugar.

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.

object (EVChargeOptions)

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

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.

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á.

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.

integer

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

boolean

Especifica se a empresa oferece suporte para retirada de dados.

boolean

Especifica se a empresa oferece suporte ao envio.

boolean

Especifica se a empresa oferece opções de assentos internos ou externos.

boolean

Especifica se a empresa oferece drive-thru.

boolean

Especifica se o lugar aceita reservas.

boolean

Especifica se o local serve café da manhã.

boolean

Especifica se o lugar serve almoço.

boolean

Especifica se o local serve jantar.

boolean

Especifica se o local serve cerveja.

boolean

Especifica se o local serve vinho.

boolean

Especifica se o lugar serve brunch.

boolean

Especifica se o lugar serve comida vegetariana.

boolean

O lugar tem mesas ao ar livre.

boolean

O local tem música ao vivo.

boolean

O lugar tem cardápio infantil.

boolean

Local que serve coquetéis.

boolean

O lugar serve sobremesa.

boolean

O local serve café.

boolean

O lugar é bom para crianças.

boolean

O lugar permite cachorros.

boolean

O lugar tem banheiro.

boolean

O lugar acomoda grupos.

boolean

Lugar adequado para assistir esportes.

object (AccessibilityOptions)

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

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

string

String localizada no idioma correspondente a languageCode abaixo.

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.

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

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

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

string

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

string

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

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

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).

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.

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

number

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

number

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

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

object (LatLng)

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

object (LatLng)

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

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

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}).

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.

object (LocalizedText)

O texto localizado da avaliação.

object (LocalizedText)

O texto da avaliação no idioma original.

number

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

object (AuthorAttribution)

O autor desta avaliação.

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

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

string

Nome do autor da Photo ou da Review.

string

URI do autor da Photo ou da Review.

string

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

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

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.

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"

enum (SecondaryHoursType)

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

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.

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.

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

object (Point)

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

object (Point)

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

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

object (Date)

Data no fuso horário local do lugar.

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.

integer

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

integer

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

integer

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

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

integer

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

integer

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

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.

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

object (Date)

A data deste dia especial.

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

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}).

integer

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

integer

A altura máxima disponível em pixels.

object (AuthorAttribution)

Os autores desta foto.

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

string

Nome do provedor de dados do local.

string

URI para o provedor de dados do local.

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

boolean

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

boolean

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

boolean

O lugar só aceita dinheiro como pagamento. Locais com esse atributo ainda podem aceitar outras formas de pagamento.

boolean

O lugar aceita pagamentos por aproximação.

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

boolean

Estacionamento gratuito.

boolean

O local tem estacionamento pago.

boolean

O local oferece estacionamento gratuito na rua.

boolean

O local oferece estacionamento público pago.

boolean

O local oferece estacionamento com manobrista.

boolean

Estacionamento coberto sem custo financeiro.

boolean

Estacionamento coberto pago.

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

string

O nome do recurso do subdestino.

string

O ID do lugar do subdestino.

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

boolean

Estacionamento acessível a pessoas em cadeira de rodas.

boolean

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

boolean

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

boolean

O local tem assento com acessibilidade para pessoas em cadeira de rodas.

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

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.

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

enum (FuelType)

O tipo de combustível.

object (Money)

O preço do combustível.

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

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

string

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

string (int64 format)

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

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.

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

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).

object (ConnectorAggregation)

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

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

enum (EVConnectorType)

O tipo de conector dessa agregação.

number

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

integer

Número de conectores nesta agregação.

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

integer

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

integer

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

{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

object (LocalizedText)

A visão geral do lugar.

object (LocalizedText)

A descrição detalhada do lugar.

object (References)

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

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

object (Review)

Avaliações que servem como referências.

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.

{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}

object (ContentBlock)

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

{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

string

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

object (LocalizedText)

Conteúdo relacionado ao tema.

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.