更新日志新功能

为 ChatGPT 和 Gemini 指定精确位置

Answers
Playground 中询问 SoHo, New York 附近咖啡店的 ChatGPT 回答，并显示到每家咖啡店的距离

在 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 任务。提交时 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": "SoHo, New York"
    }
  }'

请求字段

taskTypestring必填
要运行的引擎，例如 CHATGPT 或 GOOGLE。
payload.promptstring必填
按用户在聊天框中输入的方式写的问题，最多 100,000 个字符。
payload.countrystring
提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。
payload.locationstring
country 内的地点，例如车站、街区或街道地址，最多 200 个字符。引擎会按身处该地点的用户作答。适用于 CHATGPT、GEMINI、GOOGLE、AIMODE 和 GOOGLE_SERP。
webhook.urlstring
你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。
idempotencyKeystring
你为请求设定的 ID。每个键在账户内对应一个任务，因此重试发送后仍是同一个任务。

响应

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

JSON
{
  "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 的任务。用 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。其他引擎会在提交时返回此代码。
LOCATION_NOT_FOUNDHTTP 422
payload.location 的地点在 country 内未能匹配。加上区或城市后再发送。
LOCATION_LOOKUP_UNAVAILABLEHTTP 503
地点查询暂时中断。重新发送同一请求，之前找到的地点会立即处理。

价格

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

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅