This is a FastAPI-based implementation that interacts with the OpenWeatherMap API. It provides a modern, efficient, and user-friendly way to fetch and serve weather data using FastAPI's robust web framework.

Before you begin, ensure you have the following:

• Python >= 3.13 installed on your system.
• An API key from OpenWeatherMap.

Follow these steps to set up the project:

1. Clone the repository:

   git clone https://github.com/Simatwa/weather-api.git
   cd weather-api

2. Install the required dependencies:

   # Create a virtual environment
   python -m venv venv
   
   # Activate the virtual environment
   # On Windows
   venv\Scripts\activate
   # On *nix
   source venv/bin/activate
   
   # Install the required dependencies
   pip install -r requirements.txt

To use the API, you need to configure your OpenWeatherMap API key:

1. Obtain your API key from OpenWeatherMap.
2. Create a .env file in the project root (you can use the provided .env.example as a template).
3. Add your API key to the .env file using the key OPEN_WEATHER_MAP_API_KEY.

Once configured, you can start the server by running:

$ fastapi run app

The server will start on http://localhost:8000.

The Weather-API provides interactive documentation for its endpoints:

Important:
The /forecast endpoint has periodic request limitations for non-premium OpenWeatherMap accounts. Consider upgrading your account for higher request limits.

This project is licensed under MIT License