फ़ीचर

आगे

लाइन कब आपकी सीमा से नीचे आएगी, सबसे शांत घंटा, कब निकलना है, और घंटे-दर-घंटे पूर्वानुमान, जब किसी जगह का इतना इतिहास हो जाए कि वह बता सके।

यह क्या बताता है

एक जगह के जवाब में, GET /v1/places/{id} या get_wait टूल से, हमेशा एक next ब्लॉक होता है। minimal व्यू में under, under_status, under_by, best और summary रहते हैं; पूरा व्यू भरोसे का स्तर और घंटे-दर-घंटे पूर्वानुमान जोड़ता है।

माँगें

`under`	मिनट में सीमा। डिफ़ॉल्ट: ER, अर्जेंट केयर और बॉर्डर लेन के लिए 30, DMV के लिए 20, एयरपोर्ट के लिए 15।
`travel_min`	वहाँ पहुँचने में लगने वाले मिनट। `next.leave_by` जोड़ता है।
`date`	एक स्थानीय तारीख, आज से 7 दिन आगे तक, ताकि अगले 24 घंटों की जगह उस दिन की योजना बने।
`forecast`	minimal व्यू के साथ, एक छोटा घंटे-दर-घंटे पूर्वानुमान जोड़ता है।

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 के साथ:

`already`	लाइव इंतज़ार अभी सीमा पर या उससे नीचे है।
`usually_under`	कोई लाइव रीडिंग नहीं, पर इस घंटे यह आम तौर पर सीमा से नीचे रहता है।
`expected`	पूर्वानुमान इसके नीचे जाता है; `next.under_by` बताता है कब।
`not_expected`	विंडो के अंदर पूर्वानुमान इसके नीचे नहीं जाता।
`not_now`	लाइव इंतज़ार इससे ऊपर है, और अभी कोई पूर्वानुमान नहीं है जो बताए कि यह कब घटेगा।
`no_data`	न कोई लाइव रीडिंग, न कोई पूर्वानुमान।
`closed_all_day, closed_rest_of_day`	पूरे दिन बंद, या दिन के बाकी समय के लिए बंद।
`not_published`	यह जगह अपना इंतज़ार प्रकाशित नहीं करती।

पूर्वानुमान

next.forecast में अगले 24 घंटों के लिए, या date वाले दिन के लिए, हर घंटे का एक स्लॉट होता है: at, क्या जगह open है और कितने मिनट के लिए, और value। next.confidence खुले घंटों में सबसे कमज़ोर स्तर है, और next.days_of_history उसके पीछे के इतिहास के दिन गिनता है।

next.based_on तब live होता है जब ताज़ा रीडिंग शामिल की जाती है, और usual तब जब पूर्वानुमान सिर्फ़ आम पैटर्न पर आधारित हो।

सबसे अच्छा समय

next.best वह सबसे शांत घंटा है जिसमें जगह कम से कम 45 मिनट खुली हो, अनुमानित इंतज़ार के साथ। ER और अर्जेंट केयर के लिए यह null होता है, क्योंकि किसी को इमरजेंसी का समय तय नहीं करना चाहिए, और तब भी जब पूरे दिन इंतज़ार लगभग एक जैसा हो।

कब निकलें

travel_min के साथ, next.leave_by अभी का समय होता है जब लाइन पहले से (या आम तौर पर) छोटी हो, वरना वह समय जब निकलने पर आप लाइन घटते ही पहुँचें। जब गिरावट की उम्मीद न हो, या आप बंद होने के बाद पहुँचेंगे, तो यह null होता है; एक चेतावनी यह बताती है।

एक दिन की योजना

date के साथ, 7 दिन आगे तक, next उस स्थानीय दिन को कवर करता है: next.for_date उस दिन को बताता है, और next.summary खुलने के घंटे और सबसे शांत समय बताता है, दोहराने के लिए तैयार। जिस दिन जगह बंद हो, उस दिन closed_all_day लिखा होता है।

पहले पर्याप्त इतिहास

पूर्वानुमान की वैल्यू, next.under_by, next.best और आम इंतज़ार सिर्फ़ मध्यम या उच्च भरोसे पर दिखते हैं। इसके लिए उस घंटे का कम से कम 10 दिन का इतिहास चाहिए, और घंटे-दर-घंटे काफ़ी स्थिर इंतज़ार। तब तक ये null रहते हैं, और diagnostics बताता है क्यों।

इसलिए नई जगह अंदाज़ा लगाने के बजाय यही बताती है: यूज़र को बताएँ कि अभी कोई पूर्वानुमान नहीं है और लाइव इंतज़ार बताएँ। खुलने के घंटों को कभी जाने का सबसे अच्छा समय न बताएँ।

आगे