Dados premium

Para clientes com uma licença anterior do Google Maps APIs for Work ou do Google Maps API for Business, a Google Places API é adquirida como parte do Google Places API for Work. Esta seção da documentação descreve a ativação de dados premium para essa API.

Visão geral

O Google Places API Web Service oferece acesso a classificações e revisões de milhares de restaurantes, bares e outros locais em todo o mundo. Com o recurso de dados premium, você pode acessar programaticamente dados de revisão avançados como parte do Google Places API Web Service. Quando os dados premium são ativados, você recebe conteúdo extra, como uma pontuação de 30 pontos, classificações numéricas detalhadas e, quando disponível, uma revisão resumida.

O recurso de dados premium utiliza o Google Places API Web Service existente. Consulte a documentação do desenvolvedor para obter mais informações.

Ativação

Antes de começar, será necessário ter acesso a uma conta com acesso aos dados premium do Google Places API Web Service. Após a ativação da conta, as consultas que contêm a chave poderão acessar revisões e classificações avançadas. O nível de detalhe da resposta varia entre solicitações de Place Search e Place Details.

Você pode verificar se a conta está ativa no Google API Console seguindo as etapas a seguir.

  1. Acesse o Google API Console e faça login com a conta do Google.
  2. Selecione o projeto que foi criado quando você se inscreveu. O nome do projeto é iniciado por Google Maps APIs for Business or Google Maps for Work or Google Maps.
  3. Na lista de APIs ativadas, o serviço Places API - Zagat Content deve estar ativado. O serviço do Google Places API Web Service deve estar desativado.

Se você quiser acessar dados premium, mas o seu projeto não estiver ativado para isso, entre em contato com o seu gerente de contas.

Recursos dos dados premium

Observação: no momento, os dados premium estão disponíveis apenas no Google Places API Web Service. Eles não estão disponíveis na biblioteca Places da Google Maps JavaScript API.

Place Searches

Além dos campos de resposta padrão, os clientes do Google Places API for Work podem receber os seguintes campos. Esses campos aparecerão como filhos do nível superior do campo de resultado.

  • aspects (obsoleto) contém um único objeto AspectRating para a classificação principal desse estabelecimento. Cada
    AspectRating é descrito como:
    • type: o nome do aspecto que está sendo classificado. Por exemplo, atmosfera, serviço, comida, geral, etc.
    • rating: a classificação agregada para esse aspecto em particular, de 0 a 30. Observe que as classificações agregadas variam de 0 a 30, enquanto que as classificações que aparecem como parte de uma avaliação variam de 0 a 3.
  • zagat_selected (obsoleto) indica que o local foi selecionado como uma localização de qualidade Zagat. O rótulo Zagat identifica locais conhecidos pela qualidade consistentemente alta ou que têm personalidade especial ou exclusiva.

Solicitações de Place Details

Além dos campos de resposta padrão, os clientes do Google Places API for Work podem receber os seguintes campos. Esses campos aparecerão como filhos do nível superior do campo de resultado.

  • aspects (obsoleto) contém um único objeto AspectRating para a classificação principal desse estabelecimento. Cada
    AspectRating é descrito como:
    • type: o nome do aspecto que está sendo classificado. Por exemplo, atmosfera, serviço, comida, geral, etc.
    • rating: a classificação agregada para esse aspecto em particular, de 0 a 30. Observe que as classificações agregadas variam de 0 a 30, enquanto que as classificações que aparecem como parte de uma avaliação variam de 0 a 3.
  • review_summary (obsoleto) inclui uma avaliação detalhada e concisa selecionada pela equipe editorial do Google. Esse campo estará ausente, a não ser que o parâmetro extensions=review_summary seja passado na solicitação de detalhes.
  • zagat_selected (obsoleto) indica que o local foi selecionado como uma localização de qualidade Zagat. O rótulo Zagat identifica locais conhecidos pela qualidade consistentemente alta ou que têm personalidade especial ou exclusiva.

Respostas de Place Details

O exemplo a seguir mostra como os campos aspects e review_summary aparecem no corpo da resposta:

"aspects" : [
   {
      "rating" : 24,
      "type" : "food"
   },
   {
      "rating" : 21,
      "type" : "decor"
   },
   {
      "rating" : 24,
      "type" : "service"
   }
],

...

"review_summary" : "For a meal that's a \"leisurely celebration\",
Mountain View \"foodies\" head to this \"lovely\" old Victorian house, where
\"artful\", \"high-end\" New French tasting dinners that \"look great and taste
even better\" are enhanced by sommelier-selected wines and service that
\"anticipates your every need\"; a garden out back supplies some ingredients,
while four dining areas provide \"lovely decor and ambiance\"; P.S. an
abbreviated tasting menu is also available."