공항나우 (kr-airport-now)

전국 공항의 항공편 운항 정보와 인천국제공항의 주차 · 출국장 실시간 현황을 한 화면에서 보여 주는 모바일 웹앱. 공항에서 캐리어 끌면서 폰으로 3초에 판단하도록 만들었습니다.

• 전국 공항 도착·출발 항공편을 공항별로 한눈에 (한국공항공사 전국 운항현황)
• 인천은 여기에 더해 자리 많은 주차장 / 대기 짧은 출국장을 터미널(T1·T2)별로
• 모든 값에 관측 시각을 함께 표시 — 언제 받은 데이터인지 숨기지 않습니다
• 미운영을 미운영으로 표시 — 자리 0개·대기 0분·상태 미정을 단언하지 않습니다

데이터: 공공데이터포털 — 한국공항공사 전국 운항정보(B551178), 인천국제공항공사 주차 현황·출국장 혼잡도·항공편 상세(B551177).

데이터의 정직함에 대해

이 앱이 특히 조심하는 두 가지 함정이 있습니다. 둘 다 값이 0으로 오지만 뜻이 다릅니다.

필드	0 의 진짜 의미	이 앱의 처리
주차 parkingarea(총면수)	자리 0개가 아니라 미운영	잔여를 계산하지 않고 ‘미운영’으로 표시
출국장 waitTime(대기분)	대기 0분일 수도, 닫힌 게이트일 수도	운영시간 안이 확실할 때만 ‘원활’, 아니면 ‘정보 없음’

시각 필드(datetm, occurtime)는 타임존 표기가 없는 KST 벽시계 값이라, KST → UTC 인스턴트로 한 번에 확정한 뒤 표시할 때만 다시 KST 로 포맷합니다(lib/time.ts). 서버(UTC)·브라우저(로컬)에서 9시간 어긋나는 사고를 원천 차단합니다.

기술

Next.js 16 (App Router) · TypeScript · Tailwind v4 · shadcn/ui(base-ui) · Vercel(icn1, ISR 120초)

개발

npm install
cp .env.example .env.local   # DATA_GO_KR_KEY 를 채운다
npm run dev
npm test                     # 결측/미운영/시간대 로직 단위 테스트

인증키

data.go.kr 에서 인천국제공항공사 서비스(주차 · 출국장 혼잡도)에 활용신청 후 발급되는 ‘일반 인증키(Encoding)’를 DATA_GO_KR_KEY 에 넣습니다. 이미 %-인코딩된 문자열이라 절대 재인코딩하면 안 됩니다 — 재인코딩하면 SERVICE_KEY_IS_NOT_REGISTERED_ERROR 가 납니다. 그래서 쿼리스트링을 문자열로 직접 조립합니다(lib/incheon-api.ts).

한계

• 주차 총면수 0(미운영) 표본을 아직 못 봤습니다. 저녁 시간대엔 19개 구역 모두 운영 중이었습니다. 코드는 방어하지만, 심야에 실제로 어떻게 오는지는 추가 관측이 필요합니다.
• 현재값만 보여 줍니다. 만차 추세·정시성 같은 시계열은 없습니다(별도 데이터 누적 인프라 필요).
• 갱신 주기는 실측상 약 60초, 앱 캐시는 120초입니다. 표시 시각과 실제 사이에 최대 한두 텀 지연이 있을 수 있습니다.