주요기능 소개

1. DIA 기반 자동 알람 설정

• QR코드 스캔 또는 목록에서 DIA 번호를 선택하면, 해당 DIA에 포함된 교대 시각에 맞춰 자동으로 알람이 설정됩니다.
• 교대 시각 5분·10분·15분 전 등 사용자가 설정한 시간 간격으로 알람을 1~3개 생성합니다.

2. 실시간 열차 위치 조회

• realtimePosition API를 활용하여 DIA에 포함된 열차번호의 현재 운행 위치를 실시간으로 표시합니다.
• 각 열차의 현재역, 운행 상태(진입/도착/출발), 상행·하행 방향, 노선명 등을 한 화면에서 확인할 수 있습니다.
• 30초 자동 갱신으로 최신 상태를 유지하며, 수동 새로고침도 가능합니다.

3. 열차 접근 알림 (GPS 연동)

• 백그라운드 Foreground Service가 30초마다 API를 호출하여 열차 위치를 조회합니다.
• 승무원의 GPS 위치와 열차가 위치한 역의 좌표를 비교하여, 반경 5km 이내에 열차가 접근하면 소리·진동과 함께 알림을 자동 발송합니다.
• 열차별 최초 1회만 알림을 보내 반복 알림에 의한 불편을 방지합니다.
• 화면이 꺼져 있어도 WakeLock 및 배터리 최적화 제외를 통해 지속적으로 추적합니다.

4. DIA 자동 초기화

• 마지막 알람 시각으로부터 60분 후 AlarmManager에 의해 DIA 정보가 자동 초기화되며, 열차 추적 서비스도 자동 종료됩니다.
• 다음 근무 시 새로운 DIA를 선택하면 자동으로 새 교대 알람과 열차 추적이 시작됩니다.

5. Google Sheets 연동 DIA 데이터 관리

• 소속별 DIA 데이터(교대 시각, 열차번호)를 Google Sheets에서 다운로드하여 오프라인에서도 사용 가능합니다.
• DIA 데이터 수동 업로드(CSV)도 지원합니다.

1. 앱 개요 승무원 알람은 한국철도공사(KORAIL) 수도권 전철 승무원의 교대 업무를 지원하는 Android 애플리케이션입니다. 승무원은 하루에 여러 차례 정해진 시각에 교대역에서 열차에 탑승해야 하며, 교대 시각을 놓치면 열차 운행에 직접적인 차질이 발생합니다. 본 앱은 서울시 지하철 실시간 열차 위치정보(realtimePosition) API를 활용하여, 승무원이 탑승해야 할 열차가 현재 어디를 운행 중인지 실시간으로 확인하고, 해당 열차가 승무원의 현재 위치 반경 5km 이내에 접근하면 자동으로 알림을 보내는 기능을 제공합니다. 2. 활용 배경 수도권 전철 승무원은 근무 중 DIA(열차운전시각표)에 따라 하루 2~4회 교대를 합니다. 교대 시각 전에 교대역에 도착하여 대기해야 하지만, 열차가 지연·변경되는 경우도 있어 실제 열차 위치를 실시간으로 파악할 필요가 있었습니다. 기존에는 역무실에 확인 전화를 하거나, 별도의 시스템을 통해 열차 위치를 확인했으나, 본 앱을 통해 승무원 개인 휴대폰에서 즉시 확인할 수 있게 되었습니다. 3. API 활용 방식 사용 API: 서울시 지하철 실시간 열차 위치정보 (realtimePosition) 호출 주기: 30초 간격으로 Foreground Service에서 백그라운드 호출 활용 노선: 1호선, 수인분당선(수인선, 분당선 포함), 경의중앙선, 경춘선, 4호선 등 주요 활용 데이터: 열차번호(trainNo), 현재역(statnNm), 노선명(subwayNm), 열차상태(trainSttus)

서울시 지하철 실시간 열차 위치정보