> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # API de resultados do Google Places (GOOGLE_PLACES) > Receba até 100 lugares da lista de lugares do Google para uma busca local, buscados a partir da cidade que você escolher. `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](https://docs.querying.ai/pt/engines/capacity.md). | ## Requisição Esta requisição pede os primeiros 100 lugares que o Google lista para cuidados de longa duração em Manville, Rhode Island: ```bash theme={"theme":"css-variables"} 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: ```bash theme={"theme":"css-variables"} 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](https://docs.querying.ai/pt/concepts/async-tasks.md). 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: ```json theme={"theme":"css-variables"} { "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](https://docs.querying.ai/pt/engines/google-serp.md): `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](https://docs.querying.ai/pt/concepts/credits-and-limits.md). ## 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](https://docs.querying.ai/pt/engines/response-options.md). * Os demais erros de requisição estão em [Erros](https://docs.querying.ai/pt/concepts/errors.md). ## Relacionados * [Google Search](https://docs.querying.ai/pt/engines/google-serp.md) para uma página de resultados com o pacote local * [Regiões e localização](https://docs.querying.ai/pt/engines/capacity.md) * [Créditos e limites](https://docs.querying.ai/pt/concepts/credits-and-limits.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.