Place Details (Legacy)

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

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

Solicitações do Place Details (legado)

Uma solicitação de Place Details (legado) é um URL HTTP do 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 objeto JavaScript Notation (JSON)
  • xml indica 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 (&). Confira abaixo uma lista dos parâmetros e seus valores possíveis.

Parâmetros obrigatórios

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

  • região

    O código da região, especificado como um valor de dois caracteres ccTLD ("domínio de nível superior"). A maioria dos códigos de 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 e reviews_no_translations=false para ativar. As avaliações são retornadas no idioma original.

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

  • 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 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 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 Place Details é feita. Cada sessão pode ter várias consultas, seguidas por uma seleção de lugar. As chaves de API usadas em cada solicitação de 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 app precisa gerar um novo token para cada sessão. Se o parâmetro sessiontoken for omitido ou você reutilizar um token de sessão, a sessão será cobrada como se nenhum token 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. Recomendamos usar um UUID da versão 4.
    • Verifique se as chaves de API usadas em todas as solicitações de Place Autocomplete e 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.

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 de Place Details (legado) 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,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "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,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "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>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 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>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&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
required Matriz<string>

Pode conter um conjunto de atribuições sobre esta ficha, que precisam ser mostradas ao usuário (algumas fichas podem não ter atribuição).

required Place

Contém as informações detalhadas sobre o lugar solicitado.

Consulte Lugar para mais informações.
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.

Consulte PlacesDetailsStatus para mais informações.

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.

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 foi concluída.
  • ZERO_RESULTS indicando 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 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.

Lugar

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
opcional Matriz<AddressComponent>

Uma matriz que contém os componentes separados aplicáveis a esse endereço.

Consulte AddressComponent para mais informações.

opcional string

Uma representação do endereço do lugar no microformato adr.

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
opcional booleano

Especifica se a empresa aceita retirada na calçada.
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.

opcional booleano

Especifica se a empresa oferece entrega.
opcional booleano

Especifica se a empresa oferece opções de mesas internas ou externas.

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.

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.

opcional string

Contém o número de telefone do lugar no formato local.

opcional Geometry

Contém o local e a janela de visualização do local.

Consulte Geometry para mais informações.
opcional string

Contém o URL de um ícone sugerido que pode ser mostrado ao usuário ao indicar esse resultado em um mapa.

opcional string

Contém o código de cor hexadecimal padrão para a categoria do lugar.
opcional string

Contém o URL de um ícone recomendado, sem a extensão de tipo de arquivo .svg ou .png.

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.

opcional string

Contém o nome legível do resultado retornado. Para resultados de establishment, geralmente é o nome canônico da empresa.

opcional PlaceOpeningHours

Contém o horário de funcionamento normal.

Consulte PlaceOpeningHours para mais informações.

opcional booleano

Use business_status para ver o status de funcionamento das empresas.

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

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.
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
opcional número

Contém a nota do lugar (1,0 a 5,0), com base nas avaliações de usuários agregadas.

opcional string
opcional booleano

Especifica se o lugar aceita reservas.
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.

opcional string
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.

opcional booleano

Especifica se o lugar serve cerveja.
opcional booleano

Especifica se o lugar serve café da manhã.
opcional booleano

Especifica se o lugar serve brunch.
opcional booleano

Especifica se o lugar serve jantar.
opcional booleano

Especifica se o lugar serve almoço.
opcional booleano

Especifica se o lugar serve comida vegetariana.
opcional booleano

Especifica se o lugar serve vinho.
opcional booleano

Especifica se o estabelecimento oferece retirada no local.
opcional Matriz<string>

Contém uma matriz de tipos de recursos que descrevem o resultado especificado. Consulte a lista de tipos compatíveis.

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.

opcional número

O número total de avaliações, com ou sem texto, para este lugar.

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

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.

opcional string

O site oficial do lugar, como a página inicial de uma empresa.

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
opcional string

O idioma dos campos anteriores. Pode não estar sempre presente.
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
opcional booleano

Um valor booleano que indica se o lugar está aberto no horário atual.

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.

opcional Array<PlaceSpecialDay>

Uma matriz de até sete entradas correspondentes aos próximos sete dias.

Consulte PlaceSpecialDay para mais informações.

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
required PlaceOpeningHoursPeriodDetail

Contém um par de objetos de dia e hora que descrevem quando o lugar abre.

Consulte PlaceOpeningHoursPeriodDetail para mais informações.

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
opcional string

Uma data expressa no formato RFC3339 no fuso horário local do lugar, por exemplo, 2010-12-31.

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

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.

opcional string

Uma data expressa no formato RFC3339 no fuso horário local do lugar, por exemplo, 2010-12-31.

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
required número

A altura da foto.
required Matriz<string>

As atribuições HTML da foto.
required string

Uma string usada para identificar a foto ao fazer uma solicitação de foto.

required número

A largura da foto.

PlaceReview

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

Campo Obrigatório Tipo Descrição
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".

required número

A classificação geral do usuário para este lugar. É um número inteiro, de 1 a 5.

required string

O horário em que a avaliação foi enviada em texto, em relação ao horário atual.

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.

opcional string

O URL para o perfil do usuário no Local Guides do Google Maps, se disponível.

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.

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.

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 &amp; pode representar um caractere de e comercial.

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