Sign in

v2

latestSwagger 2.02026-07-131892241.6 KB

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/weather/currentConditions/{format}

Path parameters

format'json' required

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

Query parameters

api-versionstring required

The API version to use for this operation.

querynumber[] required

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.

unit'imperial' | 'metric'

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

detailsstring

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.
durationinteger

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.
languagestring

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.

Headers

x-ms-client-idstring

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.

Response

The request has succeeded.