---
title: "Use to get a detailed hourly weather forecast for up to 24 hours or a daily
forecast for up to 10 days."
method: GET
path: "/weather/forecast/hourly/{format}"
---

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

`GET /weather/forecast/hourly/{format}`

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](/azure/azure-maps/how-to-request-weather-data#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).

## Path parameters

- `format` 'json', required

## Query parameters

- `api-version` string, required
- `query` number[], required
- `unit` 'imperial' | 'metric'
- `duration` integer
- `language` string

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- HourlyForecastResult — Hourly weather forecast result.
  - `forecasts` HourlyForecast[] — Forecast data for each returned hour.
    - `date` string, date-time — Date and time of the forecast in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27T19:39:57-08:00.
    - `iconCode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 — Numeric value representing an image that corresponds to the current weather condition described by the `Phrase` property. For more information, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#weather-icons). May be NULL.
    - `iconPhrase` string — Phrase description of the weather icon.
    - `hasPrecipitation` boolean — A boolean value that indicates whether precipitation (rain, snow, sleet, or hail) is expected during the specified timeframe. Returns true if precipitation is expected, otherwise false.
    - `isDaylight` boolean — Specifies whether or not it is daylight. True indicates day light.
    - `temperature` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `realFeelTemperature` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `wetBulbTemperature` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `dewPoint` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `wind` WindDetails — Wind details being returned including speed and direction.
      - `direction` WindDirection — Wind direction
        - `degrees` integer — 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.
        - `localizedDescription` string — Direction abbreviation in the specified language.
      - `speed` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `windGust` WindDetails — Wind details being returned including speed and direction.
      - `direction` WindDirection — Wind direction
        - `degrees` integer — 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.
        - `localizedDescription` string — Direction abbreviation in the specified language.
      - `speed` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `relativeHumidity` integer — 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.
    - `visibility` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `ceiling` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `uvIndex` integer — 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.
    - `uvIndexPhrase` string — Phrase associated with the `uvIndex`.
    - `precipitationProbability` integer — Percent representing the probability of precipitation. For example, '20'.
    - `rainProbability` integer — Percent representing the probability of rain. For example, '50'.
    - `snowProbability` integer — Percent representing the probability of snow. For example, '50'.
    - `iceProbability` integer — Percent representing the probability of snow. For example, '5'.
    - `totalLiquid` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `rain` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `snow` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `ice` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `cloudCover` integer — Percent representing cloud cover.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/maps-weather.md) · [All operations](https://skmtc.net/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/maps-weather/revisions/3c076fdd2918/schema)