Retrieves day-level and hour-level weather information.
Parameter structure
Field | Is nullable | Description | Example | ||
location | country | This field is required. | Country | China | |
province | This value cannot be empty. | Province | Zhejiang Province | ||
city | The value cannot be empty. | City | Hangzhou | ||
district | Required | District | Xihu District, Hangzhou | ||
realtimeData | weather | This field is required. | Weather | Fog | |
temp | This field cannot be empty. | Temperature | 7.0 | ||
tips | This value cannot be empty. | Suggestion | It's rainy and cold today. Dress warmly! | ||
windDir | This value cannot be empty. | Wind direction | West wind | ||
windLevel | This field is required. | Wind level | 2 | ||
sunRise | Must not be empty. | Sunrise time | 2024-12-12 06:46:00 | ||
sunDown | This field is required. | Sunset time | 2024-12-12 17:00:00 | ||
humidity | This field is required. | Humidity | 85 | ||
weatherForecastData | hourlyForecast[] | predictTime | This field is required. | Prediction time | 2024-12-12 17:00:00 |
predictHour | This field is required. | Prediction hour | 17 | ||
weather | A value is required. | Weather | Fog | ||
temp | The value cannot be empty. | Temperature | 7.0 | ||
windDir | This field cannot be empty. | Wind direction | Northwest wind | ||
windLevel | This field is required. | Wind level | 2 | ||
humidity | This field is required. | Humidity | 84 | ||
dailyForecast[] | predictDate | A value is required. | Prediction date | 2024-12-11 | |
windDirNight | Required | Night wind direction | Northwest wind | ||
windLevelNight | This field is required. | Night wind level | 2 | ||
weatherNight | This field is required. | Night weather | Clear | ||
windDirDay | This field is required. | Day wind direction | Northwest wind | ||
windLevelDay | This field cannot be empty. | Day wind level | 2 | ||
weatherDay | This field cannot be empty. | Day weather | Light rain | ||
tempLow | This field is required. | Lowest temperature | 4.0 | ||
tempHigh | Cannot be empty. | Highest temperature | 7.0 | ||
humidity | This field is required. | Humidity | 87 | ||
sunRise | This field is required. | Sunrise time | 2024-12-11 06:46:00 | ||
sunDown | This field is required. | Sunset time | 2024-12-11 17:05:00 | ||
Examples
Request
query: Weather in Beijing todayReturns
{
"location": {
"country": "China",
"province": "Beijing",
"city": "Beijing",
"district": "Beijing"
},
"realtimeData": {
"weather": "Haze",
"temp": "15.0",
"tips": "It's getting cold. Time to put on more clothes!",
"windDir": "East wind",
"windLevel": "3",
"sunRise": "2025-03-13 06:29:00",
"sunDown": "2025-03-13 18:19:00",
"humidity": "34"
},
"weatherForecastData": {
"hourlyForecast": [
{
"predictTime": "2025-03-13 18:00:00",
"predictHour": "18",
"weather": "Haze",
"temp": "17.0",
"windDir": "East wind",
"windLevel": "2",
"humidity": "35"
},
{
"predictTime": "2025-03-13 19:00:00",
"predictHour": "19",
"weather": "Cloudy",
"temp": "14.0",
"windDir": "East wind",
"windLevel": "2",
"humidity": "30"
},
{
"predictTime": "2025-03-13 20:00:00",
"predictHour": "20",
"weather": "Cloudy",
"temp": "12.0",
"windDir": "East wind",
"windLevel": "3",
"humidity": "34"
},
{
"predictTime": "2025-03-13 21:00:00",
"predictHour": "21",
"weather": "Cloudy",
"temp": "9.0",
"windDir": "East wind",
"windLevel": "3",
"humidity": "35"
},
{
"predictTime": "2025-03-13 22:00:00",
"predictHour": "22",
"weather": "Cloudy",
"temp": "8.0",
"windDir": "East wind",
"windLevel": "3",
"humidity": "32"
},
{
"predictTime": "2025-03-13 23:00:00",
"predictHour": "23",
"weather": "Cloudy",
"temp": "7.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "31"
},
{
"predictTime": "2025-03-14 0:00:00",
"predictHour": "0",
"weather": "Cloudy",
"temp": "6.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "30"
},
{
"predictTime": "2025-03-14 1:00:00",
"predictHour": "1",
"weather": "Cloudy",
"temp": "6.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "29"
},
{
"predictTime": "2025-03-14 2:00:00",
"predictHour": "2",
"weather": "Cloudy",
"temp": "6.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "30"
},
{
"predictTime": "2025-03-14 3:00:00",
"predictHour": "3",
"weather": "Cloudy",
"temp": "5.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "34"
},
{
"predictTime": "2025-03-14 4:00:00",
"predictHour": "4",
"weather": "Cloudy",
"temp": "5.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "40"
},
{
"predictTime": "2025-03-14 5:00:00",
"predictHour": "5",
"weather": "Cloudy",
"temp": "5.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "46"
},
{
"predictTime": "2025-03-14 6:00:00",
"predictHour": "6",
"weather": "Cloudy",
"temp": "5.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "53"
},
{
"predictTime": "2025-03-14 7:00:00",
"predictHour": "7",
"weather": "Cloudy",
"temp": "6.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "51"
},
{
"predictTime": "2025-03-14 8:00:00",
"predictHour": "8",
"weather": "Cloudy",
"temp": "6.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "47"
},
{
"predictTime": "2025-03-14 9:00:00",
"predictHour": "9",
"weather": "Cloudy",
"temp": "6.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "39"
},
{
"predictTime": "2025-03-14 10:00:00",
"predictHour": "10",
"weather": "Cloudy",
"temp": "7.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "31"
},
{
"predictTime": "2025-03-14 11:00:00",
"predictHour": "11",
"weather": "Cloudy",
"temp": "7.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "26"
},
{
"predictTime": "2025-03-14 12:00:00",
"predictHour": "12",
"weather": "Cloudy",
"temp": "7.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "25"
},
{
"predictTime": "2025-03-14 13:00:00",
"predictHour": "13",
"weather": "Cloudy",
"temp": "8.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "26"
},
{
"predictTime": "2025-03-14 14:00:00",
"predictHour": "14",
"weather": "Cloudy",
"temp": "8.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "27"
},
{
"predictTime": "2025-03-14 15:00:00",
"predictHour": "15",
"weather": "Cloudy",
"temp": "8.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "25"
},
{
"predictTime": "2025-03-14 16:00:00",
"predictHour": "16",
"weather": "Cloudy",
"temp": "8.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "24"
},
{
"predictTime": "2025-03-14 17:00:00",
"predictHour": "17",
"weather": "Cloudy",
"temp": "8.0",
"windDir": "Northeast wind",
"windLevel": "2",
"humidity": "42"
},
{
"predictTime": "2025-03-14 18:00:00",
"predictHour": "18",
"weather": "Cloudy",
"temp": "8.0",
"windDir": "East wind",
"windLevel": "2",
"humidity": "44"
}
],
"dailyForecast": [
{
"predictDate": "2025-03-12",
"windDirNight": "Southwest wind",
"windLevelNight": "2",
"weatherNight": "Clear",
"windDirDay": "Northwest wind",
"windLevelDay": "3",
"weatherDay": "Clear",
"tempLow": "4.0",
"tempHigh": "19.0",
"humidity": "12",
"sunRise": "2025-03-12 06:31:00",
"sunDown": "2025-03-12 18:18:00"
},
{
"predictDate": "2025-03-13",
"windDirNight": "East wind",
"windLevelNight": "3",
"weatherNight": "Cloudy",
"windDirDay": "Northeast wind",
"windLevelDay": "2",
"weatherDay": "Partly cloudy",
"tempLow": "5.0",
"tempHigh": "18.0",
"humidity": "23",
"sunRise": "2025-03-13 06:29:00",
"sunDown": "2025-03-13 18:19:00"
},
{
"predictDate": "2025-03-14",
"windDirNight": "East wind",
"windLevelNight": "2",
"weatherNight": "Cloudy",
"windDirDay": "Northeast wind",
"windLevelDay": "2",
"weatherDay": "Cloudy",
"tempLow": "3.0",
"tempHigh": "8.0",
"humidity": "39",
"sunRise": "2025-03-14 06:27:00",
"sunDown": "2025-03-14 18:20:00"
},
{
"predictDate": "2025-03-15",
"windDirNight": "Northwest wind",
"windLevelNight": "2",
"weatherNight": "Partly cloudy",
"windDirDay": "Northeast wind",
"windLevelDay": "2",
"weatherDay": "Light rain",
"tempLow": "-1.0",
"tempHigh": "6.0",
"humidity": "51",
"sunRise": "2025-03-15 06:26:00",
"sunDown": "2025-03-15 18:21:00"
},
{
"predictDate": "2025-03-16",
"windDirNight": "Northwest wind",
"windLevelNight": "2",
"weatherNight": "Partly cloudy",
"windDirDay": "Northwest wind",
"windLevelDay": "3",
"weatherDay": "Clear",
"tempLow": "-1.0",
"tempHigh": "8.0",
"humidity": "29",
"sunRise": "2025-03-16 06:24:00",
"sunDown": "2025-03-16 18:22:00"
},
{
"predictDate": "2025-03-17",
"windDirNight": "Northeast wind",
"windLevelNight": "2",
"weatherNight": "Partly cloudy",
"windDirDay": "Northwest wind",
"windLevelDay": "4",
"weatherDay": "Partly cloudy",
"tempLow": "1.0",
"tempHigh": "9.0",
"humidity": "26",
"sunRise": "2025-03-17 06:23:00",
"sunDown": "2025-03-17 18:23:00"
},
{
"predictDate": "2025-03-18",
"windDirNight": "Southwest wind",
"windLevelNight": "2",
"weatherNight": "Clear",
"windDirDay": "Northwest wind",
"windLevelDay": "2",
"weatherDay": "Partly cloudy",
"tempLow": "0.0",
"tempHigh": "11.0",
"humidity": "25",
"sunRise": "2025-03-18 06:21:00",
"sunDown": "2025-03-18 18:24:00"
},
{
"predictDate": "2025-03-19",
"windDirNight": "Southwest wind",
"windLevelNight": "2",
"weatherNight": "Clear",
"windDirDay": "Southwest wind",
"windLevelDay": "2",
"weatherDay": "Clear",
"tempLow": "4.0",
"tempHigh": "16.0",
"humidity": "26",
"sunRise": "2025-03-19 06:19:00",
"sunDown": "2025-03-19 18:25:00"
},
{
"predictDate": "2025-03-20",
"windDirNight": "Southwest wind",
"windLevelNight": "2",
"weatherNight": "Clear",
"windDirDay": "Southwest wind",
"windLevelDay": "2",
"weatherDay": "Clear",
"tempLow": "5.0",
"tempHigh": "19.0",
"humidity": "25",
"sunRise": "2025-03-20 06:18:00",
"sunDown": "2025-03-20 18:26:00"
},
{
"predictDate": "2025-03-21",
"windDirNight": "Southwest wind",
"windLevelNight": "2",
"weatherNight": "Clear",
"windDirDay": "South wind",
"windLevelDay": "2",
"weatherDay": "Clear",
"tempLow": "7.0",
"tempHigh": "21.0",
"humidity": "18",
"sunRise": "2025-03-21 06:16:00",
"sunDown": "2025-03-21 18:27:00"
},
{
"predictDate": "2025-03-22",
"windDirNight": "Northeast wind",
"windLevelNight": "1",
"weatherNight": "Clear",
"windDirDay": "Southeast wind",
"windLevelDay": "2",
"weatherDay": "Clear",
"tempLow": "10.0",
"tempHigh": "24.0",
"humidity": "18",
"sunRise": "2025-03-22 06:15:00",
"sunDown": "2025-03-22 18:28:00"
},
{
"predictDate": "2025-03-23",
"windDirNight": "Southwest wind",
"windLevelNight": "2",
"weatherNight": "Cloudy",
"windDirDay": "Southeast wind",
"windLevelDay": "2",
"weatherDay": "Clear",
"tempLow": "13.0",
"tempHigh": "28.0",
"humidity": "16",
"sunRise": "2025-03-23 06:13:00",
"sunDown": "2025-03-23 18:29:00"
},
{
"predictDate": "2025-03-24",
"windDirNight": "Northwest wind",
"windLevelNight": "4",
"weatherNight": "Clear",
"windDirDay": "Northwest wind",
"windLevelDay": "3",
"weatherDay": "Partly cloudy",
"tempLow": "3.0",
"tempHigh": "21.0",
"humidity": "28",
"sunRise": "2025-03-24 06:11:00",
"sunDown": "2025-03-24 18:30:00"
},
{
"predictDate": "2025-03-25",
"windDirNight": "Northwest wind",
"windLevelNight": "3",
"weatherNight": "Partly cloudy",
"windDirDay": "Northwest wind",
"windLevelDay": "3",
"weatherDay": "Cloudy",
"tempLow": "4.0",
"tempHigh": "15.0",
"humidity": "19",
"sunRise": "2025-03-25 06:10:00",
"sunDown": "2025-03-25 18:31:00"
},
{
"predictDate": "2025-03-26",
"windDirNight": "Southwest wind",
"windLevelNight": "2",
"weatherNight": "Clear",
"windDirDay": "Northwest wind",
"windLevelDay": "3",
"weatherDay": "Clear",
"tempLow": "5.0",
"tempHigh": "17.0",
"humidity": "16",
"sunRise": "2025-03-26 06:08:00",
"sunDown": "2025-03-26 18:32:00"
},
{
"predictDate": "2025-03-27",
"windDirNight": "South wind",
"windLevelNight": "2",
"weatherNight": "Cloudy",
"windDirDay": "Northwest wind",
"windLevelDay": "3",
"weatherDay": "Clear",
"tempLow": "8.0",
"tempHigh": "18.0",
"humidity": "16",
"sunRise": "2025-03-27 06:06:00",
"sunDown": "2025-03-27 18:33:00"
}
]
}
}