1、首先進入和風天氣開發平台,點擊右上角的注冊進行注冊
和風天氣開發平台
2、填寫注冊用的郵箱和密碼完成注冊,可能還需要手機號,按提示注冊完成即可。
3、從和風天氣開發平台右上角進入控制台,輸入你剛剛注冊用的郵箱和密碼按登錄進入控制台
4、點擊應用管理——創建應用
5、選擇免費開發版,然后下一步
6、應用名稱隨便寫
7、API要選擇WebApi
API要選擇WebApi
API要選擇WebApi
(如果開發安卓或者IOS請無視本條)
8、key的名字,隨便寫
9、創建完成后就是這樣,key下面那一串數字就是你的key,請求其他api時都需要用到這個key,請妥善保存。
官方api文檔地址:api文檔地址,可以在里面查閱所有api的信息,包括請求方式、參數、響應參數等。
所有api返回信息均為json格式。
以下舉例兩個常用的Api:
GeoApi的使用,用於查詢城市的id等信息(這里使用POSTMAN進行測試)GeoApi為每天50000次限制
https://geoapi.qweather.com/v2/city/lookup?key=這里填你的key&location=要查詢的城市名字
參數中key為上面的那個key,location為要查詢的城市信息,以福州市為例
注意返回的結果用gzip壓縮,需要解壓才行(Java中可以用GZipInputStream,Java或者Kotlin用OkHttp或者HttpClient版本>4.3的默認會自動解壓gzip可以無視本條)
在body中就是api返回的福州市及其下屬行政區域的信息,通常來說,我們只需要location中的第一個城市信息,此處為福州市,記下它的id 101230101
"code": "200",
"location": [
{
"name": "福州",
"id": "101230101",
"lat": "26.07530",
"lon": "119.30623",
"adm2": "福州",
"adm1": "福建省",
"country": "中國",
"tz": "Asia/Shanghai",
"utcOffset": "+08:00",
"isDst": "0",
"type": "city",
"rank": "11",
"fxLink": "http://hfx.link/34w1"
},...(其余信息省略)
三日天氣api的使用:https://devapi.qweather.com/v7/weather/3d?key=這里填你的key&location=要查詢的城市的id
id可以通過上面的GeoApi來查詢,免費用戶每天可以查詢1000次
查詢效果:
daily中包含三日內的城市的天氣信息
{
"code": "200",
"updateTime": "2021-12-13T17:35+08:00",
"fxLink": "http://hfx.link/34w1",
"daily": [
{
"fxDate": "2021-12-13",
"sunrise": "06:41",
"sunset": "17:13",
"moonrise": "13:36",
"moonset": "02:13",
"moonPhase": "盈凸月",
"moonPhaseIcon": "803",
"tempMax": "16",
"tempMin": "11",
"iconDay": "101",
"textDay": "多雲",
"iconNight": "151",
"textNight": "多雲",
"wind360Day": "45",
"windDirDay": "東北風",
"windScaleDay": "3-4",
"windSpeedDay": "16",
"wind360Night": "0",
"windDirNight": "北風",
"windScaleNight": "1-2",
"windSpeedNight": "3",
"humidity": "89",
"precip": "0.0",
"pressure": "996",
"vis": "24",
"cloud": "13",
"uvIndex": "2"
},
{
"fxDate": "2021-12-14",
"sunrise": "06:41",
"sunset": "17:13",
"moonrise": "14:06",
"moonset": "03:05",
"moonPhase": "盈凸月",
"moonPhaseIcon": "803",
"tempMax": "20",
"tempMin": "13",
"iconDay": "101",
"textDay": "多雲",
"iconNight": "104",
"textNight": "陰",
"wind360Day": "0",
"windDirDay": "北風",
"windScaleDay": "1-2",
"windSpeedDay": "3",
"wind360Night": "0",
"windDirNight": "北風",
"windScaleNight": "1-2",
"windSpeedNight": "3",
"humidity": "90",
"precip": "0.0",
"pressure": "992",
"vis": "25",
"cloud": "8",
"uvIndex": "2"
},
{
"fxDate": "2021-12-15",
"sunrise": "06:42",
"sunset": "17:13",
"moonrise": "14:37",
"moonset": "03:58",
"moonPhase": "盈凸月",
"moonPhaseIcon": "803",
"tempMax": "24",
"tempMin": "16",
"iconDay": "101",
"textDay": "多雲",
"iconNight": "151",
"textNight": "多雲",
"wind360Day": "0",
"windDirDay": "北風",
"windScaleDay": "1-2",
"windSpeedDay": "3",
"wind360Night": "0",
"windDirNight": "北風",
"windScaleNight": "1-2",
"windSpeedNight": "3",
"humidity": "89",
"precip": "0.0",
"pressure": "990",
"vis": "25",
"cloud": "6",
"uvIndex": "3"
}
],
"refer": {
"sources": [
"QWeather",
"NMC",
"ECMWF"
],
"license": [
"no commercial use"
]
}
}