跳到主要内容

功能

替代

某个地点等待较长时,Waity 会给出附近等待更短的同类地点,并说明短多少、远多少。

是什么

单个地点的回答(GET /v1/places/{id} 或 get_wait 工具)带有 instead:最多三个替代地点,最优的在前,每个的结构都与普通地点相同。智能体无需再次搜索,就能说“大桥要 55 分钟,Ysleta 只要 7 分钟”。

获取替代地点

instead 在完整视图中:对 REST 发送 view=full,对默认使用精简视图的 get_wait 发送 "view": "full"。两种视图都带有 links.alternatives,即对同一批地点的列表调用。

curl "https://api.waity.ai/v1/places/pl_6e3znhb7h9?view=full" \
  -H "X-Api-Key: $WAITY_API_KEY"

如何挑选

与所查询地点的比较

每个替代地点都带有 vs_requested:

instead 中的一项

{
  "place": {
    "id": "pl_nvk0wkb3ps",
    "name": "Ysleta Passenger Vehicles, Standard",
    "category": "border",
    "parent": {
      "id": "pl_q4znr9abbj",
      "name": "Ysleta-Zaragoza Bridge"
    },
    "open_now": true,
    "opens_at": null,
    "closes_at": null,
    "timezone": "America/Denver",
    "sample": false,
    "facility": null,
    "audience": "all",
    "lane": "standard",
    "url": "https://waity.ai/places/ysleta-passenger-vehicles-standard-kb3ps",
    "api_url": "https://api.waity.ai/v1/places/pl_nvk0wkb3ps"
  },
  "summary": "About 7 min to enter the US, estimated by the border agency, updated 2 min ago.",
  "now": {
    "status": "live",
    "usable": true,

绝不会做的事

急诊安全

每个急诊室回答都会在 warnings[0] 和 notes 中说明这一点。在给出任何替代地点之前,先读给用户听。

为空时

没有符合条件的地点时,instead 是空列表,diagnostics 会说明原因:算上车程后没有更短的;附近的等待来自口径不同的来源;或者附近没有这条队伍里的人能用的其他地点。

相关内容

解读响应 解释了替代地点的每个字段。参数见 REST API 和 MCP,所有字段见 API 参考。

必要 Cookie 用于保障网站正常运行,可选的分析 Cookie 帮助我们改进网站。详见隐私政策和条款。