指南
位置与安全
用户所在位置决定返回哪些地点。请明确发送位置,不要放进 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 中:请转述。