Get Current Weather

Last Updated on : 2023-06-15 05:33:21

Get the current weather condition by latitude and longitude.

API address

GET: /v2.0/iot-03/weather/current

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: -180 to 180.

Return parameter

Parameter name	Type	Description
result	CurrentWeatherResutDTO	The result object.

Description of result

Parameter name	Type	Description
coordinate	Coordinate	The coordinate object.
current_weather	CurrentWeather	The current weather.
air_quality	CurrentAirQuality	The air quality.

Description of coordinate

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

Description of air_quality

Parameter name	Type	Description
aqi	String	The air quality index.
pm25	String	pm 2.5
pm10	String	pm 10
so2	String	Sulfur dioxide.
o3	String	Ozone.
no2	String	Nitrogen dioxide.
co	String	Carbon monoxide.

Description of current_weather

Parameter name	Type	Description
condition	String	The weather overview.
condition_num	String	The number of the specified weather overview.
temp	String	The temperature.
humidity	String	The humidity percentage.
pressure	String	The air pressure. Unit: millibar (mbar) and hectopascal (hPa). 1 mbar = 100 Pa = 1 hPa
real_feel	String	The apparent temperature.
uvi	String	The ultraviolet index.
wind_speed	String	The wind speed.

Request example

GET: /v2.0/iot-03/weather/current?lat=30.24259&lon=120.16929

{}

Return example

{
    "result": {
        "coordinate": {
            "lon": "120.16929",
            "lat": "30.24259"
        },
        "air_quality": {
            "o3": "18.0",
            "pm10": "18.0",
            "co": "0.7",
            "no2": "44.0",
            "pm25": "12.0",
            "so2": "4.0",
            "aqi": "22"
        },
        "current_weather": {
            "temp": "16",
            "real_feel": "17",
            "uvi": "1",
            "pressure": "1013",
            "condition": "Overcast",
            "condition_num": "132",
            "humidity": "98",
            "wind_speed": "1.4"
        }
    },
    "t": 1618215193513,
    "success": true
}

Error code

For more information, see error code.

Appendix 1: Weather Conditions

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	Rain
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 DocGet 7-day Weather Forecast

Next DocGet Weather History for the Past 24 Hours