iebb/card-stations

What is it?

Key features

• 01Station CSVs cover Japanese IC, T-Union, Korean cards and U-money.
• 02Every card family uses the same column names.
• 03A build script validates data and generates SQLite, TSV and JSON outputs.
• 04Routing CSVs describe line edges, distances and stop order.
• 05Contributions are made through pull requests against the CSV files.

Use cases

• Building a transit app that needs station lists for Japanese IC or T-Union cards.
• Looking up station codes and coordinates for Korean transit cards or U-money.
• Generating a local SQLite station database from maintained CSV sources.
• Contributing corrections to transit station data with a reviewable diff.

Quick start

1. 1

   Check the data files build correctly

   python3 build.py --check
2. 2

   Run the test suite

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

   Build the generated SQLite, TSV and JSON outputs

   python3 build.py --output dist

Things to know

• !Generated output files are not stored in Git, so you must run the build yourself.
• !Data files are community-edited and some station records depend on imported sources with their own licenses.

In collections

Topics

FAQ

What is card-stations?

Community-editable CSV databases of station codes, names, lines and coordinates for Japanese IC, T-Union, Korean transit cards and U-money. Card Stations is a set of CSV files listing stations for several transit card systems: Japanese IC cards, China's T-Union, Korean transit cards, and U-money in Ulaanbaatar. Each row holds a station code, name, line, latitude and longitude, and an OpenStreetMap reference, with the same column names used across all card families.

Is card-stations free to use? What license does it have?

card-stations is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.

Is card-stations still maintained?

Actively maintained. The last commit to card-stations was on Nov 1, 2026.

What can I use card-stations for?

Building a transit app that needs station lists for Japanese IC or T-Union cards. Looking up station codes and coordinates for Korean transit cards or U-money. Generating a local SQLite station database from maintained CSV sources. Contributing corrections to transit station data with a reviewable diff.

How do I install card-stations?

Check the data files build correctly: python3 build.py --check Run the test suite: python3 -m unittest discover -s tests -v Build the generated SQLite, TSV and JSON outputs: python3 build.py --output dist

Where can I get card-stations?

The source code and installation instructions are on GitHub: https://github.com/iebb/card-stations