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.

Changes

Changed in 5 of the 10 revisions of this API.134

  • 1.03c076fdd291812See the full diff
    • added the new path request parameter format

      new-request-path-parameter

    • added the new optional header request parameter x-ms-client-id

      new-optional-request-parameter

    • added the new optional query request parameter language

      new-optional-request-parameter

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • api operation id GetCurrentConditions removed and replaced with Weather_GetCurrentConditions

      api-operation-id-removed

    • deleted the query request parameter language

      request-parameter-removed

    • api operation id Weather_GetCurrentConditions removed and replaced with GetCurrentConditions

      api-operation-id-removed

    • deleted the header request parameter x-ms-client-id

      request-parameter-removed

    • deleted the path request parameter format

      request-parameter-removed

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog