diff options
Diffstat (limited to 'content/posts/2019-08-25-weather-sage.md')
| -rw-r--r-- | content/posts/2019-08-25-weather-sage.md | 67 |
1 files changed, 67 insertions, 0 deletions
diff --git a/content/posts/2019-08-25-weather-sage.md b/content/posts/2019-08-25-weather-sage.md new file mode 100644 index 0000000..1153bd6 --- /dev/null +++ b/content/posts/2019-08-25-weather-sage.md @@ -0,0 +1,67 @@ +--- +date: "2019-08-25T22:00:00Z" +title: Weather Sage 0.1.2 Released +--- + +A couple days ago I released [Weather Sage][] 0.1.2. + +[Weather Sage][] is a command-line tool and [Ruby][] library to get the +weather forecast and current weather observations for a domestic United +States street address. + +It uses the [Census Bureau Geocoding API][census-api] to geocode street +addresses, and the [National Weather Service Weather API][weather-api] +to get weather forecasts and current weather observations. + +The command-line tool queries the [APIs][] above to obtain the requested +information for the given street address, and then prints the results to +standard output in [CSV][] format. + +Here's an example of using the `weather-sage` command-line tool to get +the weather forecast for the address `1600 pennsylvania ave nw, +washington dc`: + +``` +> weather-sage forecast '1600 pennsylvania ave nw washington dc' +address,name,temperature,temperature_unit,wind_speed,wind_direction,short_forecast +1600 pennsylvania ave washington dc,Today,97,F,7 mph,SW,Scattered Showers And Thunderstorms +1600 pennsylvania ave washington dc,Tonight,76,F,2 to 7 mph,SW,Scattered Showers And Thunderstorms then Mostly Cloudy +1600 pennsylvania ave washington dc,Tuesday,94,F,6 mph,E,Slight Chance Rain Showers then Chance Showers And Thunderstorms +1600 pennsylvania ave washington dc,Tuesday Night,75,F,2 to 6 mph,S,Chance Showers And Thunderstorms +1600 pennsylvania ave washington dc,Wednesday,94,F,3 to 9 mph,SW,Chance Showers And Thunderstorms +1600 pennsylvania ave washington dc,Wednesday Night,76,F,5 to 8 mph,SW,Chance Showers And Thunderstorms +... +``` + +And here's an example of using the `weather-sage` command-line tool to +get the current weather observations from the weather station closest to +the address `1600 pennsylvania ave nw, washington dc`: + +``` +> weather-sage now '1600 pennsylvania ave washington dc' +address,name,type,value,unit,quality_control +1600 pennsylvania ave washington dc,timestamp,time,2019-08-19T06:52:00+00:00 +1600 pennsylvania ave washington dc,textDescription,text,Mostly Cloudy +1600 pennsylvania ave washington dc,temperature,value,26.700000000000045,unit:degC,qc:V +1600 pennsylvania ave washington dc,relativeHumidity,value,81.65039907186703,unit:percent,qc:C +... +``` + +You can install [Weather Sage][] via [RubyGems][] like this: + +``` +# install weather-sage with rubygems +> gem install weather-sage +``` + +**Note:** This is the initial release, so the API documentation, test +suite, and command-line interface are not yet complete. + + [weather sage]: https://github.com/pablotron/weather-sage "Weather Sage" + [apis]: https://en.wikipedia.org/wiki/Application_programming_interface "Application Programming Interface" + [csv]: https://en.wikipedia.org/wiki/Comma-separated_values "Comma-separated Value format" + [ruby]: https://ruby-lang.org/ "Ruby programming language" + [rubygems]: https://rubygems.org/ "Ruby package manager" + [weather-api]: https://api.weather.gov/ "national Weather Service (NWS) Weather API" + [census-api]: https://geocoding.geo.census.gov/geocoder/ "Census Bureau Geocoding API" + |