When you just want a quick peek at the local weather, here's a tool to query weatherSTEM's API and return just a short page of weather data. Or, you can return the full JSON that got returned and mangle that all you want.
- github.com/loraxipam/compassrose
- github.com/loraxipam/havers2
Like most golang tools, you need at least 'go' 1.11 installed to compile it. Here's the easy peasy steps that should get you running in five minutes, once Go is working.
go get github.com/loraxipam/weatherstem-cli
cd weatherstem-cli
go run weatherstem.go
<copy and paste the boilerplate config example JSON to your weatherstem.json file>
<edit the JSON per the below Setup directions>
go run weatherstem.go
If you want to compile the code and put it on your path, just run go build weatherstem.go
then move the weatherstem binary to your bin directory. If you have Go configured for your
machine, you could just run go install and it will put it in the usual $GOBIN directory.
You'll need to create a small config file with your weatherstem.com API key and the local domain
URL that you will use. You might have one or two favorite stations to query, so you will need
their short name. Here's the example config file. Call it weatherstem.json and put it in your
.config directory. Or leave it in your current directory. Or put it in ~/.weatherstem.json
and it will work.
{"version": "3.0",
"api_key": "yourKeyGoesHere",
"stations":
["[email protected]",
"[email protected]",
"[email protected]"],
"api_url": "https://api.weatherstem.com/api",
"me": {"lat": 45.0, "lon": -123.0}}
FYI, if you run it with no config file, it will complain and show you an example as above. Cut and paste for the win.
If you want to see it on the screen, just run it.
If you want to output JSON, you can use the -json flag.
If you want distances in kilometers, use -kilo; for miles use -mile.
If you want compact output (few units), use -lite.
If you want to see the full gory details of the complete API call, use the -orig flag.
If you want boring compass rose directions, use -rose.
-json Output cooked data as JSON
-kilo Output station distances in kilometers
-lite Output lightweight cooked data
-mile Output station distances in statute miles
-orig Output original API results
-rose Output boring compass rose directions
I use the alternate compass rose because I love to say the word "Tramontana."
For a list of the Wet Bulb Globe Temperature icons, just pass it any argument, for example, weatherstem help will list out the WBGT alert levels being used.
Current WBGT flags:
<82°F - normal
⚊ 82°F - 87°F - Level 1
⚌ 87°F - 90°F - Level 2
☰ 90°F - 92°F - Level 3
⚑ >92°F - Level 4
The new (Aug 2020) v1 API station ID format allows querying stations in different domains using the same config file. 🙌