La localisation précise arrive sur Google AI Mode, les AI Overviews et la recherche

Avec payload.location, les tâches GOOGLE, AIMODE et GOOGLE_SERP renvoient l’AI Overview, la réponse d’AI Mode et les résultats vus par un utilisateur sur place.

Ce qui change

• Les tâches GOOGLE, AIMODE et GOOGLE_SERP acceptent payload.location et renvoient l’AI Overview, la réponse d’AI Mode et les résultats que Google montre à un utilisateur au point indiqué : une gare, une boutique ou un coin de rue.
• location dans chaque résultat localisé, le même objet que pour ChatGPT et Gemini : les coordonnées appliquées.
• Les tâches GEMINI acceptent un lieu dans tous les pays couverts par Gemini, désormais aussi en Allemagne, au Royaume-Uni et en Iran.
• Le champ de lieu du Playground pour Google AI Overviews et Google AI Mode dans Moteurs de réponse, et pour Google Search dans Moteurs de recherche. Il propose un lieu du pays choisi, comme 강남역 pour KR ou 旺角 pour HK.

Fonctionnement

Google répond selon la position précise qu’un téléphone ou un navigateur lui partage : « vaccin contre la grippe près de moi » affiche les cliniques autour de ce point. Pour une tâche localisée, querying.ai partage les coordonnées de votre lieu de la même façon avant la recherche, et Google répond comme à un utilisateur présent sur place. Le country de la tâche fixe le marché et la langue des résultats, et payload.location fixe le point à l’intérieur.

Lors des tests, AI Mode a nommé le lieu demandé dans les 50 réponses localisées, dans huit villes de Corée et dix lieux aux États-Unis, au Japon, en Allemagne et au Royaume-Uni. Les AI Overviews ont reflété le lieu dans les 18 réponses localisées, et Gemini a répondu pour la ville demandée dans chaque réponse terminée depuis l’Allemagne et le Royaume-Uni.

Envoyez un point situé dans le country de la tâche, en latitude et longitude en degrés décimaux. AI Mode, les AI Overviews et les résultats de recherche l’enregistrent dans location.

Cas d’usage

• Vérifiez si votre clinique, votre restaurant ou votre boutique apparaît dans l’AI Overview et la réponse d’AI Mode pour les recherches faites à proximité.
• Posez la même question depuis une adresse à Google AI Mode, aux AI Overviews, à ChatGPT et à Gemini, et comparez ce que chacun recommande.
• Suivez les résultats de recherche autour de chaque établissement d’une enseigne, avec un ensemble de requêtes par adresse.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête 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 }
    }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.querystringObligatoire

La requête, rédigée comme un utilisateur la tape dans le champ de recherche.

payload.countrystring

Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.

payload.locationobject

Un point situé dans country, avec latitude (-90 à 90) et longitude (-180 à 180) en degrés décimaux, par exemple {"latitude": 37.4979, "longitude": 127.0276}. Le moteur répond comme à un utilisateur qui s’y trouve. Pour CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP.

webhook.urlstring

Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

idempotencyKeystring

Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

{
  "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, puis COMPLETED avec la réponse ou FAILED avec error.

credits.creditsChargedinteger

Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.

response.textstring

La réponse en texte brut.

response.markdownstring

La réponse avec ses titres, listes et tableaux, dans chaque résultat.

response.sourcesarray

Les pages citées par la réponse, dans l’ordre du moteur, avec position, url et label.

response.locationobject

Le point retenu pour la réponse, tel que vous l’avez envoyé : latitude et longitude.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

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

Erreurs

LOCATION_UNSUPPORTEDHTTP 422

payload.location fonctionne avec CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP. Les autres moteurs renvoient ce code dès l’envoi.

Tarif

Une tâche localisée coûte le même prix que toute autre tâche du moteur, par tâche terminée : 2 crédits pour AI Mode et les AI Overviews, 1 crédit pour les résultats de recherche et 1 crédit pour Gemini.