機能

この先

行列がしきい値を下回る時刻、最も空く時間帯、出発すべき時刻、1 時間ごとの予測を返します。場所に十分な履歴がたまってからです。

返す内容

1 つの場所の回答（GET /v1/places/{id} または get_wait ツール）には、常に next ブロックがあります。minimal ビューは under、under_status、under_by、best、summary を残し、full ビューは信頼度と 1 時間ごとの予測を加えます。

指定する

curl "https://api.waity.ai/v1/places/pl_6e3znhb7h9?under=30&travel_min=20&view=full" \
  -H "X-Api-Key: $WAITY_API_KEY"

{
  "next": {
    "for_date": null,
    "summary": null,
    "based_on": "live",
    "under": 30,
    "under_status": "expected",
    "under_by": "2026-10-30T16:45:00-06:00",
    "best": {
      "from": "2026-10-31T01:00:00-06:00",
      "to": "2026-10-31T02:00:00-06:00",
      "value": 6
    },
    "leave_by": "2026-10-30T16:25:00-06:00",
    "confidence": "medium",
    "days_of_history": 23,
    "forecast": [
      {
        "at": "2026-10-30T14:00:00-06:00",
        "open": true,
        "open_minutes": 60,
        "value": 48
      },
      {

しきい値を下回るか

under_status が答えます。下がる見込みがあるときは next.under_by も付きます：

予測

next.forecast には、次の 24 時間、または date の日について、1 時間ごとに 1 枠あります：at、open かどうかと何分間か、そして value。next.confidence は営業中の時間帯で最も低い値で、next.days_of_history はその元になった履歴の日数です。

最新の値を組み込んだときは next.based_on が live、予測が通常のパターンだけによるときは usual です。

最適な時間

next.best は 45 分以上開いている中で最も空く時間帯と、その予想待ち時間です。緊急時に時間を合わせるべきではないため、ER と urgent care では null です。1 日を通して変化が少ない場合も null です。

出発時刻

travel_min を指定すると、next.leave_by は、行列がすでに（または通常）短いときは今、そうでなければ行列が下がる頃に着くための出発時刻になります。下がる見込みがない場合や、閉まった後に着く場合は null で、警告でそう伝えます。

1 日の予定を立てる

date を指定すると（7 日先まで）、next はその現地の日を対象にします：next.for_date がその日を示し、next.summary が営業時間と最も空く時間を、そのまま伝えられる形で示します。休みの日は closed_all_day になります。

まず十分な履歴が必要

予測値、next.under_by、next.best、通常の待ち時間は、信頼度が中または高のときだけ表示されます。そのためには、その時間帯について少なくとも 10 日分の履歴と、時間ごとに十分安定した待ち時間が必要です。それまでは null で、diagnostics が理由を示します。

そのため、新しい場所は推測せずにそう伝えます：まだ予測がないことをユーザーに伝え、リアルタイムの待ち時間を引用してください。営業時間を行くのに最適な時間として示さないでください。

関連

回答の読み方 にすべてのフィールドの説明があります。パラメータは REST API と MCP に、すべてのフィールドは API リファレンス にあります。