功能

接下來

地點累積足夠的歷史資料後，告訴你隊伍何時降到門檻以下、最空閒的時段、何時出發，以及逐小時預測。

它說明什麼

單一地點的回答（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 會說明原因。

因此新地點會直接說明，而不是猜測：告訴使用者還沒有預測，並報出即時等候。絕不要把營業時間當作最佳前往時間。

接下來