iebb/card-stations

어떤 프로젝트인가요?

핵심 기능

• 01역 CSV는 일본 IC, T-Union, 한국 교통카드 및 U-money를 다룹니다.
• 02모든 카드 계열에서 같은 열 이름을 사용합니다.
• 03빌드 스크립트가 데이터를 검증하고 SQLite, TSV, JSON 형식으로 출력합니다.
• 04경로 CSV에 노선 연결 구간, 거리, 정차 순서가 기록됩니다.
• 05CSV 파일을 수정하고 pull request를 보내 기여할 수 있습니다.

활용 사례

• 일본 IC 카드나 T-Union의 역 목록이 필요한 교통 앱을 만들 때.
• 한국 교통카드나 U-money의 역 코드와 좌표를 조회할 때.
• 관리되는 CSV 원본에서 로컬 SQLite 역 데이터베이스를 생성할 때.
• 검토 가능한 diff를 통해 교통 역 정보의 오류를 수정할 때.

빠른 시작

1. 1

   데이터 파일이 올바르게 빌드되는지 확인하세요

   python3 build.py --check
2. 2

   테스트 스위트를 실행하세요

   python3 -m unittest discover -s tests -v
3. 3

   생성되는 SQLite, TSV, JSON 출력을 빌드하세요

   python3 build.py --output dist

사용 전 알아둘 점

• !생성된 출력 파일은 Git에 저장되지 않으므로 직접 빌드해야 합니다.
• !데이터 파일은 커뮤니티에서 편집하며, 일부 역 레코드는 각기 별도의 라이선스가 적용되는 가져온 데이터 소스에 의존합니다.

포함된 컬렉션

토픽

자주 묻는 질문

card-stations은(는) 무엇인가요?

일본 IC, T-Union, 한국 교통카드 및 U-money의 역 코드, 이름, 노선, 좌표를 담은 커뮤니티 편집형 CSV 데이터베이스입니다. Card Stations는 여러 교통카드 시스템의 역 정보를 정리한 CSV 파일 모음입니다. 일본 IC 카드, 중국 T-Union, 한국 교통카드, 울란바토르의 U-money를 지원합니다. 각 행에는 역 코드, 이름, 노선, 위도와 경도, OpenStreetMap 참조가 들어 있으며, 모든 카드 계열에서 같은 열 이름을 사용합니다.

card-stations은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

card-stations은(는) BSD-3-Clause 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

card-stations은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. card-stations의 마지막 커밋은 2026년 11월 1일입니다.

card-stations은(는) 어디에 사용할 수 있나요?

일본 IC 카드나 T-Union의 역 목록이 필요한 교통 앱을 만들 때. 한국 교통카드나 U-money의 역 코드와 좌표를 조회할 때. 관리되는 CSV 원본에서 로컬 SQLite 역 데이터베이스를 생성할 때. 검토 가능한 diff를 통해 교통 역 정보의 오류를 수정할 때.

card-stations는 어떻게 설치하나요?

데이터 파일이 올바르게 빌드되는지 확인하세요: python3 build.py --check 테스트 스위트를 실행하세요: python3 -m unittest discover -s tests -v 생성되는 SQLite, TSV, JSON 출력을 빌드하세요: python3 build.py --output dist

card-stations은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/iebb/card-stations