Weather - Get Current Conditions

Use to get current weather conditions.
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

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}
GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

URI Parameters

Name In Required Type Description
endpoint
path True

string (uri)

The Azure Maps service hostname. Use https://atlas.microsoft.com for the Azure public cloud. To target a specific Azure Maps geography or a sovereign cloud, see Azure Maps geographic scope.

format
path True

JsonFormat

Desired format of the response. Only json format is supported.

api-version
query True

string

minLength: 1

The API version to use for this operation.

query
query True

number[]

The applicable query specified as a comma separated string composed by latitude followed by longitude e.g. "47.641268,-122.125679".

Weather information is generally available for locations on land, bodies of water surrounded by land, and areas of the ocean that are within approximately 50 nautical miles of a coastline.

details
query

string

Return full details for the current conditions. Available values are

  • true - Returns full details. By default all details are returned.
  • false - Returns a truncated version of the current condition data, which includes observation date time, weather phrase, icon code, precipitation indicator flag, and temperature.
duration
query

integer (int32)

Time frame of the returned weather conditions. By default, the most current weather conditions will be returned. Default value is 0. Supported values are:

  • 0 - Return the most current weather conditions.
  • 6 - Return weather conditions from past 6 hours.
  • 24 - Return weather conditions from past 24 hours.
language
query

string

Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in specified language is not available for a specific field, default language is used.

Please refer to Supported Languages for details.

unit
query

WeatherDataUnit

Specifies to return the data in either metric units or imperial units. Default value is metric.

Request Header

Name Required Type Description
x-ms-client-id

string

Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be obtained from the Azure Maps management plane Account API. For more information on using Microsoft Entra ID security in Azure Maps, see Manage authentication in Azure Maps.

Responses

Name Type Description
200 OK

CurrentConditionsResult

The request has succeeded.

Other Status Codes

ErrorResponse

An unexpected error response.

Security

AadToken

These are the Microsoft Entra OAuth 2.0 Flows. When paired with Azure role-based access control it can be used to control access to Azure Maps REST APIs. Azure role-based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a built-in role or a custom role composed of one or more permissions to Azure Maps REST APIs.

To implement scenarios, we recommend viewing authentication concepts. In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes.

Note

  • This security definition requires the use of the x-ms-client-id header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the Maps management API.
  • The Authorization URL is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Microsoft Entra ID configurations.
  • The Azure role-based access control is configured from the Azure management plane via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.
  • Usage of the Azure Maps Web SDK allows for configuration based setup of an application for multiple use cases.
  • For more information on Microsoft identity platform, see Microsoft identity platform overview.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
https://atlas.microsoft.com/.default

subscription-key

This is a shared key that is provisioned when you Create an Azure Maps account in the Azure portal or using PowerShell, CLI, Azure SDKs, or REST API.

With this key, any application can access all REST API. In other words, this key can be used as a master key in the account that they are issued in.

For publicly exposed applications, our recommendation is to use the confidential client applications approach to access Azure Maps REST APIs so your key can be securely stored.

Type: apiKey
In: header

SAS Token

This is a shared access signature token is created from the List SAS operation on the Azure Maps resource through the Azure management plane via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs.

With this token, any application is authorized to access with Azure role-based access controls and fine-grain control to the expiration, rate, and region(s) of use for the particular token. In other words, the SAS Token can be used to allow applications to control access in a more secured way than the shared key.

For publicly exposed applications, our recommendation is to configure a specific list of allowed origins on the Map account resource to limit rendering abuse and regularly renew the SAS Token.

Type: apiKey
In: header

Examples

Successfully retrieve detailed current weather conditions for a given coordinate location

Sample request

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Sample response

{
  "results": [
    {
      "apparentTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 16.1
      },
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4359
      },
      "cloudCover": 95,
      "dateTime": "2019-11-14T15:08:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "hasPrecipitation": false,
      "iconCode": 7,
      "isDayTime": true,
      "obstructionsToVisibility": "",
      "pastTwentyFourHourTemperatureDeparture": {
        "unit": "C",
        "unitType": 17,
        "value": 1.8
      },
      "phrase": "Cloudy",
      "precipitationSummary": {
        "past12Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past18Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past24Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past3Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past6Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past9Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "pastHour": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.5
        }
      },
      "pressure": {
        "unit": "mb",
        "unitType": 14,
        "value": 1014.9
      },
      "pressureTendency": {
        "code": "S",
        "localizedDescription": "Steady"
      },
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "realFeelTemperatureShade": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "relativeHumidity": 75,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.7
      },
      "temperatureSummary": {
        "past12Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past24Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past6Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 8.3
          }
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 8
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.4
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.6
        }
      },
      "windChillTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.9
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 4.9
        }
      }
    }
  ]
}

Definitions

Name Description
CurrentConditions

A single weather observation for the specified location, returned by the Get Current Conditions operation. Depending on the request's duration, this observation may be the latest (most recent) reading or one of the preceding hourly observations. By default a simplified subset is returned: observation date and time, weather phrase, icon code, precipitation indicator, and temperature. When the request asks for full details, every property is included, adding measurements such as RealFeel, dew point, wind, visibility, cloud cover, pressure, and rolling precipitation and temperature summaries for the past several hours.

CurrentConditionsResult

The response returned by the Get Current Conditions operation, containing one or more current-conditions observations for a specified location. By default a single observation for the present time is returned; when the duration parameter is set to 6 or 24, the response also includes one observation per past hour over that window.

ErrorAdditionalInfo

The resource management error additional info.

ErrorDetail

The error detail.

ErrorResponse

Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).

IconCode

The numeric weather-condition code that identifies which icon to display. Each value in this enumeration corresponds to an Azure Maps weather icon (such as Sunny, Cloudy, or Thunderstorms) and pairs with a human-readable iconPhrase returned alongside it. The same code can appear in current, hourly, daily, quarter-day, and minute-by-minute responses, allowing applications to render a consistent icon set across all weather services.

For the complete list of codes, the icons they map to, and example imagery, see Weather services in Azure Maps.

JsonFormat

Desired format of the response. Only json format is supported.

PastHoursTemperature

The highest and lowest air temperatures observed during one of the rolling windows on TemperatureSummary (past 6, 12, or 24 hours), in degrees Celsius (°C) or Fahrenheit (°F) depending on the unit specified in the request.

PrecipitationSummary

The total liquid-equivalent precipitation that has fallen at the observation location over rolling windows ending at the observation time. Each value covers the full window measured back from "now" - for example, past3Hours is the running total for the most recent three hours, not just the third hour - so the windows overlap and longer windows include the precipitation reported for the shorter ones. Snow and ice contribute their melted (liquid) equivalent. Reported in millimeters (mm) or inches (in) depending on the unit specified in the request.

PressureTendency

The recent trend in atmospheric pressure - whether the pressure is rising, falling, or steady - returned as both a localized phrase and a one-letter code. Useful for anticipating short-term weather changes; falling pressure often signals deteriorating weather, while rising pressure typically indicates improving conditions.

TemperatureSummary

The highest and lowest air temperatures observed at the location over rolling windows ending at the observation time. Each value covers the full window measured back from "now" - for example, past12Hours reports the high and low across the most recent 12 hours, not just the twelfth hour - so the windows overlap and longer windows include the temperatures reported for the shorter ones. Reported in degrees Celsius (°C) or Fahrenheit (°F) depending on the unit specified in the request.

UnitType

An integer value associated with the type of unit being displayed. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For more information, see Weather services in Azure Maps.

WeatherDataUnit

Specifies whether to return data in metric or imperial units, with metric as the default. For example:

  • Metric: millimeter (mm), meter (m), kilometer (km), Celsius (C)
  • Imperial: inch (in), foot (ft), mile (mi), Fahrenheit (F)
WeatherValue

Values for weather-related metrics such as temperature, dew point, and wind speed, presented in either metric or imperial units, as specified in the unit URI parameter. For more information, see Unit types in the article Weather services in Azure Maps.

WindDetails

Provides the forecasted wind speed, measured in units such as kilometers per hour (km/h) or miles per hour (mph), depending on the unit specified in the request. Also indicates the wind direction measured in azimuth degrees, starting at true North and moving clockwise. North corresponds to 0°, east to 90°, south to 180°, and west to 270°. Possible values range from 0° to 359°.

WindDirection

Provides details about wind direction, including the direction in azimuth degrees and a localized abbreviation of the wind direction.

CurrentConditions

A single weather observation for the specified location, returned by the Get Current Conditions operation. Depending on the request's duration, this observation may be the latest (most recent) reading or one of the preceding hourly observations. By default a simplified subset is returned: observation date and time, weather phrase, icon code, precipitation indicator, and temperature. When the request asks for full details, every property is included, adding measurements such as RealFeel, dew point, wind, visibility, cloud cover, pressure, and rolling precipitation and temperature summaries for the past several hours.

Name Type Description
apparentTemperature

WeatherValue

The apparent temperature at the observation time - how the air actually feels to humans, taking into account air temperature, relative humidity, and wind speed. Measured in degrees Celsius (°C) or Fahrenheit (°F), depending on the unit specified in the request.

ceiling

WeatherValue

The cloud ceiling at the observation time - the height above the ground of the lowest cloud layer - in feet (ft) or meters (m) depending on the unit specified in the request. Important for aviation, since it affects flight visibility and operations.

cloudCover

integer (int32)

The percentage of the sky covered by clouds at the observation time, from 0 (clear) to 100 (overcast). May be NULL.

dateTime

string (date-time)

The date and time of this observation, in RFC 3339 format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, 2025-04-29T07:00:00-07:00.

dewPoint

WeatherValue

The dew point at the observation time - the temperature to which air must cool to become saturated (100% relative humidity). Measured in degrees Celsius (°C) or Fahrenheit (°F), depending on the unit specified in the request. A higher dew point indicates more moisture in the air.

hasPrecipitation

boolean

true if precipitation (rain, snow, sleet, or hail) is occurring at the observation time; otherwise false.

iconCode

IconCode

The representative weather icon code for this observation, paired with the phrase property. The numeric value corresponds to an Azure Maps weather icon - for the complete list, see Weather services in Azure Maps. May be NULL.

isDayTime

boolean

true if it is daytime at the specified location at the observation time; false if it is nighttime.

obstructionsToVisibility

string

A code identifying the dominant factor reducing visibility at the observation time, such as fog, smoke, haze, or precipitation. Useful for activities that depend on clear visibility, like driving and aviation.

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
pastTwentyFourHourTemperatureDeparture

WeatherValue

The change in air temperature compared to 24 hours ago, in degrees Celsius (°C) or Fahrenheit (°F), depending on the unit specified in the request. Positive values indicate the air is warmer than yesterday at the same time; negative values indicate it is cooler.

phrase

string

A short descriptive term for the weather conditions at the observation time - for example, Sunny or Partly Cloudy. Pairs with iconCode, which identifies the matching weather icon. For more information, see Weather services in Azure Maps.

precipitationSummary

PrecipitationSummary

A summary of liquid-equivalent precipitation amounts at the observation location over rolling windows of the past 1, 3, 6, 9, 12, 18, and 24 hours, in millimeters (mm) or inches (in) depending on the unit specified in the request.

pressure

WeatherValue

The atmospheric (air) pressure at ground level at the observation time, in millibars (mb) or inches of mercury (inHg), depending on the unit specified in the request.

pressureTendency

PressureTendency

The recent trend in atmospheric pressure - rising, falling, or steady. Useful for anticipating short-term weather changes; falling pressure often signals deteriorating weather, while rising pressure typically indicates improving conditions.

realFeelTemperature

WeatherValue

The RealFeel™ Temperature at the observation time, in degrees Celsius (°C) or Fahrenheit (°F), depending on the unit specified in the request. Developed by AccuWeather, RealFeel combines air temperature with humidity, wind, cloud cover, sun intensity, and other factors to indicate how the weather actually feels. For more information, see What is the AccuWeather RealFeel Temperature?

realFeelTemperatureShade

WeatherValue

The RealFeel™ Temperature at the observation time in shaded areas, in degrees Celsius (°C) or Fahrenheit (°F), depending on the unit specified in the request. Like realFeelTemperature, but excludes the warming effect of direct sunlight, giving a more accurate sense of how the weather feels in the shade.

relativeHumidity

integer (int32)

The relative humidity at the observation time, expressed as a percentage from 0 to 100 of the maximum amount of water vapor the air can hold at the same temperature.

temperature

WeatherValue

The air temperature at the observation time, in degrees Celsius (°C) or Fahrenheit (°F), depending on the unit specified in the request.

temperatureSummary

TemperatureSummary

A summary of the highest and lowest air temperatures observed at this location over rolling windows of the past 6, 12, and 24 hours, in degrees Celsius (°C) or Fahrenheit (°F) depending on the unit specified in the request.

uvIndex

integer (int32)

The ultraviolet (UV) index at the observation time, indicating the risk of harm from unprotected sun exposure. Supported values are:

  • 0-2: Low danger from the sun's UV rays for 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

A short descriptive label for uvIndex - for example, Low, Moderate, High, Very High, or Extreme.

visibility

WeatherValue

The horizontal visibility at the observation time - the distance at which an object or light can be clearly discerned - in kilometers (km) or miles (mi) depending on the unit specified in the request.

wetBulbTemperature

WeatherValue

The wet-bulb temperature at the observation time - the temperature the air would reach if cooled to saturation (100% relative humidity) by evaporating water into it at constant pressure. Measured in degrees Celsius (°C) or Fahrenheit (°F), depending on the unit specified in the request. Useful for assessing heat stress and evaporative cooling.

wind

WindDetails

The wind speed and direction at the observation time. Speed is in kilometers per hour (km/h) or miles per hour (mph) depending on the unit specified in the request; direction is in azimuth degrees, measured clockwise from true North (0° = N, 90° = E, 180° = S, 270° = W).

windChillTemperature

WeatherValue

The wind chill temperature at the observation time - how cold the air feels on exposed skin due to the combined effect of wind and low temperature. Typically lower than the actual air temperature. Measured in degrees Celsius (°C) or Fahrenheit (°F), depending on the unit specified in the request.

windGust

WindDetails

The maximum short-burst wind-gust speed and direction at the observation time, using the same units and azimuth convention as wind. Wind gusts are brief spikes in wind speed that can affect activities such as aviation, sailing, kite flying, and other outdoor events.

CurrentConditionsResult

The response returned by the Get Current Conditions operation, containing one or more current-conditions observations for a specified location. By default a single observation for the present time is returned; when the duration parameter is set to 6 or 24, the response also includes one observation per past hour over that window.

Name Type Description
results

CurrentConditions[]

The current-conditions observations, in chronological order with the most recent first. By default a single entry - the latest observation

  • is returned; the response may also contain one entry per hour over a recent rolling window (typically the past 6 or 24 hours), depending on the request.

ErrorAdditionalInfo

The resource management error additional info.

Name Type Description
info

maps.weather.getcurrentconditions

The additional info.

type

string

The additional info type.

ErrorDetail

The error detail.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

The error additional info.

code

string

The error code.

details

ErrorDetail[]

The error details.

message

string

The error message.

target

string

The error target.

ErrorResponse

Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).

Name Type Description
error

ErrorDetail

The error object.

IconCode

The numeric weather-condition code that identifies which icon to display. Each value in this enumeration corresponds to an Azure Maps weather icon (such as Sunny, Cloudy, or Thunderstorms) and pairs with a human-readable iconPhrase returned alongside it. The same code can appear in current, hourly, daily, quarter-day, and minute-by-minute responses, allowing applications to render a consistent icon set across all weather services.

For the complete list of codes, the icons they map to, and example imagery, see Weather services in Azure Maps.

Value Description
1

Sunny

2

Mostly Sunny

3

Partly Sunny

4

Intermittent Clouds

5

Hazy Sunshine

6

Mostly Cloudy

7

Cloudy

8

Dreary (Overcast)

11

Fog

12

Showers

13

Mostly Cloudy with Showers

14

Partly Sunny with Showers

15

Thunderstorms

16

Mostly Cloudy with Thunderstorms

17

Partly Sunny with Thunderstorms

18

Rain

19

Flurries

20

Mostly Cloudy with Flurries

21

Partly Sunny with Flurries

22

Snow

23

Mostly Cloudy with Snow

24

Ice

25

Sleet

26

Freezing Rain

29

Rain and Snow

30

Hot

31

Cold

32

Windy

33

Clear

34

Mostly Clear

35

Partly Cloudy

36

Intermittent Clouds

37

Hazy Moonlight

38

Mostly Cloudy

39

Partly Cloudy with Showers

40

Mostly Cloudy with Showers

41

Partly Cloudy with Thunderstorms

42

Mostly Cloudy with Thunderstorms

43

Mostly Cloudy with Flurries

44

Mostly Cloudy with Snow

JsonFormat

Desired format of the response. Only json format is supported.

Value Description
json

The JavaScript Object Notation Data Interchange Format

PastHoursTemperature

The highest and lowest air temperatures observed during one of the rolling windows on TemperatureSummary (past 6, 12, or 24 hours), in degrees Celsius (°C) or Fahrenheit (°F) depending on the unit specified in the request.

Name Type Description
maximum

WeatherValue

The highest temperature observed during the window.

minimum

WeatherValue

The lowest temperature observed during the window.

PrecipitationSummary

The total liquid-equivalent precipitation that has fallen at the observation location over rolling windows ending at the observation time. Each value covers the full window measured back from "now" - for example, past3Hours is the running total for the most recent three hours, not just the third hour - so the windows overlap and longer windows include the precipitation reported for the shorter ones. Snow and ice contribute their melted (liquid) equivalent. Reported in millimeters (mm) or inches (in) depending on the unit specified in the request.

Name Type Description
past12Hours

WeatherValue

Liquid-equivalent precipitation that has fallen in the past 12 hours.

past18Hours

WeatherValue

Liquid-equivalent precipitation that has fallen in the past 18 hours.

past24Hours

WeatherValue

Liquid-equivalent precipitation that has fallen in the past 24 hours.

past3Hours

WeatherValue

Liquid-equivalent precipitation that has fallen in the past 3 hours.

past6Hours

WeatherValue

Liquid-equivalent precipitation that has fallen in the past 6 hours.

past9Hours

WeatherValue

Liquid-equivalent precipitation that has fallen in the past 9 hours.

pastHour

WeatherValue

Liquid-equivalent precipitation that has fallen in the past hour.

PressureTendency

The recent trend in atmospheric pressure - whether the pressure is rising, falling, or steady - returned as both a localized phrase and a one-letter code. Useful for anticipating short-term weather changes; falling pressure often signals deteriorating weather, while rising pressure typically indicates improving conditions.

Name Type Description
code

string

A language-independent one-letter code for the pressure tendency: F = Falling, S = Steady, R = Rising.

localizedDescription

string

A short phrase describing the pressure tendency - for example, Falling, Steady, or Rising - returned in the language specified in the request.

TemperatureSummary

The highest and lowest air temperatures observed at the location over rolling windows ending at the observation time. Each value covers the full window measured back from "now" - for example, past12Hours reports the high and low across the most recent 12 hours, not just the twelfth hour - so the windows overlap and longer windows include the temperatures reported for the shorter ones. Reported in degrees Celsius (°C) or Fahrenheit (°F) depending on the unit specified in the request.

Name Type Description
past12Hours

PastHoursTemperature

Highest and lowest temperatures observed in the past 12 hours.

past24Hours

PastHoursTemperature

Highest and lowest temperatures observed in the past 24 hours.

past6Hours

PastHoursTemperature

Highest and lowest temperatures observed in the past 6 hours.

UnitType

An integer value associated with the type of unit being displayed. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For more information, see Weather services in Azure Maps.

Value Description
0

feet

1

inches

2

miles

3

millimeter

4

centimeter

5

meter

6

kilometer

7

kilometersPerHour

8

knots

9

milesPerHour

10

metersPerSecond

11

hectoPascals

12

inchesOfMercury

13

kiloPascals

14

millibars

15

millimetersOfMercury

16

poundsPerSquareInch

17

Celsius

18

Fahrenheit

19

kelvin

20

percent

21

float

22

integer

31

MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Specifies whether to return data in metric or imperial units, with metric as the default. For example:

  • Metric: millimeter (mm), meter (m), kilometer (km), Celsius (C)
  • Imperial: inch (in), foot (ft), mile (mi), Fahrenheit (F)
Value Description
imperial

Return data using imperial units such as Fahrenheit (F) for temperature and miles (mi) for distance.

metric

Return data using metric units such as Celsius (C) for temperature and kilometer (km) for distance.

WeatherValue

Values for weather-related metrics such as temperature, dew point, and wind speed, presented in either metric or imperial units, as specified in the unit URI parameter. For more information, see Unit types in the article Weather services in Azure Maps.

Name Type Description
unit

string

The unit of measurement used in the return value, such as "C" for Celsius, "F" for Fahrenheit.

unitType

UnitType

An integer representing the type of unit. For example, 0 for feet, 1 for inches, 2 for miles. For a complete list, see Unit types in the article Weather services in Azure Maps.

value

number (float)

The measured value expressed in the specified unit.

WindDetails

Provides the forecasted wind speed, measured in units such as kilometers per hour (km/h) or miles per hour (mph), depending on the unit specified in the request. Also indicates the wind direction measured in azimuth degrees, starting at true North and moving clockwise. North corresponds to 0°, east to 90°, south to 180°, and west to 270°. Possible values range from 0° to 359°.

Name Type Description
direction

WindDirection

Wind direction is measured in azimuth degrees, starting at true North (0°) and moving clockwise. East corresponds to 90°, south to 180°, and west to 270°. Possible values range from 0° to 359°. This property returns an integer representing the wind direction.

speed

WeatherValue

The expected wind speed, measured in kilometers per hour (km/h) or miles per hour (mph), depending on the unit specified in the request.

WindDirection

Provides details about wind direction, including the direction in azimuth degrees and a localized abbreviation of the wind direction.

Name Type Description
degrees

integer (int32)

Wind direction is measured in azimuth degrees, starting at true North and moving clockwise. North corresponds to 0 degrees, east to 90 degrees, south to 180 degrees, and west to 270 degrees. Possible values range from 0 to 359 degrees.

localizedDescription

string

A localized abbreviation of the wind direction, returned in the language specified in the request. For example, N for North, E for East, S for South, and W for West.