Guides
Reading an answer
Every place has the same shape, in a list, as an alternative or as a lane. Every key is always present; null means unknown or doesn't apply.
What to tell the user
summaryis one line, safe to repeat as is.warningsare read to the user first, in order.notesare repeated;diagnosticsare for you only.attributionlines are always shown.
Fields
summary | One line safe to repeat to the user. |
now.value | Minutes, set only when now.usable is true. Null is never zero. |
now.bound | exact, upper (“under N”), lower (“over N”) or range (value_low to value). |
now.reason | Why there is no usable value: closed, feed_paused, not_published, out_of_date… |
usual | The typical wait for this weekday and hour, with a confidence. |
next | When the line should drop under a threshold, the quietest hour and a leave-by time. |
instead | Nearby alternatives in the same shape, ranked by total time. |
notes | Lines to repeat to the user, such as safety notes. |
attribution | Source lines you must show. |
Numbers
now.valueis set only for a fresh live reading. Never presentnow.last_valueas the current wait.upperreads “under N min”,lower“over N min”, andrange“6–9 min”.distanceis straight-line km, never a drive time.
Coverage
partial: closer places may exist that Waity doesn't track, so never call the results the nearest.none: nothing Waity tracks matched. Never say nothing exists.