Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kapil7982/weatherapi
This is a web application for retrieving weather forecast data based on user input. It provides two main functionalities: fetching a summary of the weather forecast and retrieving hourly forecast details.
https://github.com/kapil7982/weatherapi
java-8 maven openweathermap-api rapidapi
Last synced: 3 days ago
JSON representation
This is a web application for retrieving weather forecast data based on user input. It provides two main functionalities: fetching a summary of the weather forecast and retrieving hourly forecast details.
- Host: GitHub
- URL: https://github.com/kapil7982/weatherapi
- Owner: Kapil7982
- Created: 2024-04-07T14:34:13.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-04-08T12:11:14.000Z (10 months ago)
- Last Synced: 2024-11-27T14:19:19.759Z (2 months ago)
- Topics: java-8, maven, openweathermap-api, rapidapi
- Language: Java
- Homepage: http://localhost:8080/index.html
- Size: 70.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WeatherApi
## Weather Forecast Application
This is a web application for retrieving weather forecast data based on user input. It provides two main functionalities: fetching a summary of the weather forecast and retrieving hourly forecast details.
### Requirements
- Java 8 or higher
- Maven
- RapidAPI Key
- OpenWeatherMap API Key
### Installation
1. Clone the repository to your local machine:
```bash
git clone https://github.com/Kapil7982/WeatherApi.git
```
2. Navigate to the project directory: cd weather-forecast-api
3. Create a new file named ```application.properties``` in the ```src/main/resources``` directory and add the following properties:
```bash
rapidapi.key=YOUR_RAPIDAPI_KEY
rapidapi.host=forecast9.p.rapidapi.com
openweathermap.api.key=YOUR_OPENWEATHERMAP_API_KEY
client.id=clientId1
client.secret=secreat1
```
### Install the required dependencies for the backend (Spring Boot):
```bash
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-devtools
runtime
true
org.projectlombok
lombok
true
org.springframework.boot
spring-boot-starter-test
test
com.squareup.okhttp3
okhttp
4.9.3
org.apache.httpcomponents
httpclient
4.5.13
```
4. Build the project: mvn clean install
5. Run the application: mvn spring-boot:run
6. The application will start running on http://localhost:8080.
### Endpoints
1. Get Forecast Summary by Location
```bash
GET /forecast/summary?locationName={locationName}
```
This endpoint retrieves the forecast summary for a given location using the RapidAPI Forecast9 API.
Headers:
```X-Client-ID```: A unique client ID (generated in the code).
```X-Client-Secret```: A unique client secret (generated in the code).
Query Parameters:
locationName: The name of the location for which you want to retrieve the forecast summary.
2. Get Hourly Forecast by City
```bash
GET /forecast/hourly/openweathermap?cityName={cityName}
```
This endpoint retrieves the hourly forecast for a given city using the OpenWeatherMap API.
Headers:
```X-Client-ID```: A unique client ID (generated in the code).
```X-Client-Secret```: A unique client secret (generated in the code).
Query Parameters:
cityName: The name of the city for which you want to retrieve the hourly forecast.
## Frontend (Make sure the backend is running)
HTML and CSS Files
The project includes an HTML file (```index.html```) and a CSS file (```styles.css```) (in src/main/resources/static) that provides a basic user interface for interacting with the weather forecast API. The HTML file contains two input fields: one for entering the city name and two buttons for fetching the forecast summary and hourly forecast, respectively. The results are displayed in separate sections within the HTML file.
To use the user interface, open the index.html file in a web browser, enter the city name, and click the corresponding button to fetch the forecast data.