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

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

得られる結果

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

仕組み

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

場所は現地での書き方のまま、200文字まで入力します。「강남역」「Gangnam-gu, Seoul」、番地までの住所にも対応します。同じ名前が複数の都市にある場合は、区や市を加えてください。結果には適用された場所が記録されます。

• location.query: 送信したテキストです。
• location.name: 一致した場所で、その市場の表記で入ります。
• location.latitudeとlocation.longitude: エンジンが回答した地点の座標です。
• location.precision: 一致した場所の種類で、railway（駅）、suburb（地区）、city（都市）などがあります。

場所の指定は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": "SoHo, New York"
    }
  }'

リクエストのフィールド

taskTypestring必須

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

payload.promptstring必須

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

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つのままです。

レスポンス

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

{
  "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": {
      "name": "SoHo, Manhattan, New York County, New York, 10012, United States",
      "query": "SoHo, New York",
      "latitude": 40.72288,
      "longitude": -73.99875,
      "precision": "neighbourhood"
    }
  }
}

task.statusstring

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

credits.creditsChargedinteger

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

response.textstring

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

response.locationobject

回答に使われた場所。query、name、latitude、longitude、precision。

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 で使えます。それ以外のエンジンは送信時にこのコードを返します。

LOCATION_NOT_FOUNDHTTP 422

payload.location の場所が country 内で不明です。区や市を加えて、もう一度送ってください。

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

場所の検索が一時的に止まっています。同じリクエストを再送すると、見つかっている場所はすぐに処理されます。

料金

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