---
title: "Use to get a Quarter-Day Forecast for the next 1, 5, 10, or 15 days."
method: GET
path: "/weather/forecast/quarterDay/{format}"
---

# Use to get a Quarter-Day Forecast for the next 1, 5, 10, or 15 days.

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

The `Get Quarter-Day Forecast` API is an HTTP `GET` request that returns a
detailed weather forecast by quarter-day for the next 1, 5, 10, or 15 days for
a given location. Response data is presented by quarters of the day - morning,
afternoon, evening, and overnight. Details such as temperature, humidity, wind,
precipitation, and UV index are returned.

## 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.

- QuarterDayForecastResult — Quarter-day weather forecast result.
  - `forecasts` QuarterDayForecast[] — Forecast data for each quarter in the response.
    - `date` string, date-time — Date of the forecast as example, 2019-10-27T00:00:00
    - `effectiveDate` string, date-time — Date and time of the beginning of the forecast quarter displayed in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27T19:39:57-08:00.
    - `quarter` 0 | 1 | 2 | 3 — Divides the day into four 6-hour quarters. Valid values are 0-3:<ul><li>0: Morning (7am - 1pm)</li><li>1: Afternoon (1pm - 7pm)</li><li>2: Evening (7pm - 1am)</li><li>3: Overnight (1am - 7am)</li></ul>
    - `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 icon. Displayed in specified language. For example, 'Sunny'.
    - `phrase` string — Short summary phrase summary for quarter.
    - `temperature` WeatherValueRange — Returned temperature values.
      - `minimum` 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).
      - `maximum` 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` WeatherValueRange — Returned temperature values.
      - `minimum` 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).
      - `maximum` 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).
    - `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.
    - `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).
    - `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).
    - `cloudCover` integer — Percent representing cloud cover.
    - `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.
    - `precipitationType` 'Ice' | 'Mix' | 'Rain' | 'Snow' — Specifies the type of precipitation. Valid values are Rain, Snow, Ice, or Mix. This property is included in the response when dBZ is greater than zero.
    - `precipitationIntensity` string — Description of the intensity.
    - `precipitationProbability` integer — Percent representing the probability of precipitation. For example, '20'.
    - `thunderstormProbability` integer — Percent representing the probability of a thunderstorm. For example, '10'.
    - `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).

## 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)