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 punto que indicas: una estación, una tienda o una esquina.
• location en cada resultado con lugar, el mismo objeto que devuelven ChatGPT y Gemini: las coordenadas aplicadas.
• 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.

Envía un punto dentro del country de la tarea como latitude y longitude en grados decimales. AI Mode, las AI Overviews y los resultados de búsqueda lo registran en location.

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": { "latitude": 22.31931, "longitude": 114.16981 }
    }
  }'

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.locationobject

Un punto dentro de country, con latitude (-90 a 90) y longitude (-180 a 180) en grados decimales, por ejemplo {"latitude": 37.4979, "longitude": 127.0276}. 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": { "latitude": 22.31931, "longitude": 114.16981 }
  }
}

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 punto que usó la respuesta, tal como lo enviaste: latitude y longitude.

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.

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.