--- title: "Use to get current weather conditions." method: GET path: "/weather/currentConditions/{format}" --- # Use to get current weather conditions. `GET /weather/currentConditions/{format}` The `Get Current Conditions` API is an HTTP `GET` request that returns detailed current weather conditions such as precipitation, temperature and wind for a given coordinate location. Also, observations from the past 6 or 24 hours for a particular location can be retrieved. The basic information returned with The response includes details such as observation date and time, brief description of the weather conditions, weather icon, precipitation indicator flags, and temperature. Additional details such as RealFeel™ Temperature and UV index are also returned. For more information, see [Request real-time weather data](/azure/azure-maps/how-to-request-weather-data#request-real-time-weather-data) ## Path parameters - `format` 'json', required ## Query parameters - `api-version` string, required - `query` number[], required - `unit` 'imperial' | 'metric' - `details` string - `duration` integer - `language` string ## Headers - `x-ms-client-id` string ## Response `200` The request has succeeded. - CurrentConditionsResult — Current weather conditions result. - `results` CurrentConditions[] — Detailed current weather conditions. - `dateTime` string, date-time — Date and time of the current observation displayed in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27T19:39:57-08:00. - `phrase` string — Phrase description of the current weather condition. Displayed in specified language. - `iconCode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 — Numeric value representing an image that corresponds to the current weather condition described by the `Phrase` property. For more information, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#weather-icons). May be NULL. - `hasPrecipitation` boolean — A boolean value that indicates whether precipitation (rain, snow, sleet, or hail) is expected during the specified timeframe. Returns true if precipitation is expected, otherwise false. - `isDayTime` boolean — Indicates the time of the day. True indicates 'day',', false indicates 'night. - `temperature` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `realFeelTemperature` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `realFeelTemperatureShade` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `relativeHumidity` integer — Relative humidity is the amount of water vapor present in air expressed as a percentage of the amount needed for saturation at the same temperature. - `dewPoint` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `wind` WindDetails — Wind details being returned including speed and direction. - `direction` WindDirection — Wind direction - `degrees` integer — Wind direction in Azimuth degrees, starting at true North and continuing in clockwise direction. North is 0 degrees, east is 90 degrees, south is 180 degrees, west is 270 degrees. Possible values 0-359. - `localizedDescription` string — Direction abbreviation in the specified language. - `speed` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `windGust` WindDetails — Wind details being returned including speed and direction. - `direction` WindDirection — Wind direction - `degrees` integer — Wind direction in Azimuth degrees, starting at true North and continuing in clockwise direction. North is 0 degrees, east is 90 degrees, south is 180 degrees, west is 270 degrees. Possible values 0-359. - `localizedDescription` string — Direction abbreviation in the specified language. - `speed` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `uvIndex` integer — Measure of the strength of the ultraviolet radiation from the sun. Supported values are: * `0-2` - Low danger from the sun's UV rays or the average person. * `3-5` - Moderate risk of harm from unprotected sun exposure. * `6-7` - High risk of harm from unprotected sun exposure. * `8-10` - Very high risk of harm from unprotected sun exposure. * `11+` - Extreme risk of harm from unprotected sun exposure. - `uvIndexPhrase` string — Phrase associated with the `uvIndex`. - `visibility` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `obstructionsToVisibility` string — Cause of limited visibility. Possible values: - _A = heavy thunderstorm/hail_ - _BD = blowing dust_ - _BN = blowing sand_ - _BS = blowing snow_ - _D = dust_ - _F = fog_ - _GF = ground fog_ - _HZ = haze_ - _I = ice_ - _IC = ice crystals_ - _IF = ice fog_ - _IP = ice pellets_ - _IPW = ice pellets shower_ - _K = smoke_ - _L = drizzle_ - _R = rain_ - _RS = rain/snow_ - _RW = rain shower_ - _S = snow_ - _SG = snow granules_ - _SP = snow pellets_ - _SW = snow shower_ - _T = thunderstorm_ - _UP = undefined precipitation_ - _ZL = freezing drizzle_ - _ZR = freezing rain_ - _+ = heavy_ - _- = light_ - `cloudCover` integer — Percent representing cloud cover. - `ceiling` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `pressure` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `pressureTendency` PressureTendency — Atmospheric pressure tendency. - `localizedDescription` string — Description of the pressure tendency in specified language - `code` string — Pressure tendency code regardless of language. One of F=Falling, S=Steady, R=Rising. - `pastTwentyFourHourTemperatureDeparture` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `apparentTemperature` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `windChillTemperature` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `wetBulbTemperature` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `precipitationSummary` PrecipitationSummary — Summary of precipitation amounts. - `pastHour` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `past3Hours` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `past6Hours` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `past9Hours` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `past12Hours` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `past18Hours` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `past24Hours` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `temperatureSummary` TemperatureSummary — Summary of temperature fluctuations. - `past6Hours` PastHoursTemperature — Summary of temperature fluctuations over the number of past hours. - `minimum` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `maximum` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `past12Hours` PastHoursTemperature — Summary of temperature fluctuations over the number of past hours. - `minimum` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `maximum` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `past24Hours` PastHoursTemperature — Summary of temperature fluctuations over the number of past hours. - `minimum` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). - `maximum` WeatherValue — Specific value of a given unit related to weather. - `value` number, float — Rounded value. - `unit` string — Type of unit for the returned value. - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types). ## Other responses - `default` — An unexpected error response. --- [API](https://skmtc.net/azure/apis/maps-weather.md) · [All operations](https://skmtc.net/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/maps-weather/versions/3c076fdd2918/schema)