指南
解讀回應
無論在清單中、作為替代地點或作為通道,每個地點的結構都相同。每個鍵一律存在;null 代表未知或不適用。
要告訴使用者什麼
summary是一句話,可原樣轉述。warnings要依序最先讀給使用者。notes要轉述;diagnostics僅供你自己參考。attribution各行一律要顯示。
欄位
summary | 可直接轉述給使用者的一句話。 |
now.value | 分鐘數,僅在 now.usable 為 true 時有值。null 不等於零。 |
now.bound | exact、upper(「少於 N」)、lower(「多於 N」)或 range(value_low 到 value)。 |
now.reason | 沒有可用值的原因:closed、feed_paused、not_published、out_of_date… |
usual | 該星期幾、該時段的平常等候,附帶信賴度。 |
next | 隊伍何時降到門檻以下、最空閒的時段,以及建議出發時間。 |
instead | 附近同類的替代地點,結構相同,依總耗時排序。 |
notes | 需要轉述的提示,例如安全提示。 |
attribution | 必須顯示的來源說明。 |
數值
now.value僅在有最新的即時讀數時才有值。絕不要把now.last_value當作目前等候時間。upper讀作「少於 N 分鐘」,lower讀作「多於 N 分鐘」,range讀作「6–9 分鐘」。distance是直線距離(公里),絕不是開車時間。
涵蓋範圍
partial:可能有 Waity 未追蹤的更近地點,因此絕不要說結果是最近的。none:Waity 追蹤的地點中沒有相符項目。絕不要說什麼都不存在。