機能

代わりに

ある場所の待ち時間が長いとき、Waity は同じ種類で待ち時間が短い近くの場所を示し、どれだけ短く、どれだけ遠いかを伝えます。

概要

1 つの場所の回答（GET /v1/places/{id} または get_wait ツール）には instead が入っています：最大 3 件の代わりの場所が良い順に並び、それぞれほかの場所と同じ形です。エージェントは 2 回目の検索なしで「橋は 55 分、Ysleta は 7 分」と伝えられます。

代わりの場所を取得する

instead は full ビューに入っています：REST には view=full を、get_wait（既定は minimal）には "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 の場所や、1 時間以内に閉まる場所は除きます。
短い場所だけで、長い場所は示しません：代わりの場所の待ち時間は、問い合わせた場所より短いか、同じでより近いかのどちらかです。
移動に見合うこと：短縮できる分数が、直線距離から推定した余分な移動時間より大きい必要があります。代わりの場所は移動時間と待ち時間の合計で順位を付けます。移動時間の推定値は返しません。
ER の代わりの場所の後に、urgent care が最大 2 件続くことがあります。urgent care だけが返ることはなく、その待ち時間を ER と比べることもありません。
閉まっている場所には、今開いていてリアルタイムの待ち時間がある代わりの場所を返します。date を指定すると、各代わりの場所のその日の最も空く時間帯が best_on_day に入ります。

問い合わせた場所との比較

各代わりの場所には vs_requested が入っています：

wait_diff_min：問い合わせた場所の待ち時間からこの場所の待ち時間を引いた値。正の値はこの場所の方が短いことを意味します。比べられない場合は null です。
extra_km：この場所がどれだけ遠いか（直線距離、km）。
note：wait_diff_min が null の理由、または独立型 ER であることなど、この場所について知っておくべきこと。そのまま伝えてください。

instead の 1 件

{
  "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,

決してしないこと

全年齢向けの場所にいる人に、子ども専用の ER や urgent care を示すことはありません。子ども向けの ER には、まずほかの子ども向けの ER、次に病院の ER を示し、独立型 ER は示しません。
問い合わせたレーン以上の条件が必要なレーンは示しません：一般レーンや標準レーンにいる人に SENTRI、NEXUS、Ready Lane は示さず、Ready Lane にいる人に SENTRI や NEXUS は示さず、空港では PreCheck や CLEAR を示しません。
測り方の違う分数は比べません。ER や urgent care を短いとして示すのは、両方の待ち時間が同じ情報源のものである場合だけです。そうでなければ分数は比べず、vs_requested.note にそう示されます。
独立型 ER であることを隠しません：place.facility: "freestanding_ed" でそれを示し、病院の ER の後に並べ、入院病床や手術の設備がないため重い症状の場合は病院へ転送されることを note に記します。
待ち時間が不明だからといって、ER や urgent care を離れるよう勧めることはありません。
人が越えられない境界は越えません：保安検査後につながっていない空港のターミナルや、別の国を通らないと行けない場所は示しません。

ER の安全

ER の回答にはすべて、この内容が warnings[0] と notes に入っています。代わりの場所を伝える前に、ユーザーに読み上げてください。

空の場合

条件を満たす場所がないとき、instead は空の一覧になり、diagnostics が理由を示します：移動時間を含めると短い場所がない、近くの待ち時間が測り方の違う情報源のものである、またはこの行列にいる人が使える場所が近くにない、のいずれかです。