ガイド

位置情報と安全

ユーザーの居場所によって、返る場所が決まります。位置情報は明示的に送り、URL に含めず、推測で ER を選ばせないでください。

位置情報を送る

ユーザーの位置情報は 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、または lat と lng を聞いてください。

Waity が推測する場合

REST の GET /v1/places で「近くの」という質問に位置情報がなく、家庭のブロードバンド回線から、ブラウザまたは curl のようなクライアントで呼ばれた場合だけです。MCP、get_wait、クラウドやデータセンターの回線、VPN、モバイル回線、ウェブページ内のスクリプト、AI エージェントでは推測しません。その場合、回答には query.resolved.source: "ip" と表示されます。

推測を無効にする

X-Waity-Location: none を送ると Waity は推測せず、リクエストは位置情報なしとして扱われます。

curl "https://api.waity.ai/v1/places?q=ER+near+me&view=minimal" \
  -H "X-Waity-Location: none"

ER の回答

• 位置情報が推定された場合は warnings[1] がそれを伝えます：ER を選ぶ前に実際の位置を聞いてください。
• Waity が追跡しているのは一部の ER と urgent care だけなので、その一覧の coverage は partial です：結果を最寄りと言わないでください。

安全のルール

• urgent care は軽い病気やけがのためのもので、緊急時には使えません。
• 国境の待ち時間は米国への入国のみです。出国の待ち時間は Waity にはありません。
• 検問所が対応するゲートや DMV の番号が何を数えるかといった場所ごとのルールは、各回答の notes に入っています：そのまま伝えてください。