https://github.com/no2chem/soss-cli
CLI interface to the California Hydrogen Fuel Cell Station Operational Status System (SOSS)
https://github.com/no2chem/soss-cli
cli command-line fuel-cell hydrogen soss
Last synced: about 1 year ago
JSON representation
CLI interface to the California Hydrogen Fuel Cell Station Operational Status System (SOSS)
- Host: GitHub
- URL: https://github.com/no2chem/soss-cli
- Owner: no2chem
- License: apache-2.0
- Created: 2018-02-27T19:06:30.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-04-18T18:21:23.000Z (about 8 years ago)
- Last Synced: 2025-05-18T03:12:06.896Z (about 1 year ago)
- Topics: cli, command-line, fuel-cell, hydrogen, soss
- Language: JavaScript
- Size: 156 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> Query California hydrogen station status from the CLI!
> (The tables will render correctly in your terminal if emojis are correctly configured).
# soss-cli
[](https://travis-ci.org/no2chem/soss-cli)
* 🤔 Query the [CAFCP](https://cafcp.org)'s
Station Operational Status System (SOSS) from the command line
* 🛰️ Use geolocation to locate nearest stations
* ⛳ Query stations near point of interest
## Installation
You need npm or yarn installed. On macos, install [homebrew](https://brew.sh/) and run ```brew install npm```, on
Debian-flavored Linux, run ```sudo apt-get install npm```.
Then, install globally using npm or yarn:
```sh
# With npm
npm install -g soss-cli
# With yarn
yarn global add soss-cli
```
The ```soss``` command will now be available.
## Querying
Running without parameters will automatically print help.
```sh
soss nearest
```
Will 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](https://www.openstreetmap.org/) 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.