想動手做一個天氣應用,上網找了一圈,卻找不到合適的 JSONP 介面,只找到中國天氣網的 JSON 介面。也好,直接用 SAE 做一層代理,把資料轉成 JSONP 格式回傳,順便把它的省市區三級聯動資料整理清楚,一支天氣 App 的資料層就成形了。
全部走 GET 請求,共三個參數:
get 參數——決定要取什麼資料,可選值有 province、city、town、weather、weathern,分別對應:取得省(直轄市)列表、依省 ID 取得市列表、依省市 ID 取得區縣列表、依省市區 ID 取得天氣預報、依省市區 ID 取得即時天氣。
citycode 參數——操作所需的行政區 ID。例如只要取得省列表時,這個參數可以省略。
callback 參數——JSONP 的回呼名稱。
下面用 jQuery 示範,把回傳的 JSON 轉成 option 串接進 select,並在上一層變動時重新載入下一層:
var baseUrl = "https://demo.alphatr.com/weather/info.php";
// 把取得的省市區列表(JSON)轉成 HTML option 字串
var appendData = function (data, el) {
var list = [];
$.each(data, function (key, val) {
list.push('<option value="' + key + '">' + val + '</option>');
});
$(el).html(list.join(''));
};
// 取得省列表
$.getJSON(baseUrl + "?get=province&callback=?", function (data) {
appendData(data, "#province");
var provCode = $("#province").val(); // 省 ID
// 依省 ID 取得市列表
$.getJSON(baseUrl + "?get=city&citycode=" + provCode + "&callback=?", function (data) {
appendData(data, "#city");
var cityCode = $("#city").val(); // 市 ID
// 取得區縣列表
$.getJSON(baseUrl + "?get=town&citycode=" + provCode + cityCode + "&callback=?", function (data) {
appendData(data, "#town");
});
});
});
// 省改變時,重載市與區縣
$("#province").bind("change", function () {
var provCode = $("#province").val();
$.getJSON(baseUrl + "?get=city&citycode=" + provCode + "&callback=?", function (data) {
appendData(data, "#city");
var cityCode = $("#city").val();
$.getJSON(baseUrl + "?get=town&citycode=" + provCode + cityCode + "&callback=?", function (data) {
appendData(data, "#town");
});
});
});
// 市改變時,重載區縣
$("#city").bind("change", function () {
var provCode = $("#province").val();
var cityCode = $("#city").val();
$.getJSON(baseUrl + "?get=town&citycode=" + provCode + cityCode + "&callback=?", function (data) {
appendData(data, "#town");
});
});
// 按下取得按鈕
$("#btn").bind("click", function () {
var code = $("#province").val();
if ($("#city").val() == "00") {
code += $("#town").val();
code += $("#city").val();
} else {
code += $("#city").val();
code += $("#town").val();
}
console.log(code);
// 取得天氣資料
$.getJSON(baseUrl + "?get=weather&citycode=" + code + "&callback=?", function (data) {
var info = [];
$.each(data.weatherinfo, function (key, val) {
info.push(key + ":" + val);
});
$("pre").html(info.join(",\n"));
});
});
這裡有個坑要特別注意:直轄市的市層級回傳值永遠是 00,而區縣的 ID 並不是「直轄市 + 市 + 區」的順序,而是「直轄市 + 區 + 00」。例如上海崇明的 citycode 是 10102 11 00,不是 10102 00 11。這也是上面那段 if 判斷存在的原因。
完整程式碼可以直接看 Demo 的原始碼。Demo 畢竟只是 Demo,功能必然不全;像是依 IP 判斷地區自動帶入、把使用者選擇的地區碼存進 cookie 下次直接沿用,這些都可以自己加上去。
先來看預報資料,以西安為例:
city: 西安, // 地區名稱 city_en: xian, // 英文(漢語拼音)名稱 date_y: 2012年8月30日, // 當前日期 date:, // 陰歷日期 week: 星期四, // 星期 fchh: 18, // 更新點時間(18 點) cityid: 101110101, // 地區 ID // 六天的溫度 temp1: 21℃~28℃, // 更新點之前是今日最高溫到午夜最低溫;更新點之後是今日午夜最低溫到明日最高溫 temp2: 18℃~22℃, // 以此類推 temp3: 17℃~26℃, temp4: 16℃~28℃, temp5: 16℃~29℃, temp6: 17℃~30℃, // 華氏溫度 tempF1: 69.8H~82.4H, tempF2: 64.4H~71.6H, tempF3: 62.6H~78.8H, tempF4: 60.8H~82.4H, tempF5: 60.8H~84.2H, tempF6: 62.6H~86H, // 天氣描述,同樣依更新點決定 weather1 指今天還是明天 weather1: 陰轉中雨, weather2: 中雨轉大雨, weather3: 小到中雨轉多雲, weather4: 多雲轉晴, weather5: 晴, weather6: 晴轉多雲, // 12 幅圖片對應六天的白天/夜間;更新點之前是今日白天、今日夜間、明日白天…… img1: 2, // 陰天 img2: 8, // 中雨,對應「陰轉中雨」 img3: 8, img4: 9, img5: 21, img6: 1, img7: 1, img8: 0, img9: 0, // 晴 img10: 99, // 第五天是「晴」,沒有「轉」,所以是無效佔位,顯示同前一張 img11: 0, img12: 1, img_single: 8, // 各張圖片對應的文字描述 img_title1: 陰, img_title2: 中雨, img_title3: 中雨, img_title4: 大雨, img_title5: 小到中雨, img_title6: 多雲, img_title7: 多雲, img_title8: 晴, img_title9: 晴, img_title10: 晴, img_title11: 晴, img_title12: 多雲, img_title_single: 中雨, // 六天的風力與風向 wind1: 西風小於3級轉3-4級, wind2: 西風3-4級, wind3: 旋轉風小於3級, wind4: 旋轉風小於3級, wind5: 旋轉風小於3級, wind6: 旋轉風小於3級, // 今明兩天的風向 fx1: 西風, fx2: 西風, // 六天的風力(與風向分開提供) fl1: 小於3級轉3-4級, fl2: 3-4級, fl3: 小於3級, fl4: 小於3級, fl5: 小於3級, fl6: 小於3級, // 生活指數,同樣與更新點有關 index: 熱, // 一天舒適度 index_d: 天氣較熱,建議著短裙、短褲、短套裝、T恤等夏季服裝。年老體弱者宜著長袖襯衫和單褲。 index48: 舒適, // 兩天(48 小時)舒適度 index48_d: 建議著薄型套裝或牛仔衫褲等春秋過渡裝。年老體弱者宜著套裝、夾克衫等。 index_uv: 弱, // 一天紫外線指數 index48_uv: 最弱, // 兩天紫外線指數 index_xc: 不宜, // 洗車指數 index_tr: 一般, // 旅遊指數 index_co: 較舒適, // 舒適度指數 st1: 24, st2: 20, st3: 17, st4: 14, st5: 26, st6: 15, index_cl: 不宜, // 晨練指數 index_ls: 不宜, // 晾曬指數 index_ag: 極易發 // 過敏氣象指數
即時天氣的欄位精簡得多:
city: 西安, // 地區名 cityid: 101110101, // 地區 ID temp1: 21℃, // 今天夜間溫度 temp2: 28℃, // 明天白天溫度 weather: 陰轉中雨, // 天氣描述 img1: n2.gif, // 今天夜間天氣圖,n 代表 night img2: d8.gif, // 明天白天天氣圖,d 代表 day ptime: 18:00 // 更新時間
同樣地,天氣描述與「今天/明天」的對應關係取決於更新點:更新點之前指今天白天與夜間,之後則往後順延一天。即時溫度的更新頻率比預報高,快取策略上可以設短一點的存活時間,預報則可以放久一些,這樣能省下不少請求。
如果要在 iOS 上實作,把上面這層代理換成 NSURLSession 或 AFNetworking 的請求即可;三級聯動改成 UIPickerView 的元件,並在選好地區後帶著 citycode 去抓 weather 與 weathern,一支最小可用的天氣 App 就完成了。