指南
位置與安全
使用者所在位置決定回傳哪些地點。請明確傳送位置,不要放進 URL,也絕不要讓猜測來選擇急診室。
傳送位置
以 X-Waity-Location: lat,lng 標頭傳送使用者位置:這樣位置不會出現在 URL 與記錄中。也可以用 near,或在 q 中寫城市或 ZIP。
curl "https://api.waity.ai/v1/places?category=border&view=minimal" \
-H "X-Waity-Location: 31.759,-106.487"
不知道使用者在哪裡時
呼叫前先詢問使用者的城市或 ZIP,或經緯度。
Waity 何時會猜測
僅限 REST GET /v1/places 收到不帶位置的「我附近」問題,且請求來自家用寬頻網路、使用瀏覽器或類似 curl 的用戶端時。對 MCP、get_wait、雲端或資料中心網路、VPN、行動網路、網頁中的指令碼以及 AI 代理,一律不猜測。此時回答中會註明 query.resolved.source: "ip"。
拒絕猜測
傳送 X-Waity-Location: none,Waity 就絕不會猜測;該請求視為沒有位置。
curl
curl "https://api.waity.ai/v1/places?q=ER+near+me&view=minimal" \
-H "X-Waity-Location: none"
急診室回答
- 位置為估算時,
warnings[1]會說明:選擇急診室前先詢問真實位置。 - Waity 只追蹤部分急診室與緊急照護診所,因此其清單的 coverage 為 partial:絕不要說結果是最近的。
安全規則
- 緊急照護只適用於輕微疾病或受傷,絕不適用於緊急情況。
- 邊境等候時間僅適用於入境美國;Waity 沒有出境的等候時間。
- 地點規則(例如檢查站對應哪些登機門,或 DMV 號碼計算的是什麼)會寫在每個回答的 notes 中:請轉述。