Data stack anatomy

판정 하나에 데이터 네 축이 들어갑니다.

공공데이터포털 184건과 경기데이터드림 2,265건을 전수 조사하고, 후보 전부를 실제 요청·응답으로 검증해 남긴 스택입니다. 문서가 아니라 실호출이 채택 기준입니다. 아래 장면의 요소를 선택하면 그 데이터가 무엇이고, 왜 쓰고, 무엇을 기대할 수 있는지 보여줍니다.

실시간GBIS 도착·위치. 잔여 좌석이 있는 유일한 실시간 소스.
기준정보GBIS 마스터 6종. 배차·첫막차·정류장 순번을 쿼터 0으로.
수요 이력경기데이터드림. 33개월 승하차와 차량별 정원.
독립 실측교통카드 재차인원. 좌석 관측과 무관한 검증 축.
안양역 방면 → 판교역 의왕청계 안양역
도로 위 실시간 관측 (GBIS) 카드 이력·기준정보 (마스터·데이터드림·stcis) 주황 강조 현재 선택한 데이터

판정 한 번의 데이터 흐름

이번 주 프로토타입은 호출 한 번으로 됩니다.

직전 버스의 잔여석은 예측이 아니라 관측입니다. 위치 응답에는 내 정류장을 이미 지난 차량도 들어 있어, 수집기도 DB도 없이 판정 입력을 얻습니다. 도착정보는 접근 중인 버스만 주므로 "다음 버스가 언제·몇 석" 표시를 맡습니다.

실시간 1콜getBusLocationListv2(routeId)지나간 직전 버스 잔여 2석
정원 사전 lookupcapacity[vehId] = 45만석 여부 판정
확률 상수 lookupP(만석→만석) = 53.4%탑승확률 표시

다음 주 「몇 대」부터는 이력 축이 실측 분포를 만들고, 재차인원이 그 분포를 검증합니다.

위치 API 주기 수집getBusLocationListv2연속 만석 관측
실측 분포연속 만석 길이 분포“2대 보내세요”
독립 검증stcis 재차인원 대조분포가 현실과 맞는지

프로토타입 대비

기존 수집기의 API 3종은 이렇게 됩니다.

기존 프로토타입은 GBIS 위치 API 하나로 20일치 관측을 쌓아 만든 모델이었습니다. 이번 조사로 위치 축은 유지하고, 기준정보 축은 마스터 파일로 바꾸고, 판정·정원·수요·검증 축을 새로 얻었습니다.

유지

차량 위치·좌석

getBusLocationListv2

프로토타입 수집기의 핵심 호출 그대로. 직전 버스 판정과 연속 만석 관측 수집에 계속 쓴다. 관측 의미론(도착 기준 잔여석, crowded=0은 미제공)도 그대로 유효.

마스터로 대체

노선 검색 · 정류장 목록

getBusRouteListv2 getBusRouteStationListv2

route·routestation 마스터로 대체. 전 노선을 1회 다운로드로 덮어 실시간 쿼터를 쓰지 않고, 상하행 구분은 마스터에만 있다. API는 마스터 검증용으로만 남긴다.

신규

판정·정원·수요·검증

getBusArrivalListv2 TBBMSVEHHISTM · LINEBUSANULUSERCNT stcis 재차인원

프로토타입에 없던 축. 정류소 1콜 판정, 차량별 정원 103대, 33개월 수요 사전, 좌석과 독립인 실측 인원을 얻었다.

검증 등급

"검증했다"에도 등급이 있습니다.

이 페이지의 모든 숫자는 셋 중 하나의 방법으로 확인한 값입니다. 등급이 낮을수록 운영 의존을 피하고 검증·참고용으로만 씁니다.

1등급 · 공식 API 실호출

GBIS 12종 · 데이터드림 28종

apis.data.go.kr · openapi.gg.go.kr

정식 공개 계약. 실제 요청·응답으로 필드와 값의 의미까지 확정했고, 운영 파이프라인이 직접 호출한다. 스웨거 명세 2종이 이 등급의 기록이다.

2등급 · 원천 데이터 전량 검증

정류소별 승하차 집계

포털 내부 시트 엔드포인트 · 30,030행

공식 API가 없는 데이터. 원천을 전량 받아 값은 검증했지만 경로가 공식 계약이 아니라서, 운영 적재는 공식 경로(로그인 파일)로 한다.

3등급 · 화면 조회

stcis 재차인원

대민포털 피벗 화면 · 재현 스크립트

공식 API 자체가 없다. 화면 조회를 자동화해 값을 확보했고, 집계 방식 정의가 확정될 때까지 상대 비교·교차 검증에만 쓴다.

없는 데이터 사전

이 데이터는 안 쓰는 게 아니라, 없습니다.

전수 조사에서 실호출로 확인한 부재 목록입니다. 회의에서 “이거 쓰면 되지 않아?”가 나오면 이 사전부터 확인합니다.

실시간 재차·혼잡 API

국토부 재차인원 → 경기 NO_DATA_FOUND TAGO → 응답 8필드에 좌석 관련 0개

국토부 재차인원은 비수도권 5개 광역시·제주 대상 합성 사업. 경기도의 실시간 좌석은 GBIS가 유일하다.

정류장 수요의 지름길

서울 승하차 657개 노선 → 전부 서울 면허 티머니 → B2B 제휴 전용

서울 데이터는 지리가 아니라 면허 기준이라 1650이 서울 19개 정류장을 지나도 미수록. 정류장 해상도 수요는 경기 파일(일 단위)뿐이다.

고정밀 위치

초정밀버스 → 경기 stdgCd 전부 0건

경기도는 GNSS 참여 지자체가 아니다. 위치 해상도는 GBIS 정류장 순번이 상한. 분기 1회만 재확인한다.

남은 확인

외부 요인 대기 6건

전부 우리 쪽이 아니라 바깥이 막고 있는 항목입니다. 풀리는 대로 이 페이지와 명세를 갱신합니다.