Find Place (legado)

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

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.

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.

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

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.

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