正確な場所の指定がGoogle AI Mode、AI Overview、検索結果に広がりました

GOOGLE、AIMODE、GOOGLE_SERPのタスクにpayload.locationを指定すると、その場所にいるユーザーが見るAI Overview、AI Modeの回答、検索結果を取得できます。

変更点

• GOOGLE、AIMODE、GOOGLE_SERPのタスクがpayload.locationに対応しました。駅、店舗、交差点など、指定した地点にいるユーザーにGoogleが表示するAI Overview、AI Modeの回答、検索結果を受け取れます。
• 場所を指定した結果のlocation: ChatGPTやGeminiと同じオブジェクトで、適用された座標が入ります。
• GEMINIのタスクは、Geminiが対応するすべての国で場所を指定できます。ドイツ、イギリス、イランも新たに含まれます。
• Playgroundの場所欄: 回答エンジンのGoogle AI OverviewsとGoogle AI Mode、検索エンジンのGoogle Searchに表示されます。KRなら강남역、HKなら旺角のように、選んだ国の場所を例として示します。

仕組み

Googleはスマートフォンやブラウザが共有した正確な位置を基準に答えるため、「近くのインフルエンザ予防接種」はその地点の周辺のクリニックを返します。場所を指定したタスクでは、querying.aiが検索の前に同じ方法でその場所の座標を共有するため、Googleはその場にいるユーザーへの答えを返します。タスクのcountryが市場と結果の言語を決め、payload.locationがその中の地点を決めます。

検証では、AI Modeは場所を指定した回答50件すべてで指定した場所を名前で挙げました。韓国の8都市と、アメリカ、日本、ドイツ、イギリスの10か所で測った結果です。AI Overviewは場所を指定した回答18件すべてに場所が反映され、Geminiはドイツとイギリスで完了した回答すべてが指定した都市を基準に答えました。

タスクのcountry内の地点を、latitudeとlongitudeの10進数の度で送ります。AI Mode、AI Overview、検索結果のいずれも、適用された座標をlocationとして記録します。

活用例

• 自分のクリニック、飲食店、店舗が、その周辺で行われた検索のAI OverviewとAI Modeの回答に出るかを確認します。
• 同じ住所からGoogle AI Mode、AI Overview、ChatGPT、Geminiに同じ質問をして、各エンジンのおすすめを比べます。
• チェーンの各店舗の住所ごとにクエリセットを用意し、周辺の検索結果を追跡します。

リクエストを送る

API キーを 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 }
    }
  }'

リクエストのフィールド

taskTypestring必須

実行するエンジン。CHATGPT や GOOGLE などを指定します。

payload.querystring必須

ユーザーが検索ボックスに入力するとおりに書いた検索クエリ。

payload.countrystring

質問する市場の2文字の国コード。US、KR、JP など。既定値は US。

payload.locationobject

country 内の地点。latitude(-90〜90)と longitude(-180〜180)を10進数の度で指定します。例: {"latitude": 37.4979, "longitude": 127.0276}。エンジンはその場所にいるユーザーへの回答を返します。CHATGPT、GEMINI、GOOGLE、AIMODE、GOOGLE_SERP で使えます。

webhook.urlstring

サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

idempotencyKeystring

リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

{
  "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 を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。

credits.creditsChargedinteger

完了したタスクに請求されたクレジット。失敗したタスクは0です。

response.textstring

回答のプレーンテキスト。

response.markdownstring

見出し、リスト、表を保った回答。すべての結果に入ります。

response.sourcesarray

回答が引用したページ。エンジンの表示順に position、url、label が入ります。

response.locationobject

回答に使われた地点。送ったままの latitude と longitude。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

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

エラー

LOCATION_UNSUPPORTEDHTTP 422

payload.location は CHATGPT、GEMINI、GOOGLE、AIMODE、GOOGLE_SERP で使えます。それ以外のエンジンは送信時にこのコードを返します。

料金

場所を指定しても料金はエンジンの通常料金のままです。完了したタスク1件につき、AI ModeとAI Overviewは2クレジット、検索結果とGeminiは1クレジットです。