An interactive Taipei YouBike 2.0 real-time station map built with Leaflet. The page reads Taipei City's public live YouBike data and shows available bikes, return slots, high-level KPIs, a station list, and filtering tools.
- Displays Taipei YouBike 2.0 stations in real time
- Uses marker color and size to represent available bike counts
- Shows total stations, available bikes, return slots, empty stations, and overall bike availability rate
- Supports station name and address search (Chinese and English, case-insensitive)
- Supports filters for all stations, stations with bikes, empty stations, and full stations
- Supports sorting by most bikes, most return slots, station name, or distance from you
- Opens the station popup and moves the map when a station is selected from the list
- Supports dark/light theme switching and remembers the preference; follows the system setting on first visit
- Supports current-location positioning, which also enables distance-based sorting
- Refreshes data automatically every 60 seconds, with manual refresh support, and keeps retrying after a network outage
- Surfaces refresh failures as a toast while keeping the previously loaded data on screen
- On mobile, the map sits above a collapsible station list so the map can take the full screen
- Keyboard shortcuts:
/focuses search,Escclears it,Rrefreshes - Honors
prefers-reduced-motionby disabling animations
This is a static frontend project with no package installation required. Because it uses ES modules, run it through a local HTTP server instead of opening it directly with file://.
python3 -m http.server 8000Then open:
http://127.0.0.1:8000/
.
├── README.md
├── README.zh-TW.md
├── LICENSE
├── index.html # Page structure
├── youbike-map.css # Visual styles and responsive layout
├── youbike-map.js # App entry point, initialization, and event binding
├── youbike-config.js # API URL, refresh interval, and initial map settings
├── youbike-state.js # Shared application state
├── youbike-utils.js # Data cleanup, number conversion, HTML escaping, debounce
├── youbike-dom.js # DOM references, loading state, and error state
├── youbike-map-view.js # Leaflet map, layers, markers, popups, location, theme
└── youbike-stations.js # Station loading, filtering, list rendering, KPIs, refresh
Live station data comes from Taipei City's public YouBike 2.0 JSON endpoint:
https://tcgbusfs.blob.core.windows.net/dotapp/youbike/v2/youbike_immediate.json
Map rendering uses:
- Leaflet
- OpenStreetMap
- CARTO basemap
youbike-map.jsis the entry point and the best place to start when tracing event flow.- Map behavior is grouped in
youbike-map-view.js. - Station data and KPI logic are grouped in
youbike-stations.js. - Change refresh frequency or the default map center in
youbike-config.js. - Change layout, visual style, or mobile behavior in
youbike-map.css.