API de resultados do Google Places (GOOGLE_PLACES)

GOOGLE_PLACES retorna os lugares que o Google lista na aba Lugares para uma busca, a lista que abre em “Mais lugares” abaixo de um pacote local. Ele lê até cinco páginas de 20 lugares e busca cada página a partir da mesma cidade, então você recebe até 100 lugares na ordem em que o Google os classifica ali. Use-o para acompanhar a posição de um negócio em toda a lista local de uma cidade, ou para reunir os negócios que o Google mostra para um serviço em uma cidade.


`taskType`	`GOOGLE_PLACES`
Entrada	`query` (obrigatório); `city` ou `uule`, `limit`, `country`
Créditos	1 por página de Lugares lida. Cada página tem 20 lugares.
País	Padrão `US`. Qualquer código ISO 3166-1 alfa-2.
Localização	Definida com `city` ou `uule`. Veja Regiões e localização.

Requisição

Esta requisição pede os primeiros 100 lugares que o Google lista para cuidados de longa duração em Manville, Rhode Island:

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_PLACES", "payload": { "query": "long term care near me", "city": "Manville, Rhode Island, United States", "limit": 100 } }'

Se o seu sistema já guarda o uule do Google para cada lugar, envie-o no lugar de city. Este valor é Reno, Nevada:

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_PLACES", "payload": { "query": "Reno attorney", "uule": "w+CAIQICIbUmVubywgTmV2YWRhLCBVbml0ZWQgU3RhdGVz", "limit": 100 } }'

A tarefa roda de forma assíncrona. Leia o resultado como descrito em Tarefas assíncronas. Uma tarefa com limit: 100 costuma terminar em um ou dois minutos.

Parâmetros

Campo	Obrigatório	Descrição
`query`	Sim	A busca, de 1 a 100.000 caracteres. `prompt` é aceito quando `query` está ausente.
`city`	Não	O lugar a partir do qual buscar, escrito como o Google nomeia lugares: cidade, estado ou região e país, por exemplo `"Reno, Nevada, United States"`. Até 100 caracteres. O resultado o devolve como `city`.
`uule`	Não	O parâmetro de localização do próprio Google, na forma `w+`, como as ferramentas de rastreamento de posição o guardam, enviado ao Google sem alterações. Envie `city` ou `uule`. O resultado o devolve como `uule`.
`limit`	Não	Quantos lugares retornar, um inteiro de 1 a 100. Padrão `20`, uma página. Envie `100` para a lista completa.
`country`	Não	O mercado do Google a buscar. Padrão `US`.

Sem city nem uule, o Google escolhe o lugar a partir do qual busca.

Resposta

Por exemplo, a requisição de Manville acima:

{
  "places": [
    {
      "position": 1,
      "page": 1,
      "name": "...",
      "placeId": "...",
      "location": { "address": "...", "...": "..." },
      "mapsUrl": "https://maps.google.com/?cid=...",
      "reviews": [{ "...": "..." }],
      "category": "..."
    },
    { "position": 21, "page": 2, "...": "..." }
  ],
  "pages": 5,
  "city": "Manville, Rhode Island, United States"
}

Campo	Descrição
`places`	Sempre presente, na ordem do Google. Cada lugar traz os campos de um lugar do pacote local em `map` do Google Search: `name`, `placeId`, `location` (`address`, `latitude`, `longitude`), `phoneNumber`, `url`, `mapsUrl`, `reviews`, `category`, `price`, `snippet` e `image`, conforme o Google os mostra.
`places[].position`	A posição do lugar na lista inteira, a partir de 1. Continua através das páginas.
`places[].page`	A página de Lugares de onde o lugar veio, de 1 a 5.
`pages`	Quantas páginas de Lugares foram lidas. A tarefa é cobrada por elas.
`googleLocation`	O lugar a partir do qual o Google mostra que buscou. Só aparece quando a página o mostra.
`city`	O `city` que você enviou, quando enviou um.
`uule`	O `uule` que você enviou, quando enviou um.

Um lugar que uma página seguinte lista de novo é contado uma vez. Quando a lista do Google termina antes de limit, places traz todos os lugares que o Google listou; uma cidade pequena muitas vezes tem menos de 100. Os campos que o Google não mostra para um lugar são omitidos. Trate todo campo, exceto name, position e page, como opcional.

Créditos

Cada página de Lugares lida custa 1 crédito. No envio, a tarefa reserva os créditos das páginas de que limit precisa, uma página a cada 20 lugares: 1 no padrão, 5 com limit: 100. Na conclusão, ela é cobrada pelas páginas lidas, então uma lista que o Google encerra após três páginas custa 3. Uma tarefa com falha custa 0. Veja Créditos e limites.

Limites e erros

Um places vazio em uma tarefa concluída significa que o Google não listou nenhum lugar para a busca a partir daquela localização. Isso é confirmado em um segundo navegador antes de ser retornado e custa 1 crédito.
limit fora de 1-100, um city vazio ou com mais de 100 caracteres, ou um city enviado junto com uule ou location retorna 422 VALIDATION_ERROR.
Um uule que não é um UULE w+ retorna 400 VALIDATION_ERROR.
location retorna 422. Defina o lugar com city ou uule.
include.rawResponse não tem efeito, e include.html e include.analysis retornam 422. Veja Markdown e respostas brutas.
Os demais erros de requisição estão em Erros.

Relacionados

Google Search para uma página de resultados com o pacote local
Regiões e localização
Créditos e limites

Primeiros passos

Conceitos principais

Mecanismos de resposta

Busca e dados da web

Opções de requisição

Pesquisa

Monitoramento GEO

Conta e dados

API de resultados do Google Places (GOOGLE_PLACES)

Requisição

Parâmetros

Resposta

Créditos

Limites e erros

Relacionados

​Requisição

​Parâmetros

​Resposta

​Créditos

​Limites e erros

​Relacionados

Requisição

Parâmetros

Resposta

Créditos

Limites e erros

Relacionados