Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shinysocks/direct_supply_kata
weather data to excel for many locations
https://github.com/shinysocks/direct_supply_kata
Last synced: about 2 months ago
JSON representation
weather data to excel for many locations
- Host: GitHub
- URL: https://github.com/shinysocks/direct_supply_kata
- Owner: shinysocks
- Created: 2024-11-14T04:18:38.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-17T06:33:45.000Z (2 months ago)
- Last Synced: 2024-11-17T07:29:37.560Z (2 months ago)
- Language: Java
- Homepage:
- Size: 15.3 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Direct Supply Kata 2024 - Weather Data to Excel
## Noah Dinan
### __overview__
>For this project, I wanted the user to be able to input as many locations as they wanted
>and recieve a table showing the weather for each location. This would make comparing
>weather in several locations trivial. I decided to use java for the project because of the
>easy to use Apache POI library for generating xlsx files, and because of its platform independence.
>One unique aspect of this project is the "Should I go biking?" row
>which determines how suitable the weather in each location is for a ride
>based on amount of precipitation, wind speed, and temperature.
### __features__
- pulls data for each specified location
- current weather information
- high and low temperatures of the day
- bikeability for the day
- time of sunrise and sunset
- outputs an excel sheet containing weather data
### __next steps__
- get current moon phase
- write unit tests
### __usage__
>obtain or generate an API key for Google's Geolocation API
> - to generate a key, follow the instructions [here](https://support.google.com/googleapi/answer/6158862?hl=en)
---
>run with jarfile (Windows)
>```sh
>$env:GEOLOCATION_API_KEY="GOOGLE_GEOLOCATION_KEY" ; java -jar kata.jar "San Diego" "San Francisco" "Los Angeles" "Sacramento"
>```
---
>run with jarfile (Unix)
>```sh
>GEOLOCATION_API_KEY="GOOGLE_GEOLOCATION_KEY" java -jar kata.jar "San Diego" "San Francisco" "Los Angeles" "Sacramento"
>```
---
>run with gradle
>```sh
>GEOLOCATION_API_KEY="GOOGLE_GEOLOCATION_KEY" gradle run --args="milwaukee madison 'green bay' chicago antarctica"
>```
> [!Note]
> One benefit of using Google's Geolocation API is that locations can be
> as specific as a street address or as general as a continent!
### __projects used__
1. [open-meteo api](https://github.com/open-meteo/open-meteo)
2. [google's geolocation api](https://developers.google.com/maps/documentation/geolocation/overview)
3. [apache poi](https://github.com/apache/poi)
4. [LatLongToTimezone](https://github.com/drtimcooper/LatLongToTimezone) for timezone calculations (TimezoneMapper.java)
5. [WMO descriptions](https://gist.github.com/stellasphere/9490c195ed2b53c707087c8c2db4ec0c) (descriptions.json)
### __screenshots__
- #### California has beautiful weather!
>
- #### Some Milwaukee cities!
>
- #### Comparing weather at both Direct Supply Locations with graceful exception handling
>