> ## Documentation Index
> Fetch the complete documentation index at: https://docs.camel-ai.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Camel.toolkits.weather toolkit

<a id="camel.toolkits.weather_toolkit" />

<a id="camel.toolkits.weather_toolkit.WeatherToolkit" />

## WeatherToolkit

```python theme={"system"}
class WeatherToolkit(BaseToolkit):
```

A class representing a toolkit for interacting with weather data.

This class provides methods for fetching weather data for a given city
using the OpenWeatherMap API.

<a id="camel.toolkits.weather_toolkit.WeatherToolkit.__init__" />

### **init**

```python theme={"system"}
def __init__(self, timeout: Optional[float] = None):
```

Initializes a new instance of the WeatherToolkit class.

**Parameters:**

* **timeout** (Optional\[float]): The timeout value for API requests in seconds. If None, no timeout is applied. (default: :obj:`None`)

<a id="camel.toolkits.weather_toolkit.WeatherToolkit.get_openweathermap_api_key" />

### get\_openweathermap\_api\_key

```python theme={"system"}
def get_openweathermap_api_key(self):
```

**Returns:**

str: The OpenWeatherMap API key.

<a id="camel.toolkits.weather_toolkit.WeatherToolkit.get_weather_data" />

### get\_weather\_data

```python theme={"system"}
def get_weather_data(
    self,
    city: str,
    temp_units: Literal['kelvin', 'celsius', 'fahrenheit'] = 'kelvin',
    wind_units: Literal['meters_sec', 'miles_hour', 'knots', 'beaufort'] = 'meters_sec',
    visibility_units: Literal['meters', 'miles'] = 'meters',
    time_units: Literal['unix', 'iso', 'date'] = 'unix'
):
```

Fetch and return a comprehensive weather report for a given city
as a string. The report includes current weather conditions,
temperature, wind details, visibility, and sunrise/sunset times,
all formatted as a readable string.

The function interacts with the OpenWeatherMap API to
retrieve the data.

**Parameters:**

* **city** (str): The name of the city for which the weather information is desired. Format "City, CountryCode" (e.g., "Paris, FR" for Paris, France). If the country code is not provided, the API will search for the city in all countries, which may yield incorrect results if multiple cities with the same name exist.
* **temp\_units** (`Literal['kelvin', 'celsius', 'fahrenheit']`): Units for temperature. (default: :obj:`kelvin`) wind\_units (Literal\['meters\_sec', 'miles\_hour', 'knots', 'beaufort']): Units for wind speed. (default: :obj:`meters_sec`)
* **visibility\_units** (`Literal['meters', 'miles']`): Units for visibility distance. (default: :obj:`meters`)
* **time\_units** (`Literal['unix', 'iso', 'date']`): Format for sunrise and sunset times. (default: :obj:`unix`)

**Returns:**

str: A string containing the fetched weather data, formatted in a
readable manner. If an error occurs, a message indicating the
error will be returned instead.

Example of return string:
"Weather in Paris, FR: 15°C, feels like 13°C. Max temp: 17°C,
Min temp : 12°C.
Wind: 5 m/s at 270 degrees. Visibility: 10 kilometers.
Sunrise at 05:46:05 (UTC), Sunset at 18:42:20 (UTC)."

**Note:**

Please ensure that the API key is valid and has permissions
to access the weather data.

<a id="camel.toolkits.weather_toolkit.WeatherToolkit.get_tools" />

### get\_tools

```python theme={"system"}
def get_tools(self):
```

**Returns:**

List\[FunctionTool]: A list of FunctionTool objects
representing the functions in the toolkit.