Use to get a detailed hourly weather forecast for up to 24 hours or a daily forecast for up to 10 days.

The Get Hourly Forecast API is an HTTP GET that Request detailed weather forecast by the hour for the next 1, 12, 24 (1 day), 72 (3 days), 120 (5 days), and 240 hours (10 days) for the given the given coordinate location. The API returns details such as temperature, humidity, wind, precipitation, and ultraviolet (UV) index. For more information, see Request hourly weather forecast data.

If you are using the Gen1 S0 pricing tier, you can request hourly forecast for the next 1, 12, 24 hours (1 day), and 72 hours (3 days). If you are using Gen1 S1 or Gen2 pricing tier, you can also request hourly forecast for the next 120 (5 days) and 240 hours (10 days).

get/weather/forecast/hourly/{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.

durationinteger

Time frame of the returned weather forecast. By default, the forecast data for next hour will be returned. Available values are

  • 1 - Return forecast data for the next hour. Default value.
  • 12 - Return hourly forecast for next 12 hours.
  • 24 - Return hourly forecast for next 24 hours.
  • 72 - Return hourly forecast for next 72 hours (3 days).
  • 120 - Return hourly forecast for next 120 hours (5 days). Only available in S1 SKU.
  • 240 - Return hourly forecast for next 240 hours (10 days). Only available in S1 SKU.
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 GetHourlyForecast removed and replaced with Weather_GetHourlyForecast

      api-operation-id-removed

    • deleted the query request parameter language

      request-parameter-removed

    • api operation id Weather_GetHourlyForecast removed and replaced with GetHourlyForecast

      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