> ## 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 de Google Places (GOOGLE_PLACES) > Obtén hasta 100 lugares de la lista de lugares de Google para una búsqueda local, buscados desde la ciudad que elijas. `GOOGLE_PLACES` devuelve los lugares que Google muestra en su pestaña Lugares para una búsqueda, la lista que se abre desde "Más lugares" bajo un paquete local. Lee hasta cinco páginas de 20 lugares y busca cada página desde la misma ciudad, así que obtienes hasta 100 lugares en el orden en que Google los clasifica allí. Úsalo para seguir la posición de un negocio en toda la lista local de una ciudad, o para reunir los negocios que Google muestra para un servicio en una ciudad. | | | | - | - | | `taskType` | `GOOGLE_PLACES` | | Entrada | `query` (obligatorio); `city` o `uule`, `limit`, `country` | | Créditos | 1 por página de Lugares leída. Cada página contiene 20 lugares. | | País | `US` por defecto. Cualquier código ISO 3166-1 alfa-2. | | Ubicación | Se fija con `city` o `uule`. Consulta [Regiones y ubicación](https://docs.querying.ai/es/engines/capacity.md). | ## Solicitud Esta solicitud pide los primeros 100 lugares que Google muestra para cuidados de larga duración en 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 } }' ``` Si tu sistema ya guarda el `uule` de Google para cada lugar, envíalo en lugar de `city`. Este valor corresponde a 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 } }' ``` La tarea se ejecuta de forma asíncrona. Lee el resultado como se describe en [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md). Una tarea con `limit: 100` suele completarse en uno o dos minutos. ## Parámetros | Campo | Obligatorio | Descripción | | - | - | - | | `query` | Sí | La búsqueda, de 1 a 100.000 caracteres. Se acepta `prompt` si falta `query`. | | `city` | No | El lugar desde el que buscar, nombrado como Google nombra los lugares: ciudad, estado o región y país, por ejemplo `"Reno, Nevada, United States"`. Hasta 100 caracteres. El resultado lo devuelve como `city`. | | `uule` | No | El parámetro de ubicación propio de Google, en su forma `w+`, tal como lo guardan las herramientas de seguimiento de posiciones, enviado a Google sin cambios. Envía `city` o `uule`. El resultado lo devuelve como `uule`. | | `limit` | No | Cuántos lugares devolver, un entero de 1 a 100. `20` por defecto, una página. Envía `100` para la lista completa. | | `country` | No | El mercado de Google en el que buscar. `US` por defecto. | Sin `city` ni `uule`, Google elige el lugar desde el que busca. ## Respuesta Por ejemplo, la solicitud de Manville anterior: ```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 | Descripción | | - | - | | `places` | Siempre presente, en el orden de Google. Cada lugar tiene los campos de un lugar del paquete local en `map` de [Google Search](https://docs.querying.ai/es/engines/google-serp.md): `name`, `placeId`, `location` (`address`, `latitude`, `longitude`), `phoneNumber`, `url`, `mapsUrl`, `reviews`, `category`, `price`, `snippet` e `image`, según los muestre Google. | | `places[].position` | La posición del lugar en toda la lista, desde 1. Continúa a través de las páginas. | | `places[].page` | La página de Lugares de la que procede, de 1 a 5. | | `pages` | Cuántas páginas de Lugares se leyeron. Se cobran esas páginas. | | `googleLocation` | El lugar desde el que Google indica que buscó. Solo aparece cuando su página lo muestra. | | `city` | El `city` que enviaste, si enviaste uno. | | `uule` | El `uule` que enviaste, si enviaste uno. | Un lugar que una página posterior vuelve a mostrar se cuenta una sola vez. Cuando la lista de Google termina antes de `limit`, `places` contiene todos los lugares que Google mostró; una localidad pequeña suele tener menos de 100. Los campos que Google no muestra para un lugar se omiten. Trata todos los campos salvo `name`, `position` y `page` como opcionales. ## Créditos Cada página de Lugares leída cuesta 1 crédito. Al enviar, la tarea retiene los créditos de las páginas que necesita `limit`, una página por cada 20 lugares: 1 por defecto, 5 con `limit: 100`. Al completarse se cobran las páginas leídas, así que una lista que Google termina tras tres páginas cuesta 3. Una tarea fallida cuesta 0. Consulta [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md). ## Límites y errores * Un `places` vacío en una tarea completada significa que Google no mostró ningún lugar para la búsqueda desde esa ubicación. Se confirma en un segundo navegador antes de devolverlo y cuesta 1 crédito. * Un `limit` fuera de 1-100, un `city` vacío o de más de 100 caracteres, o un `city` enviado junto con `uule` o `location` devuelve `422 VALIDATION_ERROR`. * Un `uule` que no es un UULE `w+` devuelve `400 VALIDATION_ERROR`. * `location` devuelve `422`. Fija el lugar con `city` o `uule`. * `include.rawResponse` no tiene efecto, e `include.html` e `include.analysis` devuelven `422`. Consulta [Markdown y respuestas en bruto](https://docs.querying.ai/es/engines/response-options.md). * Los demás errores de solicitud se enumeran en [Errores](https://docs.querying.ai/es/concepts/errors.md). ## Relacionado * [Google Search](https://docs.querying.ai/es/engines/google-serp.md) para una página de resultados con su paquete local * [Regiones y ubicación](https://docs.querying.ai/es/engines/capacity.md) * [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.