# OpenWeatherMap

WeatherMap provides visual weather data, forecasts, and mappings, helping users understand climate patterns or track severe weather conditions

- **Category:** developer tools
- **Auth:** NO_AUTH
- **Composio Managed App Available?** N/A
- **Tools:** 2
- **Triggers:** 0
- **Slug:** `WEATHERMAP`
- **Version:** 20260316_00

## Tools

### Geocode Location to Coordinates

**Slug:** `WEATHERMAP_GEOCODE_LOCATION`

Tool to resolve a human place name into canonical lat/lon coordinates using OpenWeather Geocoding API. Use when you need to convert location strings (city names, addresses) into coordinates for weather forecasts or other location-based queries. Returns up to 5 candidate matches; the first result is typically the most relevant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Location query string in format 'city' or 'city,country_code' or 'city,state,country_code'. For US locations, you can include state code (e.g., 'Austin,TX,US'). Use ISO 3166 country codes (e.g., 'London,GB', 'Paris,FR'). The API supports 200,000+ registered locations. |
| `limit` | integer | No | Maximum number of location matches to return (1-5). Use this to limit results when multiple locations share the same name. Default is 5. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Weather Info

**Slug:** `WEATHERMAP_WEATHER`

Tool for querying the OpenWeatherMap API. Returns current weather conditions only — no UV index, AQI, or official alerts. Timestamps are in UTC; apply the timezone offset field before grouping by local day.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `location` | string | Yes | A real city name (e.g., 'London', 'New York', 'Tokyo'). MUST be an actual city name - NOT a placeholder like 'your location', 'current location', or 'my location'. City names must be in English/Latin characters only. You may optionally append a country code (e.g., 'London,GB'). For US cities with state abbreviations, use the 3-part format 'City,StateCode,US' (e.g., 'Redding,CA,US', 'Portland,OR,US') - the 2-part format 'City,StateCode' will be interpreted as a country code (e.g., 'CA' = Canada, not California). If a 'city not found' error occurs, retry with a simpler string (e.g., drop state code, use just 'City' or 'City,CountryCode'). Small or remote locations may return no data; handle gracefully rather than retrying indefinitely. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |