功能

接下来

地点有足够的历史数据后，告诉你队伍何时降到阈值以下、最空闲的时段、何时出发，以及逐小时预测。

它说明什么

单个地点的回答（GET /v1/places/{id} 或 get_wait 工具）始终带有 next 块。精简视图保留 under、under_status、under_by、best 和 summary；完整视图另加置信度和逐小时预测。

请求

`under`	阈值，单位为分钟。默认值：急诊室、紧急护理和边境通道为 30，DMV 为 20，机场为 15。
`travel_min`	到达所需的分钟数。会添加 `next.leave_by`。
`date`	当地日期，从今天到 7 天后，用于规划那一天，而不是接下来 24 小时。
`forecast`	在精简视图中添加简洁的逐小时预测。

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

响应

{
  "next": {
    "for_date": null,
    "summary": null,
    "based_on": "live",
    "under": 30,
    "under_status": "expected",
    "under_by": "2026-10-30T16:45:00-06:00",
    "best": {
      "from": "2026-10-31T01:00:00-06:00",
      "to": "2026-10-31T02:00:00-06:00",
      "value": 6
    },
    "leave_by": "2026-10-30T16:25:00-06:00",
    "confidence": "medium",
    "days_of_history": 23,
    "forecast": [
      {
        "at": "2026-10-30T14:00:00-06:00",
        "open": true,
        "open_minutes": 60,
        "value": 48
      },
      {

会降到阈值以下吗？

由 under_status 回答，预计会降下来时附带 next.under_by：

`already`	实时等待现在已等于或低于阈值。
`usually_under`	没有实时读数，但这个时段通常低于阈值。
`expected`	预测会降到阈值以下；`next.under_by` 给出时间。
`not_expected`	在预测时间范围内不会降到阈值以下。
`not_now`	实时等待高于阈值，且还没有预测能说明何时降下来。
`no_data`	没有实时读数，也没有预测。
`closed_all_day, closed_rest_of_day`	全天关闭，或当天余下时间关闭。
`not_published`	该地点不公布等待时间。

预测

next.forecast 为接下来 24 小时（或 date 指定的那一天）每小时提供一个时段：at、是否 open 及开放多少分钟，以及 value。next.confidence 取营业时段中最弱的一项，next.days_of_history 统计其背后的历史天数。

混入最新读数时 next.based_on 为 live，预测仅基于通常规律时为 usual。

最佳时间

next.best 是营业至少 45 分钟的最空闲时段，附带预计等待。对急诊室和紧急护理为 null，因为谁都不应给紧急情况挑时间；当天等待变化不大时也为 null。

出发时间

传入 travel_min 时，如果队伍已经（或通常）很短，next.leave_by 就是现在；否则是为了在队伍变短时到达而应出发的时间。预计不会降下来，或到达时已关门时为 null，并会有警告说明。

规划某一天

传入 date（最多 7 天后）时，next 覆盖那个当地日期：next.for_date 标明日期，next.summary 给出营业时间和最空闲的时段，可直接转述。地点当天关闭时显示 closed_all_day。

先要有足够的历史

预测值、next.under_by、next.best 和通常等待只在置信度为中或高时显示。这需要该时段至少 10 天的历史，且各小时之间的等待足够稳定。在此之前它们为 null，diagnostics 会说明原因。

因此新地点会如实说明，而不是猜测：告诉用户还没有预测，并报出实时等待。绝不要把营业时间当作最佳前往时间。

接下来