Funktionen
Später
Wann die Schlange unter deinen Schwellenwert fallen sollte, die ruhigste Stunde, wann du losfahren solltest und eine stündliche Prognose, sobald ein Ort genug Verlauf hat, um das zu sagen.
Was es sagt
Die Antwort für einen Ort, GET /v1/places/{id} oder das Tool get_wait, hat immer einen next-Block. Die minimale Ansicht behält under, under_status, under_by, best und summary; die volle Ansicht ergänzt die Konfidenz und die stündliche Prognose.
Abfragen
under | Der Schwellenwert in Minuten. Standard: 30 für Notaufnahmen, Urgent Care und Grenzspuren, 20 für DMVs, 15 für Flughäfen. |
travel_min | Minuten bis dorthin. Ergänzt next.leave_by. |
date | Ein lokales Datum, heute bis 7 Tage im Voraus, um diesen Tag zu planen statt der nächsten 24 Stunden. |
forecast | Ergänzt in der minimalen Ansicht eine kompakte stündliche Prognose. |
curl "https://api.waity.ai/v1/places/pl_6e3znhb7h9?under=30&travel_min=20&view=full" \
-H "X-Api-Key: $WAITY_API_KEY"
Antwort
{
"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
},
{
Fällt sie unter den Schwellenwert?
under_status antwortet, mit next.under_by, wenn ein Rückgang erwartet wird:
already | Die Live-Wartezeit liegt jetzt am oder unter dem Schwellenwert. |
usually_under | Kein Live-Wert, aber zu dieser Stunde liegt sie meist darunter. |
expected | Die Prognose fällt darunter; next.under_by sagt, wann. |
not_expected | Die Prognose fällt im Zeitfenster nicht darunter. |
not_now | Die Live-Wartezeit liegt darüber, und es gibt noch keine Prognose, die sagt, wann sie fällt. |
no_data | Kein Live-Wert und keine Prognose. |
closed_all_day, closed_rest_of_day | Den ganzen Tag geschlossen oder für den Rest des Tages. |
not_published | Der Ort veröffentlicht seine Wartezeit nicht. |
Prognose
next.forecast hat einen Slot pro Stunde für die nächsten 24 Stunden oder für den Tag in date: at, ob der Ort open ist und wie viele Minuten lang, und value. next.confidence ist die schwächste über die geöffneten Stunden, und next.days_of_history zählt die Tage Verlauf dahinter.
next.based_on ist live, wenn der neueste Messwert einfließt, und usual, wenn die Prognose allein das übliche Muster ist.
Beste Zeit
next.best ist die ruhigste Stunde, die mindestens 45 Minuten geöffnet ist, mit ihrer erwarteten Wartezeit. Bei Notaufnahmen und Urgent Care ist sie null, weil niemand einen Notfall planen sollte, ebenso wenn der Tag gleichmäßig verläuft.
Losfahrzeit
Mit travel_min ist next.leave_by jetzt, wenn die Schlange schon (oder meist) kurz ist, sonst der Zeitpunkt zum Losfahren, um anzukommen, wenn sie fällt. Sie ist null, wenn kein Rückgang erwartet wird oder du erst nach Schließung ankämst; eine Warnung sagt das.
Einen Tag planen
Mit date, bis zu 7 Tage im Voraus, deckt next diesen lokalen Tag ab: next.for_date nennt ihn, und next.summary gibt die Öffnungszeiten und die ruhigste Zeit an, fertig zum Weitergeben. An einem Tag, an dem der Ort geschlossen ist, steht closed_all_day.
Zuerst genug Verlauf
Prognosewerte, next.under_by, next.best und die übliche Wartezeit erscheinen nur bei mittlerer oder hoher Konfidenz. Dafür braucht es für die Stunde mindestens 10 Tage Verlauf und Wartezeiten, die von Stunde zu Stunde stabil genug sind. Bis dahin sind sie null, und diagnostics sagt warum.
So sagt ein neuer Ort das, statt zu raten: Sag dem Nutzer, dass es noch keine Prognose gibt, und nenne die Live-Wartezeit. Gib Öffnungszeiten nie als beste Zeit für einen Besuch aus.
Siehe auch
Eine Antwort lesen erklärt jedes Feld. Die Parameter stehen in REST-API und MCP, jedes Feld steht in der API-Referenz.