T map API Data

_{2026-06-09 Jonghyun Park w/ Claude}

T map 대중교통 API(무료)를 활용하여 서울 지하철 네트워크를 분석하는 Python 프로젝트입니다.

분석 항목

1. Hub Station Ranking (tmap_hub_analysis.py)

서울 주요 10개 출발-도착 쌍의 경로를 조회하고, 경유 빈도를 집계하여 허브 역 순위를 산출합니다.

2. Major Transfer Station Matrix (tmap_major_hubs.py)

20개 주요 환승역 간 최단 소요시간, 직통 노선, 빈출 노선 등을 분석합니다.

3. Train Congestion Heatmap (tmap_congestion_heatmap.py)

역별·시간대별 혼잡도 히트맵 생성 — 10분 단위 평균 혼잡도 집계, 요일별 조회 지원

4. Smart Pair Selector (tmap_top10_pairs.py)

지리적 거리와 방향 다양성 기반으로 최적의 역 쌍을 선정하는 오프라인 유틸리티입니다.

무료 API 제약 대응

T map 대중교통 API 무료 플랜은 일 10회 호출 제한이 있습니다. 각 스크립트는:

• 1회 실행 시 최대 10쌍만 조회
• 이미 조회한 쌍은 CSV에서 확인 후 스킵
• 여러 날에 걸쳐 실행하면 데이터가 누적됩니다

Requirements

pip install requests pandas matplotlib seaborn

• Python 3.10+

Setup

1. SK Open API에서 T map API 앱키 발급
2. 각 스크립트의 API_KEY = "input_yours" 부분에 앱키 입력

Usage

# 허브 역 분석 (API 10회 사용)
python tmap_hub_analysis.py

# 주요 환승역 매트릭스 (API 10회 사용, 2일+ 실행 권장)
python tmap_major_hubs.py

# 혼잡도 히트맵 (역 10개 × 시간대 19개 = 190회 호출)
python tmap_congestion_heatmap.py

# 단일 역 API 테스트
python test_one.py

# 최적 역 쌍 선정 (오프라인, API 불필요)
python tmap_top10_pairs.py

Output

• station_log.csv — 경유 역 로그
• route_log.csv — 경로 로그
• major_route_log.csv — 환승역 경로 로그

License

MIT