Sign in

v2

latestSwagger 2.02026-07-131892241.6 KB

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.