为 ChatGPT 和 Gemini 指定精确位置

在 CHATGPT 和 GEMINI 任务中设置 payload.location，即可获得身处该地点的用户看到的回答。

获得的结果

• 街区级回答：以你指定的坐标为中心给出本地推荐，例如一个车站、一家门店或一个街角。
• 指定位置的结果中的 location：回答所用的坐标。
• Playground 中同样可用：在国家按钮旁的“位置（可选）”中输入地点或坐标。

工作原理

“附近哪家牙科好”“午饭去哪吃”这类问题的答案取决于用户所在的位置。ChatGPT 和 Gemini 会按用户的位置作答，所以同一个问题在江南和釜山会推荐不同的诊所。在 payload.location 中填写任务 country 内的坐标，querying.ai 就会以身处该地的用户身份向引擎提问。

坐标按下方请求那样，以十进制度数发送 latitude 和 longitude。在地图应用中任选一点即可读到这两个数字，Playground 也能按地名查出坐标。结果的 location 会返回同一坐标。

位置适用于 CHATGPT、GEMINI、GOOGLE、AIMODE 和 GOOGLE_SERP 任务。提交时 API 会立即检查引擎，其他引擎直接返回 LOCATION_UNSUPPORTED，因此每个运行的任务都会按你选择的地点作答。

应用场景

• 确认你的诊所、餐厅或门店是否会被 AI 推荐给附近的用户。
• 从多个街区或城市提出同一个问题，找出竞争对手领先的地区。
• 以每家连锁门店自己的地址为准，分别跟踪一套问题。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

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

提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。

payload.locationobject

country 内的地点，以十进制度数填写 latitude（-90 到 90）和 longitude（-180 到 180），例如 {"latitude": 37.4979, "longitude": 127.0276}。引擎会按身处该地点的用户作答。适用于 CHATGPT、GEMINI、GOOGLE、AIMODE 和 GOOGLE_SERP。

webhook.urlstring

你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。

idempotencyKeystring

你为请求设定的 ID。每个键在账户内对应一个任务，因此重试发送后仍是同一个任务。

响应

完成的任务如下所示，已截取部分内容。

{
  "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 的任务。用 GET /v1/async/task/{id} 轮询，直到 status 变为 COMPLETED 或 FAILED；或者加上 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。其他引擎会在提交时返回此代码。

价格

指定位置后价格与该引擎的常规价格相同：每个完成的任务，ChatGPT 消耗 2 个积分，Gemini 消耗 1 个积分。