更新情報改善

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

Answers
香港の旺角の近くでインフルエンザ予防接種を受けられる場所を尋ねた Google AI Mode の回答と、Yau Tsim Mong District のクリニックを表示した Playground

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内で、現地での書き方のまま200文字まで入力します。AI Mode、AI Overview、検索結果のいずれも、適用された場所をlocationとして記録し、query、name、latitude、longitude、precisionが入ります。

活用例

  • 自分のクリニック、飲食店、店舗が、その周辺で行われた検索の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": "旺角"
    }
  }'

リクエストのフィールド

taskTypestring必須
実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.querystring必須
ユーザーが検索ボックスに入力するとおりに書いた検索クエリ。
payload.countrystring
質問する市場の2文字の国コード。US、KR、JP など。既定値は US。
payload.locationstring
country 内の場所。駅、地区、住所など最大200文字。エンジンはその場所にいるユーザーへの回答を返します。CHATGPT、GEMINI、GOOGLE、AIMODE、GOOGLE_SERP で使えます。
webhook.urlstring
サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。
idempotencyKeystring
リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

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

JSON
{
  "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 を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.textstring
回答のプレーンテキスト。
response.markdownstring
見出し、リスト、表を保った回答。すべての結果に入ります。
response.sourcesarray
回答が引用したページ。エンジンの表示順に position、url、label が入ります。
response.locationobject
回答に使われた場所。query、name、latitude、longitude、precision。

結果を受け取る

リクエストすると 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 で使えます。それ以外のエンジンは送信時にこのコードを返します。
LOCATION_NOT_FOUNDHTTP 422
payload.location の場所が country 内で不明です。区や市を加えて、もう一度送ってください。
LOCATION_LOOKUP_UNAVAILABLEHTTP 503
場所の検索が一時的に止まっています。同じリクエストを再送すると、見つかっている場所はすぐに処理されます。

料金

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

ほかの更新

最新情報を受け取る

製品の更新をメールでお届けします。

RSS フィード