La ubicación precisa llega a Google AI Mode, AI Overviews y la búsqueda

Usa payload.location en tareas GOOGLE, AIMODE y GOOGLE_SERP para ver la AI Overview, la respuesta de AI Mode y los resultados que ve un usuario en ese lugar.

Qué cambia

• Las tareas GOOGLE, AIMODE y GOOGLE_SERP aceptan payload.location y devuelven la AI Overview, la respuesta de AI Mode y los resultados que Google muestra a un usuario en el lugar que indicas: una estación, un distrito o una dirección.
• location en cada resultado con lugar, el mismo objeto que devuelven ChatGPT y Gemini: el lugar aplicado, sus coordenadas y el tipo de lugar que coincidió.
• Las tareas GEMINI aceptan un lugar en todos los países donde funciona Gemini, ahora también en Alemania, el Reino Unido e Irán.
• El campo de ubicación del Playground para Google AI Overviews y Google AI Mode en Motores de respuesta, y para Google Search en Motores de búsqueda. Sugiere un lugar del país elegido, como 강남역 para KR o 旺角 para HK.

Cómo funciona

Google responde según la ubicación precisa que comparte un teléfono o un navegador, así que “vacuna de la gripe cerca de mí” muestra clínicas alrededor de ese punto. En una tarea con lugar, querying.ai comparte las coordenadas de tu lugar de la misma forma antes de la búsqueda, y Google responde como a un usuario que está allí. El country de la tarea fija el mercado y el idioma de los resultados, y payload.location fija el punto dentro de él.

En las pruebas, AI Mode nombró el lugar pedido en las 50 respuestas con ubicación, en ocho ciudades de Corea y diez lugares de Estados Unidos, Japón, Alemania y el Reino Unido. Las AI Overviews reflejaron el lugar en las 18 respuestas con ubicación, y Gemini respondió para la ciudad pedida en cada respuesta completada desde Alemania y el Reino Unido.

Escribe el lugar como lo escriben allí, con hasta 200 caracteres, dentro del country de la tarea. AI Mode, las AI Overviews y los resultados de búsqueda lo registran en location, con query, name, latitude, longitude y precision.

Para qué sirve

• Comprueba si tu clínica, restaurante o tienda aparece en la AI Overview y en la respuesta de AI Mode para las búsquedas hechas a su alrededor.
• Haz la misma pregunta desde una dirección a Google AI Mode, AI Overviews, ChatGPT y Gemini, y compara lo que recomienda cada uno.
• Sigue los resultados de búsqueda alrededor de cada sucursal de una cadena, con un conjunto de búsquedas por dirección.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "AIMODE",
    "payload": {
      "query": "where can I get a flu shot near me",
      "country": "HK",
      "location": "旺角"
    }
  }'

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.querystringObligatorio

La búsqueda, escrita como la teclea un usuario en el buscador.

payload.countrystring

Código de país de dos letras del mercado desde el que se pregunta, como US, KR o JP. Por defecto US.

payload.locationstring

Un lugar dentro de country, como una estación, un barrio o una dirección, de hasta 200 caracteres. El motor responde como a un usuario que está allí. Para CHATGPT, GEMINI, GOOGLE, AIMODE y GOOGLE_SERP.

webhook.urlstring

Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

idempotencyKeystring

Tu propio ID para la solicitud. Cada clave crea una sola tarea por cuenta, así que un reenvío sigue siendo una sola tarea.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

{
  "success": true,
  "task": {
    "id": "22ae7f29-df83-425a-b614-606c50c81502",
    "taskType": "AIMODE",
    "status": "COMPLETED",
    "createdAt": "2026-10-03T17:54:37.189Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "markdown": "In the **Yau Tsim Mong District** and across Hong Kong, you can get your seasonal influenza vaccination (flu shot) through private medical clinics, private group medical practices, or subsidized public channels…\n\nHere are a few options located right in your area:\n\n- **Private Medical Groups & Clinics:**\n  - **Local Private General Practice Clinics:** Many neighborhood private clinics across Yau Ma Tei, Tsim Sha Tsui, and Mong Kok offer walk-in or appointment-based flu jabs.\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.chp.gov.hk/en/features/18630.html",
        "label": "CHP Government Vaccination Programme"
      }
    ],
    "location": {
      "name": "旺角, 亞皆老街, 旺角, 油尖旺區, 九龍, 香港, 中国",
      "query": "旺角",
      "latitude": 22.31931,
      "longitude": 114.16981,
      "precision": "railway"
    }
  }
}

task.statusstring

QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.

credits.creditsChargedinteger

Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.

response.textstring

La respuesta en texto plano.

response.markdownstring

La respuesta con sus títulos, listas y tablas, en cada resultado.

response.sourcesarray

Las páginas que cita la respuesta, en el orden del motor, con position, url y label.

response.locationobject

El lugar que usó la respuesta: query, name, latitude, longitude y precision.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Errores

LOCATION_UNSUPPORTEDHTTP 422

payload.location funciona en CHATGPT, GEMINI, GOOGLE, AIMODE y GOOGLE_SERP. Los demás motores devuelven este código al enviar.

LOCATION_NOT_FOUNDHTTP 422

El lugar de payload.location es desconocido dentro de country. Añade el distrito o la ciudad y vuelve a enviarlo.

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

La búsqueda de lugares está detenida un momento. Reenvía la misma solicitud y los lugares ya encontrados se resuelven al instante.

Precio

Una tarea con ubicación cuesta lo mismo que cualquier otra de su motor, por tarea completada: 2 créditos en AI Mode y AI Overviews, 1 crédito en resultados de búsqueda y 1 crédito en Gemini.