Get 7-day Weather Forecast

Last Updated on : 2025-09-08 07:50:26download

Get 7-day weather forecasts by latitude and longitude.

API address

GET: /v2.0/iot-03/weather/forecast/daily

Request parameter

Parameter name	Type	IN	Required	Description
lat	String	query	true	The latitude. Valid values: -90 to 90.
lon	String	query	true	The longitude. Valid values: -90 to 90.

Return parameter

Parameter name	Type	Description
result	WeatherForecastDailyResutDTO	The result object.

Description of result

Parameter name	Type	Description
coordinate	Coordinate	The coordinate object.
data	List	The weather details array object.

Description of coordinate

Parameter name	Type	Description
lat	String	The latitude. Valid values: -90 to 90.
lon	String	The longitude. Valid values: -90 to 90.

Description of data

Parameter name	Type	Description
time	Long	The timestamp of a specific forecast day.
zone_id	String	The ID of the specified time zone.
condition	String	The real-time weather.
condition_num	Integer	The code of the weather value type.
brief_condition	String	The brief weather overview. Valid values: `thunderstorm`: thunderstorm. `drizzle`: drizzle. `rain`: rain. `snow`: snow. `atmosphere`: heavy fog. `clear`: sunny. `clouds`: cloudy.
humidity	String	The humidity.
pressure	String	The air pressure.
temp	String	The temperature.
temp_unit	String	The temperature unit. Valid values: `f`: Fahrenheit `c`: Celsius
temperature_min	BigDecimal	The lowest temperature of the day, only available in the daily weather forecast.
temperature_max	BigDecimal	The highest temperature of the day, only available in the daily weather forecast.
real_feel	String	The apparent temperature.
apparent_temperature_min	BigDecimal	The lowest apparent temperature of the day, only available in the daily weather forecast.
apparent_temperature_max	BigDecimal	The highest apparent temperature of the day, only available in the daily weather forecast.
sunrise_inst	Long	The sunrise timestamp.
sunset_inst	Long	The sunset timestamp.
sun_rise	String	The local sunrise time in the format of `yyyy-MM-dd HH:mm`.
sun_set	String	The local sunset time in the format of `yyyy-MM-dd HH:mm`.
wind_speed	String	The wind speed.
wind_dir	String	The wind direction.
uvi	String	The ultraviolet intensity.

Request example

GET: /v2.0/iot-03/weather/forecast/daily?lat=30.29&lon=120.15

Return example

{
    "result": {
        "coordinate": {
            "lon": "120.15",
            "lat": "30.29"
        },
        "data": [
            {
                "sunset_inst": 1618223040000,
                "sun_set": "2021-04-12 18:24",
                "temp": "16",
                "apparent_temperature_min": {
                    "Value": "15"
                },
                "real_feel": "16",
                "temperature_max": {
                    "Value": "17"
                },
                "uvi": "0",
                "brief_condition": "rain",
                "pressure": "1013",
                "wind_dir": "N",
                "zone_id": "Asia/Shanghai",
                "condition": "Light Rain",
                "temperature_min": {
                    "Value": "15"
                },
                "apparent_temperature_max": {
                    "Value": "17"
                },
                "condition_num": 139,
                "sunrise_inst": 1618177020000,
                "humidity": "92",
                "sun_rise": "2021-04-12 05:37",
                "wind_speed": "0.9",
                "time": 1618156800000,
                "temp_unit": "c"
            }
        ]
    },
    "t": 1618215193513,
    "success": true
}

Error code

For more information, see error code.

Appendix 1: Weather overview list

condition_num	condition
120	Sunny
101	Heavy rain
102	Thunderstorm
103	Sandstorm
104	Light snow
105	Snow
106	Freezing fog
107	Rainstorm
108	Isolated shower
109	Dust
110	Thunder and lightning
111	Light shower
112	Rainy
113	Sleet
114	Dust devil
115	Ice pellet
116	Strong sandstorm
117	Sand blowing
118	Light to moderate rain
119	Mostly clear
121	Fog
122	Shower
123	Heavy shower
124	Heavy snow
125	Extraordinary rainstorm
126	Blizzard
127	Hail
128	Light to moderate snow
129	Partly cloudy
130	Light snow shower
131	Moderate snow
132	Overcast
133	Needle ice
134	Downpour
136	Thundershower and hail
137	Freezing rain
138	Snow shower
139	Light rain
140	Haze
141	Moderate rain
142	Cloudy
143	Thundershower
144	Moderate to heavy rain
145	Heavy rain to rainstorm
146	Clear

Prev DocWeather

Next DocGet Current Weather