指南
解读响应
无论在列表中、作为替代地点还是作为通道,每个地点的结构都相同。每个键始终存在;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 追踪的地点中没有匹配项。绝不要说什么都不存在。