Este produto ou recurso está no status Legado. Para mais informações sobre o status Legado, consulte Produtos e recursos legados. Para migrar para a API Places (nova), consulte o guia de migração.

Find Place (legado)

Desenvolvedores do Espaço Econômico Europeu (EEE)

Observação: bibliotecas do lado do servidor e do lado do cliente

A API Places também está disponível com os clientes Java, Python, Go e Node.js para serviços do Google Maps. A API Places e as bibliotecas de cliente são para uso em aplicativos de servidor.

Se você estiver criando um aplicativo do lado do cliente, confira o SDK do Places para Android (novo), o SDK do Places para iOS (novo) e a Biblioteca Places, API Maps JavaScript.

Uma solicitação de Find Place (legado) recebe uma entrada de texto e retorna um lugar. A entrada pode ser qualquer tipo de dados de texto do Places, como um nome, endereço ou número de telefone. A solicitação precisa ser uma string. Uma solicitação Find Place (legada) usando dados não string, como uma coordenada de latitude/longitude ou um plus code, gera um erro.

Uma solicitação do Find Place (legado) retorna um subconjunto dos campos retornados por uma solicitação do Place Details (legado). Para mais informações sobre os campos indisponíveis em uma solicitação de Find Place (legado), consulte Suporte a campos da API Places. Se o campo que você quer não for retornado, use o Find Place (legado) para receber um place_id e use esse ID para fazer uma solicitação do Place Details (legado).

Solicitações do Find Place (legado)

Uma solicitação de Find Place (legado) é um URL HTTP no seguinte formato:

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

em que output pode ser um dos seguintes valores:

json (recomendado) indica a saída em JavaScript Object Notation (JSON)
xml indica saída como XML

Alguns parâmetros são obrigatórios para iniciar uma solicitação de Find Place (legado). Como é padrão em URLs, todos os parâmetros são separados usando o caractere E comercial (&).

Parâmetros obrigatórios

entrada

A string de texto em que pesquisar, por exemplo, "restaurante" ou "Rua Principal, 123". Precisa ser o nome, endereço ou categoria de estabelecimentos. Qualquer outro tipo de entrada pode gerar erros e não garante o retorno de resultados válidos. A API Places retorna as correspondências possíveis de acordo com essa string e ordena os resultados com base na relevância.
inputtype

O tipo de entrada. Pode ser textquery ou phonenumber. Os números de telefone precisam estar no formato internacional (com um sinal de adição "+" como prefixo), seguido pelo código do país e telefone. Consulte Recomendação E.164 ITU para mais informações.

Parâmetros opcionais

campos

Atenção:as solicitações do Place Search e do Place Details não retornam os mesmos campos. As solicitações do Place Search retornam um subconjunto dos campos retornados pelas solicitações do Place Details. Se o campo que você quer não for retornado pelo Place Search, use o Place Search para obter um place_id e use esse ID de lugar para fazer uma solicitação do Place Details. Para mais informações sobre os campos indisponíveis em uma solicitação de Place Search, consulte Suporte a campos da API Places.

Use o parâmetro "fields" para especificar uma lista separada por vírgulas de tipos de dados de lugar a serem retornados. (por exemplo: fields=formatted_address,name,geometry). Use uma barra ao especificar valores compostos. Por exemplo, opening_hours/open_now.

Os campos são divididos em três categorias de faturamento: Basic, Contact e Atmosphere. Os campos "Basic" são faturados na taxa básica, e os campos "Contact" e "Atmosphere" são faturados em uma taxa mais alta. As SKUs Basic, Contact e Atmosphere são cobradas além da SKU básica (Places Details, Find Place, Nearby Search ou Text Search) da solicitação que as acionou. Para mais informações, consulte a planilha de preços.

Basic

A categoria "Basic" inclui os seguintes campos: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (descontinuado), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

Contato

A categoria "Contato" inclui os seguintes campos: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

Atmosphere

A categoria "Atmosphere" inclui os seguintes campos: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

Observação:as atribuições, html_attributions, são sempre retornadas com todas as chamadas, independentemente de o campo ter sido solicitado.
language

O idioma em que os resultados serão retornados.
- Consulte a lista de idiomas disponíveis. O Google atualiza os idiomas aceitos com frequência, então esta lista pode não estar completa.
- Se language não for fornecido, a API tentará usar o idioma preferido, conforme especificado no cabeçalho Accept-Language.
- A API faz o possível para fornecer um endereço legível para o usuário e os moradores locais. Para isso, ele retorna endereços em português, transliterados para um script legível pelo usuário, se necessário, observando o idioma preferido. Todos os outros endereços são retornados no idioma preferido. Todos os componentes de endereço são retornados no mesmo idioma, que é escolhido no primeiro componente.
- Se um nome não estiver disponível no idioma preferido, a API usará a correspondência mais próxima.
- O idioma preferido tem uma pequena influência no conjunto de resultados que a API escolhe retornar e na ordem em que eles são retornados. O geocodificador interpreta abreviações de maneira diferente dependendo do idioma, como as abreviações de tipos de rua ou sinônimos que podem ser válidos em um idioma, mas não em outro. Por exemplo, utca e tér são sinônimos de rua em húngaro.
locationbias

Prefira resultados em uma área especificada, informando um raio mais latitude/longitude ou dois pares de latitude/longitude que representam os pontos de um retângulo. Se esse parâmetro não for especificado, a API usará a tendência de endereço IP por padrão.
- Viés de IP: instrui a API a usar a tendência de endereço IP. Transmita a string ipbias (essa opção não tem parâmetros adicionais).
- Circular: uma string que especifica o raio em metros, além de latitude/longitude em graus decimais. Use o seguinte formato: circle:radius@lat,lng.
- Retangular: uma string que especifica dois pares de latitude/longitude em graus decimais, representando os pontos sul/oeste e norte/leste de um retângulo. Use o seguinte formato:rectangle:south,west|north,east. Os valores leste/oeste são ajustados ao intervalo -180, 180, e os valores norte/sul são ajustados ao intervalo -90, 90.

Observação:se você omitir o parâmetro fields de uma solicitação de Find Place (legado), apenas o place_id do resultado será retornado.

Exemplos de Find Place (legado)

O exemplo a seguir mostra uma solicitação de Find Place (legado) para "Museu de Arte Contemporânea da Austrália", incluindo os campos photos, formatted_address, name, rating, opening_hours e geometry:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

O exemplo a seguir mostra uma solicitação do Find Place (legado) para "Mongolian Grill", usando o parâmetro locationbias para preferir resultados em um raio de 2.000 metros das coordenadas especificadas:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

O exemplo a seguir mostra uma solicitação do Find Place (legado) para um número de telefone. O prefixo de chamada internacional "+" foi codificado como %2B para que esta solicitação seja um URL compatível. Se não for codificado, o prefixo + será decodificado como um espaço no servidor, resultando em uma pesquisa de número de telefone inválida.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Respostas do Find Place (legado)

Uma resposta do Find Place (legado) contém apenas os tipos de dados especificados usando o parâmetro fields, além de html_attributions. O exemplo a seguir mostra a resposta de uma solicitação Find Place (legada) para "Museu de Arte Contemporânea da Austrália", incluindo os campos formatted_address, geometry, name, opening_hours, photos e rating.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

Campo	Obrigatório	Tipo	Descrição
`candidates`	required	Matriz<Lugar>	Contém uma matriz de candidatos a lugar. As solicitações do Place Search retornam um subconjunto dos campos retornados pelas solicitações do Place Details. Se o campo que você quer não for retornado pelo Place Search, use o Place Search para obter um place_id e use esse ID de lugar para fazer uma solicitação do Place Details. Consulte Lugar para mais informações.
`status`	required	PlacesSearchStatus	Contém o status da solicitação e pode conter informações de depuração para ajudar a rastrear o motivo da falha. Consulte PlacesSearchStatus para mais informações.
`error_message`	opcional	string	Quando o serviço retorna um código de status diferente de `OK<`, pode haver um campo `error_message` adicional no objeto de resposta. Esse campo contém informações mais detalhadas sobre os motivos por trás do código de status fornecido. Esse campo nem sempre é retornado, e o conteúdo dele está sujeito a mudanças.
`info_messages`	opcional	Matriz<string>	Quando o serviço retorna mais informações sobre a especificação da solicitação, pode haver um campo `info_messages` extra no objeto de resposta. Esse campo só é retornado para solicitações bem-sucedidas. Ele nem sempre é retornado, e o conteúdo está sujeito a mudanças.

PlacesSearchStatus

Códigos de status retornados pelo serviço.

OK: indicando que a solicitação de API foi concluída.
ZERO_RESULTS indicando que a pesquisa foi bem-sucedida, mas não retornou resultados. Isso pode ocorrer se a pesquisa recebeu um latlng em um local remoto.
INVALID_REQUEST: indica que a solicitação de API estava malformada, geralmente devido à falta de um parâmetro de consulta obrigatório (location ou radius).
OVER_QUERY_LIMIT indicando uma das seguintes opções:
- Você excedeu os limites de QPS.
- O faturamento não foi ativado na sua conta.
- O crédito mensal de US $200 ou um limite de uso definido pelo próprio usuário foi excedido.
- A forma de pagamento fornecida não é mais válida (por exemplo, o cartão de crédito expirou).
Consulte as Perguntas frequentes do Maps para mais informações sobre como resolver esse erro.
REQUEST_DENIED indicando que o pedido foi recusado, geralmente porque:
- Está faltando uma chave de API na solicitação.
- O parâmetro key é inválido.
UNKNOWN_ERROR: indicando um erro desconhecido.

Local

Atributos que descrevem um lugar. Nem todos os atributos estão disponíveis para todos os tipos de lugar.

Campo	Obrigatório	Tipo	Descrição
`address_components`	opcional	Matriz<`AddressComponent`>	Uma matriz que contém os componentes separados aplicáveis a esse endereço. Consulte `AddressComponent` para mais informações.
`adr_address`	opcional	string	Uma representação do endereço do lugar no microformato adr.
`business_status`	opcional	string	Indica o status operacional do lugar, se for uma empresa. Se não houver dados, `business_status` não será retornado. The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	opcional	booleano	Especifica se a empresa aceita retirada na calçada.
`current_opening_hours`	opcional	PlaceOpeningHours	Contém o horário de funcionamento dos próximos sete dias (incluindo hoje). O período começa à meia-noite na data da solicitação e termina às 23h59 seis dias depois. Esse campo inclui o subcampo `special_days` de todas as horas, definido para datas que têm horários excepcionais. Consulte PlaceOpeningHours para mais informações.
`delivery`	opcional	booleano	Especifica se a empresa oferece entrega.
`dine_in`	opcional	booleano	Especifica se a empresa oferece opções de mesas internas ou externas.
`editorial_summary`	opcional	PlaceEditorialSummary	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 do resumo precisa ser apresentado como está e não pode ser modificado ou alterado. Consulte PlaceEditorialSummary para mais informações.
`formatted_address`	opcional	string	Uma string que contém o endereço legível do local. Esse endereço costuma ser equivalente ao endereço postal. Alguns países, como o Reino Unido, não permitem a distribuição de endereços postais verdadeiros devido a restrições de licenciamento. O endereço formatado é composto de maneira lógica por um ou mais componentes de endereço. Por exemplo, o endereço "111 8th Avenue, New York, NY" consiste nos seguintes componentes: "111" (o número), "8th Avenue" (o trajeto), "New York" (a cidade) e "NY" (o estado dos EUA). Não analise o endereço formatado de maneira programática. Em vez disso, use os componentes de endereço individuais, que a resposta da API inclui, além do campo de endereço formatado.
`formatted_phone_number`	opcional	string	Contém o número de telefone do lugar no formato local.
`geometry`	opcional	`Geometry`	Contém o local e a janela de visualização do local. Consulte `Geometry` para mais informações.
`icon`	opcional	string	Contém o URL de um ícone sugerido que pode ser mostrado ao usuário ao indicar esse resultado em um mapa.
`icon_background_color`	opcional	string	Contém o código de cor hexadecimal padrão para a categoria do lugar.
`icon_mask_base_uri`	opcional	string	Contém o URL de um ícone recomendado, sem a extensão de tipo de arquivo `.svg` ou `.png`.
`international_phone_number`	opcional	string	Contém o número de telefone do lugar no formato internacional. O formato internacional inclui o código do país e é prefixado pelo sinal de adição (+). Por exemplo, o international_phone_number do escritório do Google em Sydney, Austrália, é `+61 2 9374 4000`.
`name`	opcional	string	Contém o nome legível do resultado retornado. Para resultados de `establishment`, geralmente é o nome canônico da empresa.
`opening_hours`	opcional	PlaceOpeningHours	Contém o horário de funcionamento normal. Consulte PlaceOpeningHours para mais informações.
`permanently_closed`	opcional	booleano	O uso de `permanently_closed` foi descontinuado. Use `business_status` para ver o status de funcionamento das empresas.
`photos`	opcional	Matriz<PlacePhoto>	Uma matriz de objetos de foto, cada um contendo uma referência a uma imagem. Uma solicitação pode retornar até dez fotos. Mais informações sobre fotos de lugares e como usar as imagens no seu aplicativo podem ser encontradas na documentação do Place Photos. Consulte PlacePhoto para mais informações.
`place_id`	opcional	string	um identificador textual que identifica um local de forma exclusiva. Para recuperar informações sobre o lugar, transmita esse identificador no campo `place_id` de uma solicitação de API Places. Para mais informações sobre IDs de lugar, consulte a visão geral de IDs de lugar.
`plus_code`	opcional	`PlusCode`	Uma referência de local codificada, derivada de coordenadas de latitude e longitude, que representa uma área: 1/8000 de um grau por 1/8000 de um grau (aproximadamente 14m x 14m na Linha do Equador) ou menor. Os Plus Codes podem ser usados em vez de endereços nos lugares em que não existem, ou seja, quando os imóveis não estão numerados ou as ruas não têm nome. Consulte Open Location Code e plus codes. Consulte `PlusCode` para mais informações.
`price_level`	opcional	número	O nível de preço do lugar, em uma escala de 0 a 4. O valor exato indicado por um valor específico varia de região para região. Os níveis de preço são interpretados da seguinte forma: 0 Sem custo financeiro 1 Barato 2 Moderada 3 Caro 4 Muito caro
`rating`	opcional	número	Contém a nota do lugar (1,0 a 5,0), com base nas avaliações de usuários agregadas.
`reference`	opcional	string	O `reference` foi descontinuado.
`reservable`	opcional	booleano	Especifica se o lugar aceita reservas.
`reviews`	opcional	Array<PlaceReview>	Uma matriz JSON de até cinco avaliações. Por padrão, as avaliações são classificadas por relevância. Use o parâmetro de solicitação `reviews_sort` para controlar a classificação. Para `most_relevant` (padrão), as avaliações são classificadas por relevância. O serviço favorece os resultados para retornar avaliações escritas originalmente no idioma preferido. Para `newest`, as avaliações são classificadas em ordem cronológica, e o idioma preferido não afeta a ordem de classificação. O Google recomenda indicar aos usuários se os resultados estão ordenados por `most_relevant` ou `newest`. Consulte PlaceReview para mais informações.
`scope`	opcional	string	O `scope` foi descontinuado.
`secondary_opening_hours`	opcional	Array<PlaceOpeningHours>	Contém uma matriz de entradas para os próximos sete dias, incluindo informações sobre o horário secundário de uma empresa. O horário secundário é diferente do horário principal de uma empresa. Por exemplo, um restaurante pode especificar horários de atendimento no drive-thru ou de entrega como horários secundários. Esse campo preenche o subcampo `type`, que usa 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 `special_days` de todas as horas, definido para datas com horários excepcionais. Consulte PlaceOpeningHours para mais informações.
`serves_beer`	opcional	booleano	Especifica se o lugar serve cerveja.
`serves_breakfast`	opcional	booleano	Especifica se o lugar serve café da manhã.
`serves_brunch`	opcional	booleano	Especifica se o lugar serve brunch.
`serves_dinner`	opcional	booleano	Especifica se o lugar serve jantar.
`serves_lunch`	opcional	booleano	Especifica se o lugar serve almoço.
`serves_vegetarian_food`	opcional	booleano	Especifica se o lugar serve comida vegetariana.
`serves_wine`	opcional	booleano	Especifica se o lugar serve vinho.
`takeout`	opcional	booleano	Especifica se o estabelecimento oferece retirada no local.
`types`	opcional	Matriz<string>	Contém uma matriz de tipos de recursos que descrevem o resultado especificado. Consulte a lista de tipos compatíveis.
`url`	opcional	string	Contém o URL da página oficial do Google para este lugar. Essa será a página do estabelecimento no Google com as melhores informações disponíveis sobre o local. Os aplicativos precisam vincular ou incorporar essa página em todas as telas que mostrem resultados detalhados do local para as pessoas.
`user_ratings_total`	opcional	número	O número total de avaliações, com ou sem texto, para este lugar.
`utc_offset`	opcional	número	Contém o número de minutos que o fuso horário atual deste lugar está deslocado do UTC. Por exemplo, para lugares em Sydney, Austrália, durante o horário de verão, seria 660 (+11 horas do UTC), e para lugares na Califórnia fora do horário de verão, seria -480 (-8 horas do UTC).
`vicinity`	opcional	string	Para estabelecimento (somente resultados de `types:["establishment", ...])`), o campo `vicinity` contém um endereço simplificado do lugar, incluindo o nome da rua, o número da rua e a localidade, mas não a província/estado, o código postal ou o país. Para todos os outros resultados, o campo `vicinity` contém o nome do recurso político (`types:["political", ...]`) mais específico presente no endereço do resultado. O conteúdo precisa ser lido no estado em que se encontra. Não analise o endereço formatado de maneira programática.
`website`	opcional	string	O site oficial do lugar, como a página inicial de uma empresa.
`wheelchair_accessible_entrance`	opcional	booleano	Especifica se o lugar tem uma entrada acessível a pessoas em cadeira de rodas.

PlaceEditorialSummary

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 do resumo precisa ser apresentado como está e não pode ser modificado ou alterado.

Campo	Obrigatório	Tipo	Descrição
`language`	opcional	string	O idioma dos campos anteriores. Pode não estar sempre presente.
`overview`	opcional	string	Um resumo textual de tamanho médio do lugar.

PlaceOpeningHours

Um objeto que descreve o horário de funcionamento de um lugar.

Campo	Obrigatório	Tipo	Descrição
`open_now`	opcional	booleano	Um valor booleano que indica se o lugar está aberto no horário atual.
`periods`	opcional	Array<PlaceOpeningHoursPeriod>	Uma matriz de períodos de funcionamento cobrindo sete dias, começando no domingo, em ordem cronológica. Consulte PlaceOpeningHoursPeriod para mais informações.
`special_days`	opcional	Array<PlaceSpecialDay>	Uma matriz de até sete entradas correspondentes aos próximos sete dias. Consulte PlaceSpecialDay para mais informações.
`type`	opcional	string	Uma string de tipo usada para identificar o tipo de horário secundário (por exemplo, `DRIVE_THROUGH`, `HAPPY_HOUR`, `DELIVERY`, `TAKEOUT`, `KITCHEN`, `BREAKFAST`, `LUNCH`, `DINNER`, `BRUNCH`, `PICKUP`, `SENIOR_HOURS`). Definido apenas para `secondary_opening_hours`.
`weekday_text`	opcional	Matriz<string>	Uma matriz de strings que descrevem em texto legível por humanos os horários de funcionamento do lugar.

PlaceOpeningHoursPeriod

Campo	Obrigatório	Tipo	Descrição
`open`	required	PlaceOpeningHoursPeriodDetail	Contém um par de objetos de dia e hora que descrevem quando o lugar abre. Consulte PlaceOpeningHoursPeriodDetail para mais informações.
`close`	opcional	PlaceOpeningHoursPeriodDetail	Pode conter um par de objetos de dia e hora que descrevem o horário de fechamento do local. Se um lugar estiver sempre aberto, a seção de fechamento não vai aparecer na resposta. Os clientes podem contar com o status "sempre aberto" representado como um período aberto contendo dia com valor `0` e hora com valor `0000`, sem `close`. Consulte PlaceOpeningHoursPeriodDetail para mais informações.

PlaceSpecialDay

Campo	Obrigatório	Tipo	Descrição
`date`	opcional	string	Uma data expressa no formato RFC3339 no fuso horário local do lugar, por exemplo, 2010-12-31.
`exceptional_hours`	opcional	booleano	Verdadeiro se houver horários excepcionais para esse dia. Se `true`, isso significa que há pelo menos uma exceção para esse dia. As exceções fazem com que valores diferentes ocorram nos subcampos de `current_opening_hours` e `secondary_opening_hours`, como `periods`, `weekday_text` e `open_now`. As exceções se aplicam aos horários, que são usados para gerar os outros campos.

PlaceOpeningHoursPeriodDetail

Campo	Obrigatório	Tipo	Descrição
`day`	required	número	Um número de 0 a 6, correspondente aos dias da semana, começando no domingo. Por exemplo, 2 significa terça-feira.
`time`	required	string	Pode conter uma hora do dia no formato hhmm de 24 horas. Os valores estão no intervalo 0000–2359. O horário será informado no fuso horário do lugar.
`date`	opcional	string	Uma data expressa no formato RFC3339 no fuso horário local do lugar, por exemplo, 2010-12-31.
`truncated`	opcional	booleano	Verdadeiro se um determinado período foi truncado devido a um corte de sete dias, em que o período começa antes da meia-noite na data da solicitação e/ou termina à meia-noite ou depois desse horário no último dia. Essa propriedade indica que o período de abertura ou fechamento pode se estender além desse corte de sete dias.

PlacePhoto

Uma foto de um lugar. A foto pode ser acessada usando a API Place Photo com um URL no seguinte padrão:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Consulte Place Photos para mais informações.

Campo	Obrigatório	Tipo	Descrição
`height`	required	número	A altura da foto.
`html_attributions`	required	Matriz<string>	As atribuições HTML da foto.
`photo_reference`	required	string	Uma string usada para identificar a foto ao fazer uma solicitação de foto.
`width`	required	número	A largura da foto.

PlaceReview

Uma avaliação do lugar enviada por um usuário.

Campo	Obrigatório	Tipo	Descrição
`author_name`	required	string	O nome do usuário que enviou a avaliação. Comentários anônimos são atribuídos a "Alguém que usa o Google".
`rating`	required	número	A classificação geral do usuário para este lugar. É um número inteiro, de 1 a 5.
`relative_time_description`	required	string	O horário em que a avaliação foi enviada em texto, em relação ao horário atual.
`time`	required	número	O momento em que a avaliação foi enviada, medido em segundos desde a meia-noite de 1º de janeiro de 1970 UTC.
`author_url`	opcional	string	O URL para o perfil do usuário no Local Guides do Google Maps, se disponível.
`language`	opcional	string	Um código de idioma IETF que indica o idioma da avaliação retornada.Esse campo contém somente a tag do idioma principal e não a tag secundária indicando o país ou a região. Por exemplo, todas as avaliações em inglês são marcadas como "en", e não "en-AU" ou "en-UK", e assim por diante.Esse campo fica vazio se houver apenas uma classificação sem texto de avaliação.
`original_language`	opcional	string	Um código de idioma IETF que indica o idioma original da avaliação. Se a avaliação foi traduzida, `original_language` != `language`.Esse campo contém somente a tag do idioma principal e não a tag secundária indicando o país ou a região. Por exemplo, todas as avaliações em inglês são marcadas como "en", e não "en-AU" ou "en-UK", e assim por diante.Esse campo fica vazio se houver apenas uma classificação sem texto de avaliação.
`profile_photo_url`	opcional	string	O URL da Foto do perfil do usuário, se disponível.
`text`	opcional	string	A avaliação do usuário. Ao avaliar um local com o Google Places, as avaliações de texto são opcionais. Portanto, esse campo pode estar vazio. Esse campo pode incluir marcação HTML básica. Por exemplo, a referência de entidade `&` pode representar um caractere de e comercial.
`translated`	opcional	booleano	Um valor booleano que indica se a avaliação foi traduzida do idioma original em que foi escrita.Se uma avaliação foi traduzida, correspondendo a um valor verdadeiro, o Google recomenda que você indique isso aos usuários. Por exemplo, você pode adicionar a seguinte string à avaliação: "Traduzido pelo Google".

Find Place (legado) Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Solicitações do Find Place (legado)

Parâmetros obrigatórios

entrada

inputtype

Parâmetros opcionais

campos

language

locationbias

Exemplos de Find Place (legado)

curl

HTTP

curl

HTTP

curl

HTTP

Respostas do Find Place (legado)

JSON

XML

PlacesFindPlaceFromTextResponse

candidates

status

error_message

info_messages

PlacesSearchStatus

Local

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

Find Place (legado)

`candidates`

`status`

`error_message`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`