API de resultados de Google Places (GOOGLE_PLACES)

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.

Solicitud

Esta solicitud pide los primeros 100 lugares que Google muestra para cuidados de larga duración en 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 } }'

Si tu sistema ya guarda el uule de Google para cada lugar, envíalo en lugar de city. Este valor corresponde a 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 } }'

La tarea se ejecuta de forma asíncrona. Lee el resultado como se describe en Tareas asíncronas. 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:

{
  "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: `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.

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.
Los demás errores de solicitud se enumeran en Errores.

Relacionado

Google Search para una página de resultados con su paquete local
Regiones y ubicación
Créditos y límites

Primeros pasos

Conceptos clave

Motores de respuesta

Búsqueda y datos web

Opciones de solicitud

Investigación

Monitorización GEO

Cuenta y datos

API de resultados de Google Places (GOOGLE_PLACES)

Solicitud

Parámetros

Respuesta

Créditos

Límites y errores

Relacionado

​Solicitud

​Parámetros

​Respuesta

​Créditos

​Límites y errores

​Relacionado

Solicitud

Parámetros

Respuesta

Créditos

Límites y errores

Relacionado