# Weather `POST https://bemap.benomad.com/bgis/service/weather/1.0` Part of [Weather](https://benomad.com/dev/doc/bemap-api/more-services/weather.md). > **Get the weather at a place.** The weather around a position, now and as forecast. Returns the weather a round the location Provisioned per account: without it, BeMap answers `400 Access Denied`. ## Request body JSON, `Content-Type: application/json`. Schema `WeatherRequest`. - `provider` (string, required): Provider name. - `geoserver` (string): Geoserver name. - `swidx` (integer (int32), deprecated): Switch index. - `current` (boolean): To get the current weather condition. - `forecast` (boolean): To get the forecast weather conditions. - `id` (string): Search the weather for a city by the ID of city. To use this, the ID must be known. Also the search by city name is available. - `city` (string): Search the weather for a city by the name. - `coord` (Coordinate): Search the weather for a city by the coordinate in the city area. - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`. - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`. - `cacheRadius` (number (double)): Radius in meters used in coordinate search (coord parameter) to limit the search area in weather cache around the coordinate. - `pc` (string): Search the weather for a postal code. - `dtFilter` (string): Filter by date and time. The forecast will be filtered to return only the requested time slot. This parameter is an EPOCH time stamp in milliseconds (UTC) or can take an string with ISO local date time format like '2011-12-03T10:15:30', '2011-12-03T10:15:30+01:00' or '2011-12-03T10:15:30+01:00[Europe/Paris]'. ## Response `200`, schema `WeatherResponse`. - `currentWeather` (WeatherService): Current weather. - `timezone` (integer (int64)): Shift in milliseconds from UTC. - `datetime` (integer (int64)): Time of data forecasted, UNIX, UTC, in milliseconds. - `datetimeTxt` (string): Data/time of calculation, UTC. - `location` (WeatherLoc): Location. - `providerId` (string): City/Place ID of provider.. - `city` (string): City name. - `coordinate` (Coordinate): City geo location, latitude. - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`. - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`. - `conditions` (WeatherCond[]): Weather conditions. - `providerId` (string): Weather condition id. - `category` (enum) - `NOT_SUPPORTED_VALUE`: Not supported value. - `UNKNOWN`: Unknown. - `THUNDERSTORM_WITH_LIGHT_RAIN`: Thunderstorm with light rain. - `THUNDERSTORM_WITH_RAIN`: Thunderstorm with rain. - `THUNDERSTORM_WITH_HEAVY_RAIN`: Thunderstorm with heavy rain. - `LIGHT_THUNDERSTORM`: Light thunderstorm. - `THUNDERSTORM`: Thunderstorm. - `HEAVY_THUNDERSTORM`: Heavy thunderstorm. - `RAGGED_THUNDERSTORM`: Ragged thunderstorm. - `THUNDERSTORM_WITH_LIGHT_DRIZZLE`: Thunderstorm with light drizzle. - `THUNDERSTORM_WITH_DRIZZLE`: Thunderstorm with drizzle. - `THUNDERSTORM_WITH_HEAVY_DRIZZLE`: Thunderstorm with heavy drizzle. - `LIGHT_INTENSITY_DRIZZLE`: Light intensity drizzle. - `DRIZZLE`: Drizzle. - `HEAVY_INTENSITY_DRIZZLE`: Heavy intensity drizzle. - `LIGHT_INTENSITY_DRIZZLE_RAIN`: Light intensity drizzle rain. - `DRIZZLE_RAIN`: Drizzle rain. - `HEAVY_INTENSITY_DRIZZLE_RAIN`: Heavy intensity drizzle rain. - `SHOWER_RAIN_AND_DRIZZLE`: Shower rain and drizzle. - `HEAVY_SHOWER_RAIN_AND_DRIZZLE`: Heavy shower rain and drizzle. - `SHOWER_DRIZZLE`: Shower drizzle. - `LIGHT_RAIN`: Light rain. - `MODERATE_RAIN`: Moderate rain. - `HEAVY_INTENSITY_RAIN`: Heavy intensity rain. - `VERY_HEAVY_RAIN`: Very heavy rain. - `EXTREME_RAIN`: Extreme rain. - `FREEZING_RAIN`: Freezing rain. - `LIGHT_INTENSITY_SHOWER_RAIN`: Light intensity shower rain. - `SHOWER_RAIN`: Shower rain. - `HEAVY_INTENSITY_SHOWER_RAIN`: Heavy intensity shower rain. - `RAGGED_SHOWER_RAIN`: Ragged shower rain. - `LIGHT_SNOW`: Light snow. - `SNOW`: Snow. - `HEAVY_SNOW`: Heavy snow. - `SLEET`: Sleet. - `LIGHT_SHOWER_SLEET`: Light shower sleet. - `SHOWER_SLEET`: Shower sleet. - `LIGHT_RAIN_AND_SNOW`: Light rain and snow. - `RAIN_AND_SNOW`: Rain and snow. - `LIGHT_SHOWER_SNOW`: Light shower snow. - `SHOWER_SNOW`: Shower snow. - `HEAVY_SHOWER_SNOW`: Heavy shower snow. - `MIST`: Mist. - `SMOKE`: Smoke. - `HAZE`: Haze. - `SAND_DUST_WHIRLS`: Sand/dust whirls. - `FOG`: Fog. - `SAND`: Sand. - `DUST`: Dust. - `VOLCANIC_ASH`: Volcanic ash. - `SQUALLS`: Squalls. - `TORNADO`: Tornado. - `CLEAR_SKY`: Clear sky. - `FEW_CLOUDS_11_25`: Few clouds: 11-25%. - `SCATTERED_CLOUDS_25_50`: Scattered clouds: 25-50%. - `BROKEN_CLOUDS_51_84`: Broken clouds: 51-84%. - `OVERCAST_CLOUDS_85_100`: Overcast clouds: 85-100%. - `condition` (string): Group of weather parameters (Rain, Snow, Extreme etc.). - `description` (string): Weather condition within the group. - `providerIcon` (string): Weather icon id of provider. - `temperature` (WeatherTemp): Weather temperature. - `temperature` (number (float)): Temperature, Unit Celsius. - `minimum` (number (float)): Minimum temperature at the moment of calculation. This is deviation from 'temperature' that is possible for large cities and megalopolises geographically expanded (use these parameter optionally). Unit Celsius.. - `maximum` (number (float)): Maximum temperature at the moment of calculation. This is deviation from 'temperature' that is possible for large cities and megalopolises geographically expanded (use these parameter optionally). Unit Celsius.. - `humidity` (number (float)): Humidity, %. - `pressure` (WeatherPress): Weather pressure. - `pressure` (number (float)): Atmospheric pressure on the sea level by default, hPa. - `seaLevel` (number (float)): Atmospheric pressure on the sea level, hPa. - `groundLevel` (number (float)): Atmospheric pressure on the ground level, hPa. - `cloud` (number (float)): Cloudiness, %. - `visibility` (integer (int32)): Visibility in meter. - `wind` (WeatherWnd): Weather wind. - `speed` (number (float)): Wind speed, measured in meters per second (m/s). - `heading` (number (float)): Wind direction, degrees (meteorological). - `rainVolume3h` (number (float)): Rain volume over the last 3 hours, measured in millimeters. - `snowVolume3h` (number (float)): Snow volume over the last 3 hours, measured in millimeters. - `filteredCurrentWeather` (boolean) - `forecast` (ForecastService): Weather forecast. - `weathers` (WeatherService[]): Weather. - `timezone` (integer (int64)): Shift in milliseconds from UTC. - `datetime` (integer (int64)): Time of data forecasted, UNIX, UTC, in milliseconds. - `datetimeTxt` (string): Data/time of calculation, UTC. - `location` (WeatherLoc): Location. - `providerId` (string): City/Place ID of provider.. - `city` (string): City name. - `coordinate` (Coordinate): City geo location, latitude. - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`. - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`. - `conditions` (WeatherCond[]): Weather conditions. - `providerId` (string): Weather condition id. - `category` (enum) - `NOT_SUPPORTED_VALUE`: Not supported value. - `UNKNOWN`: Unknown. - `THUNDERSTORM_WITH_LIGHT_RAIN`: Thunderstorm with light rain. - `THUNDERSTORM_WITH_RAIN`: Thunderstorm with rain. - `THUNDERSTORM_WITH_HEAVY_RAIN`: Thunderstorm with heavy rain. - `LIGHT_THUNDERSTORM`: Light thunderstorm. - `THUNDERSTORM`: Thunderstorm. - `HEAVY_THUNDERSTORM`: Heavy thunderstorm. - `RAGGED_THUNDERSTORM`: Ragged thunderstorm. - `THUNDERSTORM_WITH_LIGHT_DRIZZLE`: Thunderstorm with light drizzle. - `THUNDERSTORM_WITH_DRIZZLE`: Thunderstorm with drizzle. - `THUNDERSTORM_WITH_HEAVY_DRIZZLE`: Thunderstorm with heavy drizzle. - `LIGHT_INTENSITY_DRIZZLE`: Light intensity drizzle. - `DRIZZLE`: Drizzle. - `HEAVY_INTENSITY_DRIZZLE`: Heavy intensity drizzle. - `LIGHT_INTENSITY_DRIZZLE_RAIN`: Light intensity drizzle rain. - `DRIZZLE_RAIN`: Drizzle rain. - `HEAVY_INTENSITY_DRIZZLE_RAIN`: Heavy intensity drizzle rain. - `SHOWER_RAIN_AND_DRIZZLE`: Shower rain and drizzle. - `HEAVY_SHOWER_RAIN_AND_DRIZZLE`: Heavy shower rain and drizzle. - `SHOWER_DRIZZLE`: Shower drizzle. - `LIGHT_RAIN`: Light rain. - `MODERATE_RAIN`: Moderate rain. - `HEAVY_INTENSITY_RAIN`: Heavy intensity rain. - `VERY_HEAVY_RAIN`: Very heavy rain. - `EXTREME_RAIN`: Extreme rain. - `FREEZING_RAIN`: Freezing rain. - `LIGHT_INTENSITY_SHOWER_RAIN`: Light intensity shower rain. - `SHOWER_RAIN`: Shower rain. - `HEAVY_INTENSITY_SHOWER_RAIN`: Heavy intensity shower rain. - `RAGGED_SHOWER_RAIN`: Ragged shower rain. - `LIGHT_SNOW`: Light snow. - `SNOW`: Snow. - `HEAVY_SNOW`: Heavy snow. - `SLEET`: Sleet. - `LIGHT_SHOWER_SLEET`: Light shower sleet. - `SHOWER_SLEET`: Shower sleet. - `LIGHT_RAIN_AND_SNOW`: Light rain and snow. - `RAIN_AND_SNOW`: Rain and snow. - `LIGHT_SHOWER_SNOW`: Light shower snow. - `SHOWER_SNOW`: Shower snow. - `HEAVY_SHOWER_SNOW`: Heavy shower snow. - `MIST`: Mist. - `SMOKE`: Smoke. - `HAZE`: Haze. - `SAND_DUST_WHIRLS`: Sand/dust whirls. - `FOG`: Fog. - `SAND`: Sand. - `DUST`: Dust. - `VOLCANIC_ASH`: Volcanic ash. - `SQUALLS`: Squalls. - `TORNADO`: Tornado. - `CLEAR_SKY`: Clear sky. - `FEW_CLOUDS_11_25`: Few clouds: 11-25%. - `SCATTERED_CLOUDS_25_50`: Scattered clouds: 25-50%. - `BROKEN_CLOUDS_51_84`: Broken clouds: 51-84%. - `OVERCAST_CLOUDS_85_100`: Overcast clouds: 85-100%. - `condition` (string): Group of weather parameters (Rain, Snow, Extreme etc.). - `description` (string): Weather condition within the group. - `providerIcon` (string): Weather icon id of provider. - `temperature` (WeatherTemp): Weather temperature. - `temperature` (number (float)): Temperature, Unit Celsius. - `minimum` (number (float)): Minimum temperature at the moment of calculation. This is deviation from 'temperature' that is possible for large cities and megalopolises geographically expanded (use these parameter optionally). Unit Celsius.. - `maximum` (number (float)): Maximum temperature at the moment of calculation. This is deviation from 'temperature' that is possible for large cities and megalopolises geographically expanded (use these parameter optionally). Unit Celsius.. - `humidity` (number (float)): Humidity, %. - `pressure` (WeatherPress): Weather pressure. - `pressure` (number (float)): Atmospheric pressure on the sea level by default, hPa. - `seaLevel` (number (float)): Atmospheric pressure on the sea level, hPa. - `groundLevel` (number (float)): Atmospheric pressure on the ground level, hPa. - `cloud` (number (float)): Cloudiness, %. - `visibility` (integer (int32)): Visibility in meter. - `wind` (WeatherWnd): Weather wind. - `speed` (number (float)): Wind speed, measured in meters per second (m/s). - `heading` (number (float)): Wind direction, degrees (meteorological). - `rainVolume3h` (number (float)): Rain volume over the last 3 hours, measured in millimeters. - `snowVolume3h` (number (float)): Snow volume over the last 3 hours, measured in millimeters. - `filteredForecast` (boolean): Filtered forecast. ## Errors - `400`: Bad Request - `302`: no credentials were sent. Do not follow the redirect. - `401`: the account or the API key is wrong. How to read each one: [Errors](https://benomad.com/dev/doc/bemap-api/getting-started/errors.md). ## Example ```bash curl -X POST 'https://bemap.benomad.com/bgis/service/weather/1.0' \ -u 'YOUR_ACCOUNT:YOUR_API_KEY' \ --fail-with-body \ -H 'Content-Type: application/json' \ -d '{ "provider": "owm", "coord": { "lat": 48.8606, "lon": 2.3376 }, "current": true, "forecast": true }' ``` Response captured from production, long arrays and strings shortened: ```json { "currentWeather": { "timezone": 7200000, "datetime": 1790941877000, "datetimeTxt": "2026-10-02T11:51:17Z[UTC]", "location": { "providerId": "3036572", "city": "Asnières-sur-Seine", "coordinate": { "lon": 2.2931, "lat": 48.905 } }, "conditions": [ { "providerId": "803", "category": "BROKEN_CLOUDS_51_84", "condition": "Clouds", "description": "broken clouds", "providerIcon": "04d" } ], "temperature": { "temperature": 20.77, "minimum": 19.7, "maximum": 21.32 }, "humidity": 49, "pressure": { "pressure": 1032, "seaLevel": 1032, "groundLevel": 1024 }, "cloud": 80, "visibility": 10000, "wind": { "speed": 2.57, "heading": 90 } }, "filteredCurrentWeather": false, "forecast": { "weathers": [ { "timezone": 0, "datetime": 1790942400000, "datetimeTxt": "2026-10-02T12:00Z[UTC]", "location": { "providerId": "6269531", "city": "Paris 01 Louvre", "coordinate": { "lon": 2.3376, "lat": 48.8606 } }, "conditions": [ { "providerId": "804", "category": "OVERCAST_CLOUDS_85_100", "condition": "Clouds", "description": "overcast clouds", "providerIcon": "04d" } ], "temperature": { "temperature": 20.65, "minimum": 20.65, "maximum": 20.71 }, "humidity": 49, "pressure": { "pressure": 1032, "seaLevel": 1032, "groundLevel": 1024 }, "cloud": 91, "visibility": 10000, "wind": { "speed": 1.31, "heading": 48 } }, { "timezone": 0, "datetime": 1790953200000, "datetimeTxt": "2026-10-02T15:00Z[UTC]", "location": { "providerId": "6269531", "city": "Paris 01 Louvre", "coordinate": { "lon": 2.3376, "lat": 48.8606 } }, "conditions": [ { "providerId": "803", "category": "BROKEN_CLOUDS_51_84", "condition": "Clouds", "description": "broken clouds", "providerIcon": "04d" } ], "temperature": { "temperature": 20.91, "minimum": 20.91, "maximum": 21.43 }, "humidity": 49, "pressure": { "pressure": 1031, "seaLevel": 1031, "groundLevel": 1022 }, "cloud": 63, "visibility": 10000, "wind": { "speed": 1.96, "heading": 64 } } ] }, "filteredForecast": false } ``` ## Reference pages - [Weather](https://benomad.com/dev/doc/bemap-api/guides/services/weather.md)