Azure Maps Weather Service (stable:1.1)

2025/01/28 • 1 updated methods

Weather_GetCurrentConditions (updated)
Description :  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)
Reference :  Link ¶

⚶ Changes

{
  "#id": "Weather_GetCurrentConditions",
  "$responses": {
    "200": {
      "$properties": {
        "results": {
          "$properties": {
            "precipitationSummary": [
              {
                "@added_292f37322fd24bb99f231400a0e83288": {
                  "#name": "past3Hours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past three hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@added_9ff805a9531540a0867a409b485350ec": {
                  "#name": "past6Hours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past six hours. Contains Metric and Imperial Values.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@added_bdc64317c12d4b23818653e52894aa89": {
                  "#name": "past9Hours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past nine hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@added_e4592c414cff485bbced18af6a433e97": {
                  "#name": "past12Hours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past 12 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@added_17f540993c8c491aa475b4f43b38e80b": {
                  "#name": "past18Hours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past 18 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@added_cb3a8716e2f34c92ac2389f7bcc4e418": {
                  "#name": "past24Hours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past 24 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@removed_a92cf7774d1144eea24fcedf0142ecc5": {
                  "#name": "pastThreeHours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past three hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@removed_e932dd52b5284f5abff41d89559ca1d8": {
                  "#name": "pastSixHours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past six hours. Contains Metric and Imperial Values.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@removed_fd26c67f9a1e45fbac82d94e73da293c": {
                  "#name": "pastNineHours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past nine hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@removed_0cc0f2c0fcc041ceb5be162df367a5b7": {
                  "#name": "pastTwelveHours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past 12 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@removed_c107bde348f347f88b23a89d7644d6d5": {
                  "#name": "pastEighteenHours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past 18 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              },
              {
                "@removed_443d24b838f446e78d052932b9465473": {
                  "#name": "pastTwentyFourHours",
                  "Description": "The amount of precipitation (liquid equivalent) that has fallen in the past 24 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "value",
                      "Description": "Rounded value.",
                      "Format": "float",
                      "Required": false,
                      "Type": "number"
                    },
                    {
                      "#name": "unit",
                      "Description": "Type of unit for the returned value.",
                      "Required": false,
                      "Type": "string"
                    },
                    {
                      "#name": "unitType",
                      "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                      "Format": "int32",
                      "Required": false,
                      "Type": "integer"
                    }
                  ]
                }
              }
            ],
            "temperatureSummary": [
              {
                "@added_7d5337b8e65d4225839b96814dcebc49": {
                  "#name": "past6Hours",
                  "Description": "Summary of temperature fluctuations over the past 6 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "minimum",
                      "Description": "minimum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    },
                    {
                      "#name": "maximum",
                      "Description": "maximum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    }
                  ]
                }
              },
              {
                "@added_5ea2a0e02fc840beb682c029bfcf182a": {
                  "#name": "past12Hours",
                  "Description": "Summary of temperature fluctuations over the past 12 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "minimum",
                      "Description": "minimum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    },
                    {
                      "#name": "maximum",
                      "Description": "maximum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    }
                  ]
                }
              },
              {
                "@added_2daaea356514437484abadb08e364fb3": {
                  "#name": "past24Hours",
                  "Description": "Summary of temperature fluctuations over the past 24 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "minimum",
                      "Description": "minimum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    },
                    {
                      "#name": "maximum",
                      "Description": "maximum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    }
                  ]
                }
              },
              {
                "@removed_3d40595ccb8b4b87af7abacff9150678": {
                  "#name": "pastSixHours",
                  "Description": "Summary of temperature fluctuations over the past 6 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "minimum",
                      "Description": "minimum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    },
                    {
                      "#name": "maximum",
                      "Description": "maximum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    }
                  ]
                }
              },
              {
                "@removed_1a236c69ffed4afca3770d1c94371e51": {
                  "#name": "pastTwelveHours",
                  "Description": "Summary of temperature fluctuations over the past 12 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "minimum",
                      "Description": "minimum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    },
                    {
                      "#name": "maximum",
                      "Description": "maximum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    }
                  ]
                }
              },
              {
                "@removed_b958019fafb64d63b4caa6cc2c4bc396": {
                  "#name": "pastTwentyFourHours",
                  "Description": "Summary of temperature fluctuations over the past 24 hours.",
                  "Required": false,
                  "Type": "object",
                  "$properties": [
                    {
                      "#name": "minimum",
                      "Description": "minimum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    },
                    {
                      "#name": "maximum",
                      "Description": "maximum",
                      "Required": false,
                      "Type": "object",
                      "$properties": [
                        {
                          "#name": "value",
                          "Description": "Rounded value.",
                          "Format": "float",
                          "Required": false,
                          "Type": "number"
                        },
                        {
                          "#name": "unit",
                          "Description": "Type of unit for the returned value.",
                          "Required": false,
                          "Type": "string"
                        },
                        {
                          "#name": "unitType",
                          "Description": "Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details.",
                          "Format": "int32",
                          "Required": false,
                          "Type": "integer"
                        }
                      ]
                    }
                  ]
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /weather/currentConditions/{format}
{
x-ms-client-id:
{
Description: Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance. ,
Required: False ,
}
string ,
api-version:
{
Description: Version number of Azure Maps API. ,
Required: True ,
}
string ,
format:
{
Description: Desired format of the response. Only `json` format is supported. ,
Required: True ,
}
string ,
query:
{
Description: 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. ,
Required: True ,
}
array ,
unit:
{
Description: Specifies to return the data in either metric units or imperial units. Default value is metric. ,
Required: False ,
}
string ,
details:
{
Description: 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. ,
Required: False ,
}
string ,
duration:
{
Description: 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. ,
Required: False ,
}
integer ,
language:
{
Description: 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](https://docs.microsoft.com/azure/azure-maps/supported-languages) for details. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
results:
{
Description: Detailed current weather conditions. ,
Required: False ,
}
[
{
dateTime:
{
Description: Date and time of the current observation displayed in ISO 8601 format, for example, 2019-10-27T19:39:57-08:00. ,
Format: date-time ,
Required: False ,
}
string ,
phrase:
{
Description: Phrase description of the current weather condition. Displayed in specified language. ,
Required: False ,
}
string ,
iconCode:
{
Description: Numeric value representing an image that displays the `iconPhrase`. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#weather-icons) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
hasPrecipitation:
{
Description: Indicates the presence or absence of precipitation. True indicates the presence of precipitation, false indicates the absence of precipitation. ,
Required: False ,
}
boolean ,
isDayTime:
{
Description: Indicates the time of the day. True indicates 'day',', false indicates 'night. ,
Required: False ,
}
boolean ,
temperature:
{
Description: Temperature being returned. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
realFeelTemperature:
{
Description: RealFeel™ Temperature being returned. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
realFeelTemperatureShade:
{
Description: RealFeel™ Temperature being returned. Describes what the temperature really feels like in the shade. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
relativeHumidity:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
dewPoint:
{
Description: The dewpoint temperature in specified unit. The dewpoint temperature is the temperature that the air must be cooled to in order to reach saturation. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
wind:
{
Description: Wind details being returned including speed and direction. ,
Required: False ,
}
{
direction:
{
Description: Wind direction ,
Required: False ,
}
{
degrees:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
localizedDescription:
{
Description: Direction abbreviation in the specified language. ,
Required: False ,
}
string ,
}
,
speed:
{
Description: Speed of the wind in specified unit. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
windGust:
{
Description: Wind gust. Wind gust is a sudden, brief increase in speed of the wind. ,
Required: False ,
}
{
direction:
{
Description: Wind direction ,
Required: False ,
}
{
degrees:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
localizedDescription:
{
Description: Direction abbreviation in the specified language. ,
Required: False ,
}
string ,
}
,
speed:
{
Description: Speed of the wind in specified unit. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
uvIndex:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
uvIndexPhrase:
{
Description: Phrase associated with the `uvIndex`. ,
Required: False ,
}
string ,
visibility:
{
Description: Visibility in specified unit. A measure of the distance at which an object or light can be clearly discerned. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
obstructionsToVisibility:
{
Description: 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_ ,
Required: False ,
}
string ,
cloudCover:
{
Description: Percent representing cloud cover. ,
Format: int32 ,
Required: False ,
}
integer ,
ceiling:
{
Description: Cloud ceiling in specified unit. The ceiling is a measurement of the height of the base of the lowest clouds. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
pressure:
{
Description: Atmospheric pressure in specified unit. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
pressureTendency:
{
Description: Atmospheric pressure change. ,
Required: False ,
}
{
localizedDescription:
{
Description: Description of the pressure tendency in specified language ,
Required: False ,
}
string ,
code:
{
Description: Pressure tendency code regardless of language. One of F=Falling, S=Steady, R=Rising. ,
Required: False ,
}
string ,
}
,
pastTwentyFourHourTemperatureDeparture:
{
Description: Departure from the temperature observed 24 hours ago in specified unit. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
apparentTemperature:
{
Description: Perceived outdoor temperature caused by the combination of air temperature, relative humidity, and wind speed in specified unit. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
windChillTemperature:
{
Description: Perceived air temperature on exposed skin due to wind. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
wetBulbTemperature:
{
Description: The temperature to which air may be cooled by evaporating water into it at constant pressure until it reaches saturation. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
precipitationSummary:
{
Description: Summary of precipitation amounts over the past 24 hours. ,
Required: False ,
}
{
pastHour:
{
Description: The amount of precipitation (liquid equivalent) that has fallen in the past hour. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
past3Hours:
{
Description: The amount of precipitation (liquid equivalent) that has fallen in the past three hours. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
past6Hours:
{
Description: The amount of precipitation (liquid equivalent) that has fallen in the past six hours. Contains Metric and Imperial Values. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
past9Hours:
{
Description: The amount of precipitation (liquid equivalent) that has fallen in the past nine hours. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
past12Hours:
{
Description: The amount of precipitation (liquid equivalent) that has fallen in the past 12 hours. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
past18Hours:
{
Description: The amount of precipitation (liquid equivalent) that has fallen in the past 18 hours. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
past24Hours:
{
Description: The amount of precipitation (liquid equivalent) that has fallen in the past 24 hours. ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
temperatureSummary:
{
Description: Summary of temperature fluctuations over the past 6, 12, and 24 hours. ,
Required: False ,
}
{
past6Hours:
{
Description: Summary of temperature fluctuations over the past 6 hours. ,
Required: False ,
}
{
minimum:
{
Description: minimum ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
maximum:
{
Description: maximum ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
past12Hours:
{
Description: Summary of temperature fluctuations over the past 12 hours. ,
Required: False ,
}
{
minimum:
{
Description: minimum ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
maximum:
{
Description: maximum ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
past24Hours:
{
Description: Summary of temperature fluctuations over the past 24 hours. ,
Required: False ,
}
{
minimum:
{
Description: minimum ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
maximum:
{
Description: maximum ,
Required: False ,
}
{
value:
{
Description: Rounded value. ,
Format: float ,
Required: False ,
}
number ,
unit:
{
Description: Type of unit for the returned value. ,
Required: False ,
}
string ,
unitType:
{
Description: Numeric ID value associated with the type of unit being displayed. Can be used for unit translation. Please refer to [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types) for details. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}