webSubway는 "지금 출발하면 몇 시 열차를 타는지"를 3초 안에 답하는 수도권 전철 경로 안내 웹앱입니다. 출발역·도착역을 고르면 실제 시간표로 탑승 시각과 도착 시각, 환승 도보 시간을 계산하고, 열차를 타는 순간부터 도착까지 한 화면(3D 디오라마)으로 진행 상황을 안내합니다. 서울시 실시간 지하철 API는 이 안내의 정확도를 높이는 데 씁니다. - 실시간 도착정보: 승차역으로 다가오는 내 방향 열차를 찾아 타는 시각을 시간표 대신 실제 도착 예정으로 바꿉니다. 환승역 2정거장 앞부터는 환승 열차도 같은 방식으로 잡습니다. - 실시간 열차 위치정보: 타고 있는 열차의 현재 역·상태(진입·도착·출발)를 시간표와 대조해 지연을 반영하고, 지연이 커져 환승을 놓치게 되면 다음 열차로 다시 계산합니다. 보정 근거(어느 역 기준, 몇 초 늦음, 도착이 어떻게 바뀌었는지)를 사용자에게 그대로 보여 줍니다. - 실시간 정보가 없는 노선·시간대에는 시간표로 자동 전환하고, 출처를 화면에 "시간표 / 실시간" 배지로 항상 표시합니다.

- 사용자가 "안내 시작"을 눌러 안내 화면을 열었을 때만 호출합니다. 홈·노선도·경로 검색 화면에서는 실시간 API를 부르지 않습니다. - 안내 화면에서 승차 전에는 도착정보를 30초 간격, 주행 중에는 열차 위치정보를 40초 간격으로 호출합니다(현재 20초, 등록과 함께 늘릴 예정). 정차 중이거나 승차까지 2분 넘게 남았을 때는 호출을 건너뜁니다. - 같은 역·노선 요청은 서버 프록시에서 10초 엣지 캐시로 합쳐 동시 사용자 수만큼 늘어나지 않습니다. - 응답은 그대로 저장하지 않으며 화면 표시에만 씁니다. 한도 초과(ERROR-337) 응답을 받으면 그날은 호출을 멈추고 시간표로 안내합니다.

서울시 지하철 실시간 도착정보