Daily Forecast

Returns a daily weather forecast for the specified latitude and longitude for up to 10 days, with 1-kilometer resolution and global coverage.

The response provides daytime [07:00, 19:00) and nighttime [19:00, 07:00 the following day) forecasts, including maximum and minimum temperature, weather condition, maximum wind gust, maximum UV index, precipitation amount and probability, mean sea-level pressure, humidity, wind direction and speed, cloud cover, sunrise and sunset, moonrise and moonset, moon phase, and more.

Endpoint#

GET /weather/v1/daily/{latitude}/{longitude}

Parameters#

Path parameters

  • latitude required
    number
    Latitude of the requested location in decimal degrees
  • longitude required
    number
    Longitude of the requested location in decimal degrees

Query parameters

  • days
    integer
    Number of forecast days. Value range: 1 - 10, default: 7
  • localTime
    boolean

    Whether to return local time for the requested location

    Possible values: false UTC time (default), true location's local time

  • lang
    string
    Language setting. See Language for behavior, configuration, and data availability

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/weather/v1/daily/39.92/116.41'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "metadata": {
    "tag": "dabb37d79f0ba4498d5b92c873d33c862921eb1cb688181b84b3948306ea66bc",
    "attributions": [
      "https://developer.qweather.com/attribution.html"
    ]
  },
  "days": [
    {
      "forecastStartTime": "2024-08-10T22:00Z",
      "forecastEndTime": "2024-08-11T22:00Z",
      "astro": {
        "sunrise": "2024-08-11T04:22Z",
        "sunset": "2024-08-11T19:34Z",
        "astronomicalDawn": "2024-08-11T01:52Z",
        "nauticalDawn": "2024-08-11T02:54Z",
        "civilDawn": "2024-08-11T03:44Z",
        "astronomicalDusk": "2024-08-11T22:04Z",
        "nauticalDusk": "2024-08-11T21:01Z",
        "civilDusk": "2024-08-11T20:12Z",
        "solarNoon": "2024-08-11T11:58Z",
        "solarMidnight": "2024-08-10T23:58Z",
        "moonrise": "2024-08-11T20:00Z",
        "moonset": "2024-08-11T04:57Z",
        "moonTransit": "2024-08-11T00:19Z",
        "moonUnderfoot": "2024-08-11T12:19Z",
        "moonPhase": "waning-gibbous"
      },
      "temperatureMax": {
        "value": 29.94,
        "unit": "°C"
      },
      "temperatureMin": {
        "value": 20.93,
        "unit": "°C"
      },
      "temperatureAvg": {
        "value": 25.57,
        "unit": "°C"
      },
      "uvIndexMax": 6,
      "daytime": {
        "forecastStartTime": "2024-08-11T05:00Z",
        "forecastEndTime": "2024-08-11T17:00Z",
        "condition": {
          "text": "Light Rain",
          "code": "305"
        },
        "temperatureMax": {
          "value": 29.94,
          "unit": "°C"
        },
        "temperatureMin": {
          "value": 20.93,
          "unit": "°C"
        },
        "wind": {
          "direction": {
            "degree": 270,
            "compass": "w"
          },
          "speed": {
            "value": 1.87,
            "unit": "m/s"
          },
          "scale": 2
        },
        "windGustMax": {
          "value": 6.64,
          "unit": "m/s"
        },
        "precipitation": {
          "amount": {
            "value": 0.75,
            "unit": "mm"
          },
          "probability": 0.64,
          "type": "rain"
        },
        "cloudCover": 0.32,
        "humidity": 0.52
      },
      "nighttime": {
        "forecastStartTime": "2024-08-11T17:00Z",
        "forecastEndTime": "2024-08-12T05:00Z",
        "condition": {
          "text": "Partly Cloudy",
          "code": "103"
        },
        "temperatureMax": {
          "value": 29.8,
          "unit": "°C"
        },
        "temperatureMin": {
          "value": 19.95,
          "unit": "°C"
        },
        "wind": {
          "direction": {
            "degree": 343,
            "compass": "nnw"
          },
          "speed": {
            "value": 2.33,
            "unit": "m/s"
          },
          "scale": 2
        },
        "windGustMax": {
          "value": 7.16,
          "unit": "m/s"
        },
        "precipitation": {
          "amount": {
            "value": 0,
            "unit": "mm"
          },
          "probability": 0,
          "type": "none"
        },
        "cloudCover": 0.34,
        "humidity": 0.56
      }
    },
    {
      "forecastStartTime": "2024-08-11T22:00Z",
      "forecastEndTime": "2024-08-12T22:00Z",
      "astro": {
        "sunrise": "2024-08-12T04:23Z",
        "sunset": "2024-08-12T19:32Z",
        "astronomicalDawn": "2024-08-12T01:54Z",
        "nauticalDawn": "2024-08-12T02:56Z",
        "civilDawn": "2024-08-12T03:45Z",
        "astronomicalDusk": "2024-08-12T22:01Z",
        "nauticalDusk": "2024-08-12T20:59Z",
        "civilDusk": "2024-08-12T20:10Z",
        "solarNoon": "2024-08-12T11:58Z",
        "solarMidnight": "2024-08-11T23:58Z",
        "moonrise": "2024-08-12T20:17Z",
        "moonset": "2024-08-12T06:10Z",
        "moonTransit": "2024-08-12T01:05Z",
        "moonUnderfoot": "2024-08-12T13:05Z",
        "moonPhase": "waning-gibbous"
      },
      "temperatureMax": {
        "value": 29.24,
        "unit": "°C"
      },
      "temperatureMin": {
        "value": 19.72,
        "unit": "°C"
      },
      "temperatureAvg": {
        "value": 23.99,
        "unit": "°C"
      },
      "uvIndexMax": 6,
      "daytime": {
        "forecastStartTime": "2024-08-12T05:00Z",
        "forecastEndTime": "2024-08-12T17:00Z",
        "condition": {
          "text": "Cloudy",
          "code": "101"
        },
        "temperatureMax": {
          "value": 29.24,
          "unit": "°C"
        },
        "temperatureMin": {
          "value": 19.72,
          "unit": "°C"
        },
        "wind": {
          "direction": {
            "degree": 338,
            "compass": "nnw"
          },
          "speed": {
            "value": 1.6,
            "unit": "m/s"
          },
          "scale": 2
        },
        "windGustMax": {
          "value": 7.03,
          "unit": "m/s"
        },
        "precipitation": {
          "amount": {
            "value": 0,
            "unit": "mm"
          },
          "probability": 0,
          "type": "none"
        },
        "cloudCover": 0.51,
        "humidity": 0.55
      },
      "nighttime": {
        "forecastStartTime": "2024-08-12T17:00Z",
        "forecastEndTime": "2024-08-13T05:00Z",
        "condition": {
          "text": "Partly Cloudy",
          "code": "103"
        },
        "temperatureMax": {
          "value": 28.68,
          "unit": "°C"
        },
        "temperatureMin": {
          "value": 18.5,
          "unit": "°C"
        },
        "wind": {
          "direction": {
            "degree": 336,
            "compass": "nnw"
          },
          "speed": {
            "value": 2.97,
            "unit": "m/s"
          },
          "scale": 2
        },
        "windGustMax": {
          "value": 10.21,
          "unit": "m/s"
        },
        "precipitation": {
          "amount": {
            "value": 0,
            "unit": "mm"
          },
          "probability": 0,
          "type": "none"
        },
        "cloudCover": 0.41,
        "humidity": 0.57
      }
    }
  ]
}
  • metadata
    object
    Metadata for this response
    • tag
      string
      Unique data identifier
    • attributions
      array
      Data attribution or statements that must be displayed with the response data
  • days
    array
    Daily weather forecast list
    • forecastStartTime
      date-time
      Forecast start time
    • forecastEndTime
      date-time
      Forecast end time
    • astro
      object
      Solar and lunar events
      • sunrise
        date-time
        Sunrise time
      • sunset
        date-time
        Sunset time
      • astronomicalDawn
        date-time
        Start time of astronomical dawn
      • nauticalDawn
        date-time
        Start time of nautical dawn
      • civilDawn
        date-time
        Start time of civil dawn
      • astronomicalDusk
        date-time
        End time of astronomical dusk
      • nauticalDusk
        date-time
        End time of nautical dusk
      • civilDusk
        date-time
        End time of civil dusk
      • solarNoon
        date-time
        Solar noon
      • solarMidnight
        date-time
        Solar midnight
      • moonrise
        date-time
        Moonrise time
      • moonset
        date-time
        Moonset time
      • moonTransit
        date-time
        Upper lunar transit time
      • moonUnderfoot
        date-time
        Lower lunar transit time
      • moonPhase
        string

        The dominant moon phase for that day

        Possible values: new-moon, waxing-crescent, first-quarter, waxing-gibbous, full-moon, waning-gibbous, last-quarter, waning-crescent

    • temperatureMax
      object
      Maximum temperature during the forecast period
      • value
        number
        Value
      • unit
        string
        Unit
    • temperatureMin
      object
      Minimum temperature during the forecast period
      • value
        number
        Value
      • unit
        string
        Unit
    • temperatureAvg
      object
      Average temperature for the day
      • value
        number
        Value
      • unit
        string
        Unit
    • uvIndexMax
      number
      Maximum UV index for the day. Value range: [0, 15]
    • daytime
      object
      Daytime forecast, local time [07:00, 19:00)
      • forecastStartTime
        date-time
        Forecast start time
      • forecastEndTime
        date-time
        Forecast end time
      • condition
        object
        Weather condition
        • text
          string
          Localized weather-condition description
        • code
          string
          Weather condition code
      • temperatureMax
        object
        Maximum temperature during the forecast period
        • value
          number
          Value
        • unit
          string
          Unit
      • temperatureMin
        object
        Minimum temperature during the forecast period
        • value
          number
          Value
        • unit
          string
          Unit
      • humidity
        number
        Average relative humidity for the forecast period. Value range: [0, 1]
      • wind
        object
        Wind object
        • direction
          object
          Wind direction
          • degree
            number
            Wind direction in degrees, value range: [0, 365]
          • compass
            string

            Wind direction compass code

            Possibe values: n, nne, ne, ene, e, ese, se, sse, s, ssw, sw, wsw, w, wnw, nw, nnw, none, vrb

        • speed
          object
          Wind speed
          • value
            number
            Value
          • unit
            string
            Unit
        • scale
          number
          Beaufort wind scale
      • windGustMax
        object
        Maximum gust speed for this forecast period
        • value
          number
          Value
        • unit
          string
          Unit
      • precipitation
        object
        Precipitation data
        • amount
          object
          Accumulated precipitation amount for the data period
          • value
            number
            Value
          • unit
            string
            Unit
        • type
          string

          Precipitation type

          Possible Values: rain, snow, ice, mixed, none, unknown

        • probability
          number
          Forecast precipitation probability. Value range: [0, 1]
      • cloudCover
        number
        Average cloud cover for the forecast period. Value range: [0, 1]
    • nighttime
      object
      Nighttime forecast, local time [19:00, 07:00 the following day)
      • forecastStartTime
        date-time
        Forecast start time
      • forecastEndTime
        date-time
        Forecast end time
      • condition
        object
        Weather condition
        • text
          string
          Localized weather-condition description
        • code
          string
          Weather condition code
      • temperatureMax
        object
        Maximum temperature during the forecast period
        • value
          number
          Value
        • unit
          string
          Unit
      • temperatureMin
        object
        Minimum temperature during the forecast period
        • value
          number
          Value
        • unit
          string
          Unit
      • humidity
        number
        Average relative humidity for the forecast period. Value range: [0, 1]
      • wind
        object
        Wind object
        • direction
          object
          Wind direction
          • degree
            number
            Wind direction in degrees, value range: [0, 365]
          • compass
            string

            Wind direction compass code

            Possibe values: n, nne, ne, ene, e, ese, se, sse, s, ssw, sw, wsw, w, wnw, nw, nnw, none, vrb

        • speed
          object
          Wind speed
          • value
            number
            Value
          • unit
            string
            Unit
        • scale
          number
          Beaufort wind scale
      • windGustMax
        object
        Maximum gust speed for this forecast period
        • value
          number
          Value
        • unit
          string
          Unit
      • precipitation
        object
        Precipitation data
        • amount
          object
          Accumulated precipitation amount for the data period
          • value
            number
            Value
          • unit
            string
            Unit
        • type
          string

          Precipitation type

          Possible Values: rain, snow, ice, mixed, none, unknown

        • probability
          number
          Forecast precipitation probability. Value range: [0, 1]
      • cloudCover
        number
        Average cloud cover for the forecast period. Value range: [0, 1]