Query California hydrogen station status from the CLI!
(The tables will render correctly in your terminal if emojis are correctly configured).
-
🤔 Query the CAFCP's Station Operational Status System (SOSS) from the command line
-
🛰️ Use geolocation to locate nearest stations
-
⛳ Query stations near point of interest
You need npm or yarn installed. On macos, install homebrew and run brew install npm, on
Debian-flavored Linux, run sudo apt-get install npm.
Then, install globally using npm or yarn:
# With npm
npm install -g soss-cli
# With yarn
yarn global add soss-cliThe soss command will now be available.
Running without parameters will automatically print help.
soss nearestWill output a list of stations nearby. If you are running macos, CoreLocation will be used to locate you, otherwise we fallback to IP-based geolocation.
~ ❯❯❯ soss nearest ✘ 1
✔ Getting current location
✔ Getting station data
✔ Getting Station Status
╔═════════════╤═══════════════╤═════╤═════╤═════════════╤════════════════════════════════╗
║ 🚗 Distance│ 🏢 Name │ H35 │ H70 │ 🕒 Updated │ 💬 Message ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 1.67 mi │ West LA │ ❌ │ ❌ │ 11:28:45 AM │ The station is offline for mai ║
║ │ │ │ │ │ ntenance, and we expect to reo ║
║ │ │ │ │ │ pen around Thursday, 3/1. In t ║
║ │ │ │ │ │ he interim, customers can use ║
║ │ │ │ │ │ Santa Monica or other nearby s ║
║ │ │ │ │ │ tations. Please check back for ║
║ │ │ │ │ │ updates. We apologize for any ║
║ │ │ │ │ │ inconvenience. ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 3.54 mi │ Santa Monica │ ✅ │ ✅ │ 11:33:44 AM │ ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 4.64 mi │ Fairfax-LA │ ✅ │ ✅ │ 11:33:44 AM │ The Fairfax station will be of ║
║ │ │ │ │ │ fline for maintenance activiti ║
║ │ │ │ │ │ es all day on 3/6 through 3/7, ║
║ │ │ │ │ │ We will advise as soon as the ║
║ │ │ │ │ │ station returns to operation. ║
║ │ │ │ │ │ We apologize for any inconveni ║
║ │ │ │ │ │ ence this may cause. ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 7.42 mi │ Playa Del Rey │ ✅ │ ✅ │ 11:31:57 AM │ ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 7.50 mi │ Hollywood │ ✅ │ ✅ │ 11:21:55 AM │ ║
╚═════════════╧═══════════════╧═════╧═════╧═════════════╧════════════════════════════════╝
You can also ask for stations near a particular POI. We use openstreetmap to resolve addresses:
~ ❯❯❯ soss nearest disneyland
✔ Getting station data
✔ Getting Station Status
╔═════════════╤═══════════════╤═════╤═════╤═════════════╤════════════════════════════════╗
║ 🚗 Distance │ 🏢 Name │ H35 │ H70 │ 🕒 Updated │ 💬 Message ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 5.62 mi │ Anaheim │ ❌ │ ✅ │ 10:57:15 AM │ This station will reduce its e ║
║ │ │ │ │ │ nergy consumption (to reduce H ║
║ │ │ │ │ │ 2 costs!) between 12 midnight ║
║ │ │ │ │ │ to 5 AM daily. Safe, complet ║
║ │ │ │ │ │ e fills will still be achieved ║
║ │ │ │ │ │ during this period, they will ║
║ │ │ │ │ │ just require a few minutes lon ║
║ │ │ │ │ │ ger than routine. ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 10.72 mi │ UC Irvine │ ✅ │ ✅ │ 11:03:48 AM │ ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 11.16 mi │ Costa Mesa │ ✅ │ ✅ │ 11:02:09 AM │ ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 12.98 mi │ Newport Beach │ ✅ │ ✅ │ 11:09:00 AM │ ║
╟─────────────┼───────────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 14.16 mi │ Diamond Bar │ ✅ │ ⚠️ │ 11:03:47 AM │ ║
╚═════════════╧═══════════════╧═════╧═════╧═════════════╧════════════════════════════════╝
To query an individual station, you can use the status command:
~ ❯❯❯ soss status hayward
✔ Getting Station Status
✔ Getting station data
╔═══════╤═════════╤═════╤═════╤═════════════╤════════════════════════════════╗
║ 🆔 ID│ 🏢 Name│ H35 │ H70 │ 🕒 Updated │ 💬 Message ║
╟───────┼─────────┼─────┼─────┼─────────────┼────────────────────────────────╢
║ 15023 │ Hayward │ ✅ │ ✅ │ 11:02:13 AM │ ║
╚═══════╧═════════╧═════╧═════╧═════════════╧════════════════════════════════╝
Providing no argument will print all stations in the system.
This project is not affiliated in any way with the California Hydrogen Fuel Cell Partnership.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent