功能
替代
某個地點等候較久時,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 會說明原因:算上車程後沒有更短的;附近的等候來自口徑不同的來源;或附近沒有這條隊伍裡的人能用的其他地點。