和風天氣api
1.個人key:
34e54ce6cef7419a9f1f5f616a??????
2.API地址:
城市接口: https://api.heweather.com/x3/weather?cityid=城市ID&key=你的認證key
3.參數說明:
請求參數 說明 值
city 城市名稱、支持中英文,不區分大小寫和空格,城市和國家之間用英文逗號分割 北京、beijing、london,united kingdom
cityid 城市ID,參見 國內城市ID列表 CN101010100
cityip 城市IP,輸入所在城市的任意IP 123.45.67.8
key 用戶認證key
4.請求示例:
https://api.heweather.com/x3/weather?cityid=CN101010100&key=34e54ce6cef7419a9f1f5f616a??????
5.返回數據示例:
{
"HeWeather data service 3.0": [
{
"aqi": {
"city": {
"aqi": "150",
"co": "2",
"no2": "76",
"o3": "50",
"pm10": "143",
"pm25": "115",
"qlty": "輕度污染",
"so2": "50"
}
},
"basic": {
"city": "北京",
"cnty": "中國",
"id": "CN101010100",
"lat": "39.904000",
"lon": "116.391000",
"update": {
"loc": "2016-03-12 17:50",
"utc": "2016-03-12 09:50"
}
},
"daily_forecast": [
{
"astro": {
"sr": "06:30",
"ss": "18:18"
},
"cond": {
"code_d": "101",
"code_n": "100",
"txt_d": "多雲",
"txt_n": "晴"
},
"date": "2016-03-09",
"hum": "9",
"pcpn": "0.0",
"pop": "0",
"pres": "1034",
"tmp": {
"max": "9",
"min": "2"
},
"vis": "10",
"wind": {
"deg": "320",
"dir": "無持續風向",
"sc": "微風",
"spd": "4"
}
},
{
"astro": {
"sr": "06:28",
"ss": "18:19"
},
"cond": {
"code_d": "100",
"code_n": "100",
"txt_d": "晴",
"txt_n": "晴"
},
"date": "2016-03-10",
"hum": "14",
"pcpn": "0.0",
"pop": "0",
"pres": "1030",
"tmp": {
"max": "12",
"min": "-2"
},
"vis": "10",
"wind": {
"deg": "309",
"dir": "北風",
"sc": "3-4",
"spd": "10"
}
},
{
"astro": {
"sr": "06:26",
"ss": "18:20"
},
"cond": {
"code_d": "100",
"code_n": "101",
"txt_d": "晴",
"txt_n": "多雲"
},
"date": "2016-03-11",
"hum": "12",
"pcpn": "0.0",
"pop": "0",
"pres": "1023",
"tmp": {
"max": "15",
"min": "4"
},
"vis": "10",
"wind": {
"deg": "201",
"dir": "無持續風向",
"sc": "微風",
"spd": "3"
}
},
{
"astro": {
"sr": "06:25",
"ss": "18:21"
},
"cond": {
"code_d": "101",
"code_n": "101",
"txt_d": "多雲",
"txt_n": "多雲"
},
"date": "2016-03-12",
"hum": "20",
"pcpn": "0.0",
"pop": "0",
"pres": "1015",
"tmp": {
"max": "15",
"min": "4"
},
"vis": "10",
"wind": {
"deg": "101",
"dir": "無持續風向",
"sc": "微風",
"spd": "6"
}
},
{
"astro": {
"sr": "06:23",
"ss": "18:22"
},
"cond": {
"code_d": "101",
"code_n": "101",
"txt_d": "多雲",
"txt_n": "多雲"
},
"date": "2016-03-13",
"hum": "12",
"pcpn": "0.0",
"pop": "0",
"pres": "1023",
"tmp": {
"max": "17",
"min": "6"
},
"vis": "10",
"wind": {
"deg": "338",
"dir": "無持續風向",
"sc": "微風",
"spd": "10"
}
},
{
"astro": {
"sr": "06:22",
"ss": "18:23"
},
"cond": {
"code_d": "101",
"code_n": "104",
"txt_d": "多雲",
"txt_n": "陰"
},
"date": "2016-03-14",
"hum": "11",
"pcpn": "0.0",
"pop": "0",
"pres": "1018",
"tmp": {
"max": "18",
"min": "6"
},
"vis": "10",
"wind": {
"deg": "197",
"dir": "無持續風向",
"sc": "微風",
"spd": "3"
}
},
{
"astro": {
"sr": "06:20",
"ss": "18:24"
},
"cond": {
"code_d": "104",
"code_n": "100",
"txt_d": "陰",
"txt_n": "晴"
},
"date": "2016-03-15",
"hum": "12",
"pcpn": "0.0",
"pop": "0",
"pres": "1016",
"tmp": {
"max": "18",
"min": "6"
},
"vis": "10",
"wind": {
"deg": "125",
"dir": "無持續風向",
"sc": "微風",
"spd": "2"
}
}
],
"hourly_forecast": [
{
"date": "2016-03-12 01:00",
"hum": "24",
"pop": "0",
"pres": "1021",
"tmp": "1",
"wind": {
"deg": "170",
"dir": "南風",
"sc": "微風",
"spd": "8"
}
},
{
"date": "2016-03-12 04:00",
"hum": "32",
"pop": "0",
"pres": "1020",
"tmp": "1",
"wind": {
"deg": "119",
"dir": "東南風",
"sc": "微風",
"spd": "6"
}
},
{
"date": "2016-03-12 07:00",
"hum": "37",
"pop": "0",
"pres": "1019",
"tmp": "1",
"wind": {
"deg": "67",
"dir": "東北風",
"sc": "微風",
"spd": "7"
}
},
{
"date": "2016-03-12 10:00",
"hum": "30",
"pop": "0",
"pres": "1018",
"tmp": "4",
"wind": {
"deg": "66",
"dir": "東北風",
"sc": "微風",
"spd": "8"
}
},
{
"date": "2016-03-12 13:00",
"hum": "22",
"pop": "0",
"pres": "1016",
"tmp": "9",
"wind": {
"deg": "91",
"dir": "東風",
"sc": "微風",
"spd": "6"
}
},
{
"date": "2016-03-12 16:00",
"hum": "19",
"pop": "0",
"pres": "1015",
"tmp": "11",
"wind": {
"deg": "118",
"dir": "東南風",
"sc": "微風",
"spd": "6"
}
},
{
"date": "2016-03-12 19:00",
"hum": "24",
"pop": "0",
"pres": "1016",
"tmp": "9",
"wind": {
"deg": "214",
"dir": "西南風",
"sc": "微風",
"spd": "4"
}
},
{
"date": "2016-03-12 22:00",
"hum": "22",
"pop": "0",
"pres": "1018",
"tmp": "6",
"wind": {
"deg": "303",
"dir": "西北風",
"sc": "微風",
"spd": "12"
}
}
],
"now": {
"cond": {
"code": "101",
"txt": "多雲"
},
"fl": "-8",
"hum": "32",
"pcpn": "0",
"pres": "1035",
"tmp": "9",
"vis": "10",
"wind": {
"deg": "340",
"dir": "西南風",
"sc": "3-4",
"spd": "10"
}
},
"status": "ok",
"suggestion": {
"comf": {
"brf": "較溫馨",
"txt": "白每天氣晴好,遲早會感受偏涼,午後溫馨、宜人。"
},
"cw": {
"brf": "較適宜",
"txt": "較適宜洗車,將來一天無雨,風力較小,擦洗一新的汽車至少能保持一天。"
},
"drsg": {
"brf": "較冷",
"txt": "建議着厚外套加毛衣等服裝。年老體弱者宜着大衣、呢外套加羊毛衫。"
},
"flu": {
"brf": "較易發",
"txt": "天氣較涼,較易發生感冒,請適當增長衣服。體質較弱的朋友尤爲應該注意防禦。"
},
"sport": {
"brf": "較不宜",
"txt": "天氣較好,但考慮天氣寒冷,推薦您進行室內運動,戶外運動時請注意保暖並作好準備活動。"
},
"trav": {
"brf": "適宜",
"txt": "天氣較好,同時又有微風伴您一路同行。雖會讓人感受有點涼,但仍適宜旅遊,可不要錯過機會呦!"
},
"uv": {
"brf": "最弱",
"txt": "屬弱紫外線輻射天氣,無需特別防禦。若長期在戶外,建議塗擦SPF在8-12之間的防曬護膚品。"
}
}
}
]
}
6.json數據格式整理:
o-JSON
a-HeWeather data service 3.0
o-[0]
o-aqi
o-basic
a-daily_forecast
a-hourly_forecast
o-now
v-status : "ok"
o-suggestion
(注:a表明JsonArray,o表明JsonObject)
7.字段說明:
(1)basic 城市基本信息
字段 說明
city 城市名稱
id 城市ID
cnty 國家名稱
lat 緯度
lon 經度
update 數據更新時間,24小時制
loc 數據更新的當地時間
utc 數據更新的UTC時間
(2)aqi 空氣質量指數
字段 說明
city 城市數據
aqi 空氣質量指數
pm25 PM2.5 1小時平均值(ug/m³)
pm10 PM10 1小時平均值(ug/m³)
so2 二氧化硫1小時平均值(ug/m³)
no2 二氧化氮1小時平均值(ug/m³)
co 一氧化碳1小時平均值(ug/m³)
o3 臭氧1小時平均值(ug/m³)
qlty 空氣質量類別
(3)suggestion 生活指數
字段 說明
drsg 穿衣指數
brf 簡介
txt 詳情
uv 紫外線指數
brf 簡介
txt 詳情
cw 洗車指數
brf 簡介
txt 詳情
trav 旅遊指數
brf 簡介
txt 詳情
flu 感冒指數
brf 簡介
txt 詳情
sport 運動指數
brf 簡介
txt 詳情
(4)alarms災害預警
字段 說明
title 標題
type 類型
level 級別
stat 狀態
txt 描述
(5)now 實況天氣
字段 說明
tmp 當前溫度(攝氏度)
fl 體感溫度
wind 風力情況
spd 風速(Kmph)
sc 風力等級
deg 風向(角度)
dir 風向(方向)
cond 天氣情況
code 天氣代碼
txt 天氣描述
pcpn 降雨量(mm)
hum 溼度(%)
pres 氣壓
vis 能見度(km)
(6)daily_forecast 天氣預報
字段 說明
date 當地日期
astro 天文數值
sr 日出時間
ss 日落時間
tmp 溫度
max 最高溫度(攝氏度)
min 最低溫度(攝氏度)
wind 風力情況
spd 風速(Kmph)
sc 風力等級
deg 風向(角度)
dir 風向(方向)
cond 天氣情況
code_d 白每天氣代碼
txt_d 白每天氣描述
code_n 夜間天氣代碼
txt_n 夜間天氣描述
pcpn 降雨量(mm)
pop 降水機率
hum 溼度(%)
pres 氣壓
vis 能見度(km)
(7)hourly_forecast 每小時天氣預報
字段 說明
date 當地日期和時間
tmp 當前溫度(攝氏度)
wind 風力情況
spd 風速(Kmph)
sc 風力等級
deg 風向(角度)
dir 風向(方向)
pop 降水機率
hum 溼度(%)
pres 氣壓
(8)error code 錯誤代碼
代碼 說明
ok 接口正常
invalid key 錯誤的用戶 key
unknown city 未知城市
no more requests 超過訪問次數
anr 服務無響應或超時
permission denied 沒有訪問權限
(表明僅限國內城市)
8.java(android)請求示例:
1 String httpUrl = "https://api.heweather.com/x3/weather?cityid=城市ID&key=XXXXXXXXX";
2 String jsonResult = request(httpUrl);
3 System.out.println(jsonResult);
4 public static String request(String httpUrl) {
5 BufferedReader reader = null;String result = null;StringBuffer sbf = new StringBuffer();
6 try {
7 URL url = new URL(httpUrl);
8 HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
9 connection.setRequestMethod("GET");
10 connection.connect();
11 InputStream is = connection.getInputStream();
12 reader = new BufferedReader(new InputStreamReader(is, "UTF-8"));
13 String strRead = null;
14 while ((strRead = reader.readLine()) != null) {
15 sbf.append(strRead); sbf.append("\r\n");
16 }
17 reader.close();
18 result = sbf.toString();
19 } catch (Exception e) { e.printStackTrace(); }
20 return result;
21 }
9.天氣代碼對照:
代碼 中文 英文 圖標
100 晴 Sunny/Clear 100.png
101 多雲 Cloudy 101.png
102 少雲 Few Clouds 102.png
103 晴間多雲 Partly Cloudy 103.png
104 陰 Overcast 104.png
200 有風 Windy 200.png
201 平靜 Calm 201.png
202 微風 Light Breeze 202.png
203 和風 Moderate/Gentle Breeze 203.png
204 清風 Fresh Breeze 204.png
205 強風/勁風 Strong Breeze 205.png
206 疾風 High Wind, Near Gale 206.png
207 大風 Gale 207.png
208 烈風 Strong Gale 208.png
209 風暴 Storm 209.png
210 狂爆風 Violent Storm 210.png
211 颶風 Hurricane 211.png
212 龍捲風 Tornado 212.png
213 熱帶風暴 Tropical Storm 213.png
300 陣雨 Shower Rain 300.png
301 強陣雨 Heavy Shower Rain 301.png
302 雷陣雨 Thundershower 302.png
303 強雷陣雨 Heavy Thunderstorm 303.png
304 雷陣雨伴有冰雹 Hail 304.png
305 小雨 Light Rain 305.png
306 中雨 Moderate Rain 306.png
307 大雨 Heavy Rain 307.png
308 極端降雨 Extreme Rain 308.png
309 毛毛雨/細雨 Drizzle Rain 309.png
310 暴雨 Storm 310.png
311 大暴雨 Heavy Storm 311.png
312 特大暴雨 Severe Storm 312.png
313 凍雨 Freezing Rain 313.png
400 小雪 Light Snow 400.png
401 中雪 Moderate Snow 401.png
402 大雪 Heavy Snow 402.png
403 暴雪 Snowstorm 403.png
404 雨夾雪 Sleet 404.png
405 雨雪天氣 Rain And Snow 405.png
406 陣雨夾雪 Shower Snow 406.png
407 陣雪 Snow Flurry 407.png
500 薄霧 Mist 500.png
501 霧 Foggy 501.png
502 霾 Haze 502.png
503 揚沙 Sand 503.png
504 浮塵 Dust 504.png
506 火山灰 Volcanic Ash 506.png
507 沙塵暴 Duststorm 507.png
508 強沙塵暴 Sandstorm 508.png
900 熱 Hot 900.png
901 冷 Cold 901.png
999 未知 Unknown 999.png