功能
替代
某个地点等待较长时,Waity 会给出附近等待更短的同类地点,并说明短多少、远多少。
是什么
单个地点的回答(GET /v1/places/{id} 或 get_wait 工具)带有 instead:最多三个替代地点,最优的在前,每个的结构都与普通地点相同。智能体无需再次搜索,就能说“大桥要 55 分钟,Ysleta 只要 7 分钟”。
获取替代地点
instead 在完整视图中:对 REST 发送 view=full,对默认使用精简视图的 get_wait 发送 "view": "full"。两种视图都带有 links.alternatives,即对同一批地点的列表调用。
curl "https://api.waity.ai/v1/places/pl_6e3znhb7h9?view=full" \
-H "X-Api-Key: $WAITY_API_KEY"
如何挑选
- 同类地点:同一类别,先在 25 km 内找,再扩大到 40 km、60 km。机场通道只与同一机场的其他通道比较;边境通道还会与附近口岸的同类通道比较。
- 只用可用的实时等待:
now.usable为 false 或一小时内关闭的地点不纳入。 - 只会更短,绝不更长:替代地点的等待比所查询的地点短,或一样短但更近。
- 值得开车过去:节省的分钟数必须多于多出的车程(按直线距离估算)。替代地点按车程加等待排序;车程估算从不返回。
- 急诊室的替代地点之后,最多可能跟着两家紧急护理诊所。它们绝不会单独出现,其等待也绝不与急诊室比较。
- 已关闭的地点会得到现在营业且有实时等待的替代地点。传入
date时,每个替代地点会在best_on_day中给出当天最空闲的时段。
与所查询地点的比较
每个替代地点都带有 vs_requested:
wait_diff_min:所查询地点的等待减去这里的等待。正数表示这里更短;两者无法比较时为 null。extra_km:这里比所查询地点远多少,按直线距离计,单位 km。note:wait_diff_min为 null 的原因,或关于该地点需要知道的事,例如独立急诊室。请转述。
instead 中的一项
{
"place": {
"id": "pl_nvk0wkb3ps",
"name": "Ysleta Passenger Vehicles, Standard",
"category": "border",
"parent": {
"id": "pl_q4znr9abbj",
"name": "Ysleta-Zaragoza Bridge"
},
"open_now": true,
"opens_at": null,
"closes_at": null,
"timezone": "America/Denver",
"sample": false,
"facility": null,
"audience": "all",
"lane": "standard",
"url": "https://waity.ai/places/ysleta-passenger-vehicles-standard-kb3ps",
"api_url": "https://api.waity.ai/v1/places/pl_nvk0wkb3ps"
},
"summary": "About 7 min to enter the US, estimated by the border agency, updated 2 min ago.",
"now": {
"status": "live",
"usable": true,
绝不会做的事
- 绝不向身处全年龄地点的人推荐仅限儿童的急诊室或紧急护理。儿童急诊室先推荐其他儿童急诊室,再推荐医院急诊室,绝不推荐独立急诊室。
- 绝不推荐比所查询通道要求更多的通道:对普通或标准通道的人不推荐 SENTRI、NEXUS 或 Ready Lane,对 Ready Lane 的人不推荐 SENTRI 或 NEXUS,在机场不推荐 PreCheck 或 CLEAR。
- 绝不比较口径不同的分钟数。只有两个等待来自同一来源时,急诊室或紧急护理才会被列为更短;否则不比较分钟数,
vs_requested.note会说明。 - 绝不隐瞒独立急诊室的性质:
place.facility: "freestanding_ed"会标明,它排在医院急诊室之后,其提示说明它没有住院床位和手术条件,因此病情严重时会被转往医院。 - 绝不因为等待未知就建议离开急诊室或紧急护理诊所。
- 绝不跨越人无法跨越的界限:安检后不相通的机场航站楼,或只能经由另一个国家才能到达的地点。
急诊安全
每个急诊室回答都会在 warnings[0] 和 notes 中说明这一点。在给出任何替代地点之前,先读给用户听。
为空时
没有符合条件的地点时,instead 是空列表,diagnostics 会说明原因:算上车程后没有更短的;附近的等待来自口径不同的来源;或者附近没有这条队伍里的人能用的其他地点。