精确位置扩展到 Google AI Mode、AI Overview 和搜索结果

在 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 提出同一个问题，比较各引擎的推荐。
• 为连锁品牌的每家门店按其地址设置一组查询，跟踪周边的搜索结果。

发送请求

在 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": "AIMODE",
    "payload": {
      "query": "where can I get a flu shot near me",
      "country": "HK",
      "location": "旺角"
    }
  }'

请求字段

taskTypestring必填

要运行的引擎，例如 CHATGPT 或 GOOGLE。

payload.querystring必填

按用户在搜索框中输入的方式写的搜索词。

payload.countrystring

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

payload.locationstring

country 内的地点，例如车站、街区或街道地址，最多 200 个字符。引擎会按身处该地点的用户作答。适用于 CHATGPT、GEMINI、GOOGLE、AIMODE 和 GOOGLE_SERP。

webhook.urlstring

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

idempotencyKeystring

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

响应

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

{
  "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 的任务。用 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

地点查询暂时中断。重新发送同一请求，之前找到的地点会立即处理。

价格

指定位置后价格与该引擎的常规价格相同。每个完成的任务，AI Mode 和 AI Overview 消耗 2 个积分，搜索结果和 Gemini 消耗 1 个积分。