跳至主要內容

功能

替代

某個地點等候較久時,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"

如何挑選

與所查詢地點的比較

每個替代地點都帶有 vs_requested:

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,

絕不會做的事

急診安全

每個急診室回答都會在 warnings[0] 與 notes 中說明這一點。在提供任何替代地點之前,先讀給使用者聽。

為空時

沒有符合條件的地點時,instead 是空清單,diagnostics 會說明原因:算上車程後沒有更短的;附近的等候來自口徑不同的來源;或附近沒有這條隊伍裡的人能用的其他地點。

相關內容

解讀回應 說明了替代地點的每個欄位。參數見 REST API 與 MCP,所有欄位見 API 參考。

必要 Cookie 讓網站正常運作,選用的分析 Cookie 協助我們改善網站。詳見隱私權政策與條款。