ChatGPTとGeminiに正確な場所を指定できます

CHATGPTとGEMINIのタスクにpayload.locationを指定すると、その場所にいるユーザーが見る回答を取得できます。

得られる結果

• 街単位の回答: 駅、店舗、交差点など、指定した地点の周辺を基準におすすめが返ります。
• 場所を指定した結果のlocation: 回答に使われた座標が入ります。
• Playgroundでも同じ操作: 国ボタンの横にある場所（任意）欄に地名か座標を入力します。

仕組み

「近くのおすすめの歯医者」や「ランチの店」といった質問の答えは、ユーザーがいる場所で変わります。ChatGPTとGeminiはユーザーの位置を基準に答えるため、同じ質問でも江南と釜山では薦める医院が変わります。payload.locationにタスクのcountry内の座標を指定すると、querying.aiがその場にいるユーザーとしてエンジンに質問します。

座標は下のリクエストのように、latitudeとlongitudeを10進数の度で送ります。地図アプリで選んだ地点の数値をそのまま使え、Playgroundでは地名から座標を探します。結果のlocationには同じ座標が返ります。

場所の指定はCHATGPT、GEMINI、GOOGLE、AIMODE、GOOGLE_SERPのタスクで使えます。送信した時点でエンジンを確認し、それ以外のエンジンにはLOCATION_UNSUPPORTEDを返すため、実行されるタスクはすべて指定した場所を基準に答えます。

活用例

• 自分のクリニック、飲食店、店舗が、その街のユーザーにAIから薦められているかを確認します。
• 同じ質問を複数の街や都市から送り、競合が強い地域を見つけます。
• チェーンの各店舗を、その店舗の住所を基準にした質問セットで追跡します。

リクエストを送る

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": "CHATGPT",
    "payload": {
      "prompt": "Best coffee shops near me for working on a laptop",
      "country": "US",
      "location": { "latitude": 40.72288, "longitude": -73.99875 }
    }
  }'

リクエストのフィールド

taskTypestring必須

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

payload.promptstring必須

ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。

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": "e5aba119-a26e-4f82-a965-35c9234a428b",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:41:03.858Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "Here are several **nearby cafés that look particularly suitable for laptop work**, based on current local listings and work-friendly details:\n\n- The Lost Draft — **0.2 km away**. Laptop-friendly, with Wi-Fi, comfortable seating, and larger tables.\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://awifiplace.com/cities/new-york",
        "label": "Best Coffee Shops to Work in New York (2026) | 103 Cafes with WiFi",
        "attribution": "A Wifi.Place"
      }
    ],
    "searchQueries": [
      "best coffee shops for laptop work near me wifi outlets"
    ],
    "location": { "latitude": 40.72288, "longitude": -73.99875 }
  }
}

task.statusstring

QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。

credits.creditsChargedinteger

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

response.textstring

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

response.locationobject

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

response.sourcesarray

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

response.searchQueriesarray

エンジンが回答を書くために実行したウェブ検索。

結果を受け取る

リクエストすると 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件につき、ChatGPTは2クレジット、Geminiは1クレジットです。