Este produto está no status legado. A partir de outubro de 2026, não será mais possível ativar a API Places (legada) para novos projetos do Google Cloud. Os projetos atuais continuam sendo totalmente compatíveis. Para novos recursos e melhor desempenho, migre para a API Places (nova).

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Place Details (Legacy)

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.

Depois de receber um place_id de uma pesquisa de lugar, você pode solicitar mais detalhes sobre um estabelecimento ou ponto de interesse específico iniciando uma solicitação do Place Details (Legacy). Uma solicitação do Place Details (Legacy) retorna informações mais abrangentes sobre o lugar indicado, como endereço completo, número de telefone, classificação e avaliações de usuários.

Solicitações do Place Details (legado)

Uma solicitação do Place Details (Legacy) é um URL HTTP no seguinte formato:

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

em que output pode ser um dos seguintes valores:

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

Certos parâmetros são obrigatórios para iniciar uma solicitação de pesquisa. Como é padrão em URLs, todos os parâmetros são separados usando o caractere E comercial (&). As seções a seguir listam os parâmetros e os valores possíveis.

Parâmetros obrigatórios

place_id

Um identificador textual que identifica um lugar de forma exclusiva, retornado de uma Place Search (legado). Para mais informações sobre IDs de lugar, consulte a visão geral de IDs de lugar.

Parâmetros opcionais

campos

Atenção:as solicitações do Place Search (Legacy) e do Place Details (Legacy) não retornam os mesmos campos. As solicitações do Place Search (legado) retornam um subconjunto dos campos retornados pelas solicitações do Place Details (legado). Se o campo que você quer não for retornado pelo Place Search (legado), use o Place Search (legado) para receber um place_id e use esse ID de lugar para fazer uma solicitação do Place Details (legado). Para mais informações sobre os campos que não estão disponíveis em uma solicitação do Place Search (legado), consulte Campos de dados de lugar (legado).

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. As SKUs Basic, Contact e Atmosphere são cobradas além da SKU base (Places Details, Find Place, Nearby Search ou Text Search) da solicitação que as acionou. Para mais informações, consulte a tabela 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 "Contact" 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 a cada chamada, independentemente de o campo ter sido solicitado.
language

O idioma em que os resultados serão retornados.
- Consulte a lista de idiomas compatíveis. O Google atualiza os idiomas compatíveis com frequência, então esta lista pode não estar completa.
- Se language não for fornecido, a API vai tentar usar o idioma preferencial, conforme especificado no cabeçalho Accept-Language.
- A API faz o possível para fornecer um endereço que seja legível para o usuário e os moradores locais. Para isso, ele retorna endereços no idioma local, transliterados para um script legível pelo usuário, se necessário, de acordo com o idioma preferido. Todos os outros endereços são retornados no idioma preferencial. Os componentes de endereço são todos retornados no mesmo idioma, que é escolhido no primeiro componente.
- Se um nome não estiver disponível no idioma preferido, a API vai usar a correspondência mais próxima.
- O idioma preferencial 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.
região

O código da região, especificado como um valor de dois caracteres de ccTLD ("domínio de nível superior"). A maioria dos códigos ccTLD é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Por exemplo, o ccTLD do Reino Unido é "uk" (.co.uk), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade "Reino Unido da Grã-Bretanha e Irlanda do Norte").
reviews_no_translations

Especifique reviews_no_translations=true para desativar a tradução de avaliações ou reviews_no_translations=false para ativar a tradução de avaliações. As avaliações são retornadas no idioma original.

Se omitido ou transmitido sem valor, a tradução de avaliações será ativada. Se o parâmetro language foi especificado na solicitação, use o idioma especificado como o preferencial para tradução. Se language for omitido, a API vai tentar usar o cabeçalho Accept-Language como o idioma preferencial.
reviews_sort

O método de classificação a ser usado ao retornar avaliações. Pode ser definido como most_relevant (padrão) ou newest.
- Para most_relevant (padrão), as avaliações são classificadas por relevância. O serviço vai priorizar os resultados para retornar avaliações originalmente escritas no idioma preferido.
- Para newest, as avaliações são classificadas em ordem cronológica. O idioma preferido não afeta a ordem de classificação.
O Google recomenda que você mostre ao usuário final como as avaliações estão sendo classificadas.
sessiontoken

Uma string aleatória que identifica uma sessão de preenchimento automático para fins de faturamento.

A sessão começa quando o usuário começa a digitar uma consulta e termina quando ele seleciona um lugar e uma chamada para o Place Details (Legacy) é feita. Cada sessão pode ter várias consultas, seguidas por uma seleção de lugar. As chaves de API usadas para cada solicitação em uma sessão precisam pertencer ao mesmo projeto do console do Google Cloud. Após a conclusão de uma sessão, o token perde a validade. Seu aplicativo precisa gerar um novo token para cada sessão. Se o parâmetro sessiontoken for omitido ou você reutilizar um token, a sessão vai ser cobrada como se nenhum token de sessão tivesse sido fornecido e cada solicitação será faturada separadamente.

Recomendamos as seguintes diretrizes:
- Use tokens de sessão em todas as sessões de preenchimento automático.
- Gere um novo token para cada sessão. É recomendável usar um UUID da versão 4.
- Verifique se as chaves de API usadas para todas as solicitações do Place Autocomplete e do Place Details em uma sessão pertencem ao mesmo projeto do console do Cloud.
- Transmita um token de sessão exclusivo para cada sessão nova. Se você usar o mesmo token para mais de uma sessão, cada solicitação vai ser faturada individualmente.

Aviso:se você não especificar pelo menos um campo com uma solicitação ou omitir o parâmetro fields de uma solicitação, TODOS os campos possíveis vão ser retornados, e uma cobrança será feita. Isso se aplica apenas às solicitações do Place Details (Legacy).

Exemplo de Place Details (legado)

O exemplo a seguir solicita os detalhes de um lugar por place_id e inclui os campos name, rating e formatted_phone_number:

Shell

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

Substitua a chave neste exemplo pela sua chave de API para que a solicitação funcione no seu aplicativo.

Resposta do Place Details (legado)

As respostas do Place Details (Legacy) são retornadas no formato indicado pela flag output no caminho do URL da solicitação.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          // ...
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          // ...
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <!-- ... -->
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <!-- ... -->
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

As respostas JSON e XML contêm os seguintes elementos:

PlacesDetailsResponse

Campo	Obrigatório	Tipo	Descrição
`html_attributions`	required	Array<string>	Pode conter um conjunto de atribuições sobre essa ficha que precisam ser exibidas ao usuário (algumas fichas podem não ter atribuição).
`result`	required	Place	Contém informações detalhadas sobre o lugar solicitado. Consulte Local para mais informações.
`status`	required	PlacesDetailsStatus	Contém o status da solicitação e pode conter informações de depuração para ajudar a rastrear o motivo da falha da solicitação. Consulte PlacesDetailsStatus para mais informações.
`info_messages`	opcional	Array<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 é retornado apenas para solicitações bem-sucedidas. Ele pode não ser retornado sempre, e o conteúdo está sujeito a alterações.

Em uma resposta JSON, eles são representados como elementos raiz. Em uma resposta XML, eles aparecem como elementos de nível superior abaixo de <PlaceDetailsResponse>.

PlacesDetailsStatus

Códigos de status retornados pelo serviço.

OK: indicando que a solicitação de API funcionou.
ZERO_RESULTS: indica que o local referenciado, place_id, era válido, mas não se refere mais a um resultado válido. Isso poderá ocorrer se um estabelecimento não estiver mais em funcionamento.
NOT_FOUND, indicando que o local referenciado, place_id, não foi encontrado no banco de dados do Places.
INVALID_REQUEST: indicando que a solicitação de API é inválida.
OVER_QUERY_LIMIT indicando qualquer 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 indica que o pedido foi recusado, geralmente porque:
- A solicitação não tem uma chave de API.
- O parâmetro key é inválido.
UNKNOWN_ERROR: indicando um erro desconhecido.

Lugar

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

Campo	Obrigatório	Tipo	Descrição
`address_components`	opcional	Matriz<`AddressComponent`>	Uma matriz contendo 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 de funcionamento 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 oferece retirada.
`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 todos os horários, 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 assentos internos ou externos.
`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 de idioma, se aplicável. O texto de 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 por humanos deste lugar. 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 "Avenida Paulista, 111, São Paulo, SP" consiste nos seguintes componentes: "Avenida Paulista" (o trajeto), "111" (o número), "São Paulo" (a cidade) e "SP" (o estado brasileiro). 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 local.
`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 local 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 por humanos 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 regular. 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	Array<PlacePhoto>	Uma matriz de objetos de foto, cada um contendo uma referência a uma imagem. Uma solicitação pode retornar até dez fotos. Para mais informações sobre fotos de lugares e como usar as imagens no seu aplicativo, consulte a documentação sobre fotos de lugares. 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 acordo com a 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 uso de `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 ordem de 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 vai priorizar os resultados para retornar avaliações originalmente escritas no idioma preferido. Para `newest`, as avaliações são classificadas em ordem cronológica. 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 uso de `scope` foi descontinuado.
`secondary_opening_hours`	opcional	Matriz<PlaceOpeningHours>	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. Os horários secundários são diferentes do horário principal de uma empresa. Por exemplo, um restaurante pode especificar o horário de drive-thru ou de entrega como secundário. 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 todos os horários, definido para datas que têm 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 a empresa oferece retirada.
`types`	opcional	Array<string>	Contém uma matriz de tipos de recursos que descrevem o resultado fornecido. Consulte a lista de tipos compatíveis.
`url`	opcional	string	Contém o URL da página oficial do Google desse local. Essa é 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 de diferença entre o fuso horário atual do lugar e o UTC. Por exemplo, para lugares em Sydney, na Austrália, durante o horário de verão, o valor seria 660 (+11 horas em relação ao UTC). Já para lugares na Califórnia fora do horário de verão, o valor seria -480 (-8 horas em relação ao UTC).
`vicinity`	opcional	string	Para resultados de estabelecimento (`types:["establishment", ...])`), o campo `vicinity` contém um endereço simplificado para o local, incluindo o nome da rua, o número da rua e a localidade, mas não província/estado, código postal ou país. Para todos os outros resultados, o campo `vicinity` contém o nome do elemento 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 da empresa na Web.
`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 de idioma, se aplicável. O texto de 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	Array<string>	Uma matriz de strings que descreve em texto legível por humanos o horário 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 o horário de abertura do local. 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 confiar que o status de "sempre aberto" é representado como um período aberto que contém o dia com o valor `0` e o horário com o 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 for `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 ao horário, que é usado 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 de 0000 a 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 limite 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 no último dia. Essa propriedade indica que o período de abertura ou fechamento pode se estender além desse limite 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 Fotos de lugares para mais informações.

Campo	Obrigatório	Tipo	Descrição
`height`	required	número	A altura da foto.
`html_attributions`	required	Array<string>	As atribuições HTML da foto.
`photo_reference`	required	string	Uma string usada para identificar a foto quando você faz 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 horário 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 do perfil do Local Guide do Google Maps do usuário, 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 tiver sido 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 &.
`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 tiver sido traduzida, correspondendo a um valor verdadeiro, o Google recomenda que você indique isso aos usuários. Por exemplo, você pode adicionar a seguinte string, "Traduzido pelo Google", à avaliação.

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

Solicitações do Place Details (legado)

Parâmetros obrigatórios

place_id

Parâmetros opcionais

campos

language

região

reviews_no_translations

reviews_sort

sessiontoken

Exemplo de Place Details (legado)

Shell

HTTP

Resposta do Place Details (legado)

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

Lugar

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

close

PlaceSpecialDay

Place Details (Legacy)

`html_attributions`

`result`

`status`

`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`