다음 \ Waity

기능

장소에 충분한 기록이 쌓이면, 줄이 기준 아래로 줄어드는 시점, 가장 한산한 시간, 출발 시각, 시간별 예측을 알려 줍니다.

알려 주는 것

한 장소에 대한 응답(GET /v1/places/{id} 또는 get_wait 도구)에는 항상 next 블록이 있습니다. minimal 보기에는 under, under_status, under_by, best, summary가 남고, 전체 보기에는 신뢰도와 시간별 예측이 더해집니다.

요청

`under`	기준 시간(분). 기본값: 응급실, 긴급 진료소, 국경 레인은 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분 이상 열려 있는 가장 한산한 시간과 그 예상 대기 시간입니다. 응급 상황은 시간을 맞춰 갈 일이 아니므로 응급실과 긴급 진료소에서는 null이며, 하루 내내 대기 시간이 비슷할 때도 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가 이유를 알려 줍니다.

그래서 새 장소는 추측하지 않고 그렇다고 알려 줍니다: 사용자에게 아직 예측이 없다고 말하고 실시간 대기 시간을 전하세요. 영업 시간을 가장 좋은 방문 시간으로 제시하지 마세요.

다음