查看 Gemini 回答中的商品和地点

GEMINI 结果现在包含 Gemini 在回答中展示的商品卡片和地点。

更新内容

• shoppingCards：Gemini 展示的商品卡片，包含名称、位置、价格、商店、评分、评价数、缩略图，以及指向 Google 商品页的 productLink。
• inlineProducts：回答正文中带链接的商品，包含名称、位置和 productLink。
• map：询问地点时 Gemini 推荐的地点，包含地址、坐标、电话、网站、Google 地图链接、评分和类别。

工作原理

当你问 Gemini 买什么、去哪里时，答案有很大一部分在正文之外：一排带价格的商品卡片，或地图上的一串地点。现在这些内容会作为结构化字段出现在 text 旁边，并按 Gemini 展示的顺序排列，通过 position 就能知道哪个商品或地点排在最前。

price 的格式为 {value, currency, raw}，方便比较各商店的价格。每个地点都带有 placeId、包含 address、latitude 和 longitude 的 location，以及包含评分、评价数和来源的 reviews。商品卡片的名称也保留在 text 中，因此按回答正文统计提及次数的结果保持一致。

应用场景

• 跟踪你的商品是否出现在 Gemini 商品卡片中，排在第几位、价格多少。
• 查看在你的品类中，Gemini 把购物者引向哪些商店。
• 按街区查看 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": "GEMINI",
    "payload": {
      "prompt": "Best ramen near me",
      "country": "US",
      "location": { "latitude": 40.72927, "longitude": -73.98736 }
    }
  }'

请求字段

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。

payload.include.markdownboolean

设为 true 会附带 markdown：保留标题、列表、表格和链接的回答。

响应

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

{
  "success": true,
  "task": {
    "id": "685aad4a-3191-4215-9d2a-93ada8376185",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:51:49.105Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "**[IPPUDO NY](https://maps.google.com/?cid=13390953617500975094)** · ★ 4.4 (5,519) · Restaurant · 65 4th Ave, New York, NY 10003\n…",
    "map": [
      {
        "position": 4,
        "name": "IPPUDO NY",
        "category": "Restaurant",
        "location": {
          "address": "65 4th Ave, New York, NY 10003",
          "latitude": 40.730948,
          "longitude": -73.990287
        },
        "reviews": [
          { "count": 5519, "rating": 4.4, "providerName": "Google" }
        ],
        "phoneNumber": "+1 212-388-0088",
        "url": "https://www.ippudous.com/east-village",
        "mapsUrl": "https://maps.google.com/?cid=13390953617500975094"
      }
    ],
    "location": { "latitude": 40.72927, "longitude": -73.98736 }
  }
}

response.maparray

回答推荐的地点：名称、地址、坐标、评分、类别和地图链接。

response.shoppingCardsarray

与回答一同展示的商品卡片：标题、价格、商店、评分和商品链接。

response.inlineProductsarray

回答句子中带链接的商品名，含 position 和 productLink。

response.locationobject

回答所用的地点，与发送时相同：latitude 和 longitude。

获取结果

请求会立即返回 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"

价格

价格保持每个完成的任务 1 个积分，商品和地点均包含在内。