產(chǎn)品概述

簡介

    氣象大數(shù)據(jù)平臺隸屬于北京天譯科技有限公司，是中國天氣網(wǎng)面向高校、科研院所、社會各行業(yè)用戶及個(gè)人開發(fā)者，通過API接口方式提供氣象數(shù)據(jù)產(chǎn)品服務(wù)的官方載體。隨著氣象大數(shù)據(jù)平臺的逐漸完善，會面向廣大用戶提供更為豐富的氣象數(shù)據(jù)，從而滿足不同用戶的不同需求。 用戶通過氣象大數(shù)據(jù)平臺的定制數(shù)據(jù)，自由選擇想要全國4萬多個(gè)縣、鄉(xiāng)鎮(zhèn)站點(diǎn)，全球18萬個(gè)城市站點(diǎn)，自由選擇目前六大氣象產(chǎn)品中的任意要素，預(yù)報(bào)時(shí)長，以及更新頻率，方便直觀。

    氣象大數(shù)據(jù)平臺面向公眾還有幾款套餐供大家選擇，目前有免費(fèi)套餐，國內(nèi)套餐，國內(nèi)旅游套餐，國外套餐，國外旅游套餐，中國天氣氣象大數(shù)據(jù)平臺陸續(xù)還有更多不同的套餐來服務(wù)大眾。 氣象大數(shù)據(jù)平臺自運(yùn)營以來，陸續(xù)和國內(nèi)知名企業(yè)建立了合作伙伴關(guān)系，其中騰訊，奇虎360， 百度等國內(nèi)一線互聯(lián)網(wǎng)公司有長期的業(yè)務(wù)合作，也有為新創(chuàng)公司提供天氣方面數(shù)據(jù)支持，如阿里媽媽，去滑雪GOSKI等。 氣象大數(shù)據(jù)平臺即是普通天氣應(yīng)用愛好者的首選開發(fā)平臺，也是社會各行各業(yè)開拓天氣價(jià)值，提升服務(wù)質(zhì)量， 促進(jìn)本行業(yè)更好地發(fā)展的一個(gè)不錯(cuò)的選擇。

產(chǎn)品特色

氣象大數(shù)據(jù)平臺涉及的數(shù)據(jù)品類包括預(yù)報(bào)，實(shí)況，預(yù)警，空氣質(zhì)量，指數(shù)，圖形產(chǎn)品，格點(diǎn)數(shù)據(jù)等，類型豐富。數(shù)據(jù)來源使用方式簡單便捷，跨平臺。

應(yīng)用場景

網(wǎng)站全國城市天氣預(yù)報(bào)，天氣預(yù)報(bào)服務(wù)性的APP應(yīng)用，電視盒子天氣預(yù)報(bào)應(yīng)用，游戲場景和天氣結(jié)合，農(nóng)業(yè)災(zāi)害預(yù)防，保險(xiǎn)行業(yè)和天氣結(jié)合，醫(yī)療單位和疾病防治中心和天氣服務(wù)結(jié)合提升優(yōu)化服務(wù)質(zhì)量，單車出行應(yīng)用服務(wù)用戶出行。

服務(wù)電話

商務(wù)電話：010-68408994

技術(shù)支持電話：010-58991542

使用說明

使用流程

注冊申請氣象大數(shù)據(jù)平臺帳號

登錄氣象大數(shù)據(jù)平臺官方網(wǎng)站http://www.beijinhf.cn，點(diǎn)擊右上角“注冊”按鈕進(jìn)行注冊并激活帳號，如下圖所示：

開發(fā)指南

接口URL

http://api.weatherdt.com/common/?area=站表ID&type=天氣數(shù)據(jù)大類&key=741c428fc7116c6f718cb14f2dda49sm

站點(diǎn)拼裝規(guī)則

http://api.weatherdt.com/common/?area=站表ID|站表ID|站表ID&type=天氣數(shù)據(jù)大類&key=741c428fc7116c6f718cb14f2dda49sm

單站點(diǎn)

請求URL: http://api.weatherdt.com/common/?area=站表ID&type=天氣數(shù)據(jù)大類&key=741c428fc7116c6f718cb14f2dda49sm

多站點(diǎn)

站點(diǎn)類型只能是4種類型的1種(中國站點(diǎn),國外站點(diǎn),旅游景點(diǎn),機(jī)場),不能混,混著請求報(bào)錯(cuò)

站點(diǎn)數(shù)量N(2<=N<=20),超出范圍報(bào)錯(cuò)

請求URL: http://api.weatherdt.com/common/?area=areaId|areaId&type=天氣數(shù)據(jù)大類&key=741c428fc7116c6f718cb14f2dda49sm

要素拼裝規(guī)則

單站點(diǎn)請求可以請求所有數(shù)據(jù)大類全部要素(推薦方式，簡潔)

http://api.weatherdt.com/common/?area=areaId&type=index&key=741c428fc7116c6f718cb14f2dda49sm

http://api.weatherdt.com/common/?area=areaId&type=index|forecast|alarm&key=741c428fc7116c6f718cb14f2dda49sm

多站點(diǎn)請求可以請求所有數(shù)據(jù)大類全部要素

http://api.weatherdt.com/common/?area=areaId|areaId&type=air&key=741c428fc7116c6f718cb14f2dda49sm

http://api.weatherdt.com/common/?area=areaId|areaId&type=air|forecast|alarm&key=741c428fc7116c6f718cb14f2dda49sm

參數(shù)說明

接口錯(cuò)誤編碼表

接口返回JSON示例

				
{
                
    "air": {//空氣質(zhì)量
                
        "101010100": {//站號
                
            "2001006": {//數(shù)據(jù)大類
                
                "006": "2.0",//SO2
                
                "007": "32.0",//CO
                
                "003": "65.0",//NO2
                
                "004": "2.0",//O3
                
                "000": "201611041000",//更新時(shí)間
                
                "001": "290.0",//PM2.5
                
                "005": "166.0",//PM10
                
                "002": "290.0"http://AQI
                
            }
                
        }
                
    },
                
    "alarm": {//預(yù)警
                
        "101010100": {//站號
                
            "1001003": [//數(shù)據(jù)大類
                
                {
                
                    "006": "02",//預(yù)警級別編號
                
                    "010": "201611032200545111大霧黃色",//預(yù)警信息
                
                    "008": "2016-11-03 22:00",//預(yù)警發(fā)布時(shí)間
                
                    "011": "10101-20161103220000-1202.html",//天氣網(wǎng)跳轉(zhuǎn)地址
                
                    "009": "北京市氣象臺03日22時(shí)00分發(fā)布大霧黃色預(yù)警,預(yù)計(jì)當(dāng)前至4日10時(shí)左右本市有霧，部分地區(qū)能見度小于500米，請注意防范。",//預(yù)警發(fā)布內(nèi)容
                
                    "001": "北京市",//預(yù)警發(fā)布單位的省級名稱
                
                    "005": "大霧",//預(yù)警類別名稱
                
                    "004": "12",//預(yù)警類別編號
                
                    "003": "",//預(yù)警發(fā)布單位的縣級名稱
                
                    "007": "黃色",//預(yù)警級別名稱
                
                    "002": ""http://預(yù)警發(fā)布單位的市級名稱
                
                },
                
                {
                
                    "006": "03",//預(yù)警級別編號
                
                    "010": "201611031750545111霾橙色",//預(yù)警信息
                
                    "008": "2016-11-03 17:50",//預(yù)警發(fā)布時(shí)間
                
                    "011": "10101-20161103175000-1303.html",//天氣網(wǎng)跳轉(zhuǎn)地址
                
                    "009": "北京市氣象臺03日17時(shí)50分更新發(fā)布霾橙色預(yù)警,預(yù)計(jì)3日夜間至4日，本市將出現(xiàn)中度到重度霾，能見度低，請注意防范。",//預(yù)警發(fā)布內(nèi)容
                
                    "001": "北京市",//預(yù)警發(fā)布單位的省級名稱
                
                    "005": "霾",//預(yù)警類別名稱
                
                    "004": "13",//預(yù)警類別編號
                
                    "003": "",//預(yù)警發(fā)布單位的縣級名稱
                
                    "007": "橙色",//預(yù)警級別名稱
                
                    "002": ""http://預(yù)警發(fā)布單位的市級名稱
                
                }
                
            ]
                
        }
                
    },
                
    "forecast": {//預(yù)報(bào)
                
        "24h": {//逐24小時(shí)
                
            "101010100": {//站號
                
                "1001001": [//數(shù)據(jù)大類
                
                    {
                
                        "006": "0",//晚上風(fēng)力
                
                        "008": "0",//晚上方向
                
                        "007": "0",//白天方向
                
                        "003": "15",//白天溫度
                
                        "004": "4",//晚上溫度
                
                        "001": "53",//白天天氣現(xiàn)象編碼
                
                        "005": "0",//白天風(fēng)力
                
                        "002": "53"http://晚上天氣現(xiàn)象編碼
                
                    },
                
                    {
                
                        "006": "0",//晚上風(fēng)力
                
                        "008": "0",//晚上方向
                
                        "007": "0",//白天方向
                
                        "003": "17",//白天溫度
                
                        "004": "3",//晚上溫度
                
                        "001": "01",//白天天氣現(xiàn)象編碼
                
                        "005": "0",//白天風(fēng)力
                
                        "002": "02"http://晚上天氣現(xiàn)象編碼
                
                    },
                
                    {
                
                        "006": "0",//晚上風(fēng)力
                
                        "008": "0",//晚上方向
                
                        "007": "0",//白天方向
                
                        "003": "10",//白天溫度
                
                        "004": "4",//晚上溫度
                
                        "001": "02",//白天天氣現(xiàn)象編碼
                
                        "005": "0",//白天風(fēng)力
                
                        "002": "07"http://晚上天氣現(xiàn)象編碼
                
                    }
                
                ],
                
                "000": "201611040800"http://更新時(shí)間
                
            }
                
        }
                
    },
                
    "observe": {//實(shí)況
                
        "101010100": {//站號
                
            "1001002": {//數(shù)據(jù)大類
                
                "006": "0",//當(dāng)前降水量(單位是毫米)
                
                "007": "1004",//當(dāng)前氣壓(單位百帕)
                
                "003": "1",//當(dāng)前風(fēng)力(單位是級,不用轉(zhuǎn)碼)
                
                "004": "2",//當(dāng)前風(fēng)向編號
                
                "000": "10:25",//實(shí)況發(fā)布時(shí)間
                
                "005": "79",//當(dāng)前濕度(單位%)
                
                "002": "7"http://當(dāng)前溫度(單位攝氏度)
                
            }
                
        }
                
    },
                
    "index": {//指數(shù)
                
        "24h": {//逐24小時(shí)
                
            "101010100": {//站號
                
                "1001004": [//數(shù)據(jù)大類
                
                    {
                
                        "002": {
                
                            "002002": "較冷",//指數(shù)等級
                
                            "002003": "建議著厚外套加毛衣等服裝。年老體弱者宜著大衣、呢外套加羊毛衫。",//指數(shù)釋義
                
                            "002001": "穿衣指數(shù)"http://指數(shù)名稱
                
                        },
                
                        "000": "20161104",
                
                        "005": {
                
                            "005001": "交通指數(shù)",//指數(shù)名稱
                
                            "005003": "天氣較好，但能見度很低，交通氣象條件很差，車輛行駛緩慢，盡量減少出行。",//指數(shù)釋義
                
                            "005002": "很差"http://指數(shù)等級
                
                        },
                
                        "004": {
                
                            "004001": "感冒指數(shù)",//指數(shù)名稱
                
                            "004003": "晝夜溫差大，且空氣濕度較大，易發(fā)生感冒，請注意適當(dāng)增減衣服，加強(qiáng)自我防護(hù)避免感冒。",//指數(shù)釋義
                
                            "004002": "易發(fā)"http://指數(shù)等級
                
                        }
                
                    },
                
                    {
                
                        "002": {
                
                            "002002": "較冷",//指數(shù)等級
                
                            "002003": "建議著厚外套加毛衣等服裝。年老體弱者宜著大衣、呢外套加羊毛衫。",//指數(shù)釋義
                
                            "002001": "穿衣指數(shù)"http://指數(shù)名稱
                
                        },
                
                        "000": "20161105",
                
                        "005": {
                
                            "005001": "交通指數(shù)",//指數(shù)名稱
                
                            "005003": "天氣較好，路面干燥，交通氣象條件良好，車輛可以正常行駛。",//指數(shù)釋義
                
                            "005002": "良好"http://指數(shù)等級
                
                        },
                
                        "004": {
                
                            "004001": "感冒指數(shù)",//指數(shù)名稱
                
                            "004003": "晝夜溫差很大，易發(fā)生感冒，請注意適當(dāng)增減衣服，加強(qiáng)自我防護(hù)避免感冒。",//指數(shù)釋義
                
                            "004002": "易發(fā)"http://指數(shù)等級
                
                        }
                
                    },
                
                    {
                
                        "002": {
                
                            "002002": "較冷",//指數(shù)等級
                
                            "002003": "建議著厚外套加毛衣等服裝。年老體弱者宜著大衣、呢外套加羊毛衫。",//指數(shù)釋義
                
                            "002001": "穿衣指數(shù)"http://指數(shù)名稱
                
                        },
                
                        "000": "20161106",
                
                        "005": {
                
                            "005001": "交通指數(shù)",//指數(shù)名稱
                
                            "005003": "陰天，路面干燥，交通氣象條件良好，車輛可以正常行駛。",//指數(shù)釋義
                
                            "005002": "良好"http://指數(shù)等級
                
                        },
                
                        "004": {
                
                            "004001": "感冒指數(shù)",//指數(shù)名稱
                
                            "004003": "各項(xiàng)氣象條件適宜，無明顯降溫過程，發(fā)生感冒機(jī)率較低。",//指數(shù)釋義
                
                            "004002": "少發(fā)"http://指數(shù)等級
                
                        }
                
                    }
                
                ],
                
                "000": "201611040800"http://更新時(shí)間
                
            }
                
        }
                
    }
                
}
			

數(shù)據(jù)編碼

產(chǎn)品大類編碼表

數(shù)據(jù)頻率表

風(fēng)向編號表

風(fēng)力編號表

天氣現(xiàn)象編碼表

php請求代碼示例(ip)

            	
<?php
				
$url='http://api.weatherdt.com/common/?area=101020100&type=forecast&key=XXXXXX';
				
$resultJson=file_get_contents($url);
				
echo $resultJson;
				
?>
            

JAVA請求代碼示例(ip)

            	
URL url = new URL("http://api.weatherdt.com/common/?area=101020100&type=forecast&key=XXXXXX");
				
HttpURLConnection uRLConnection = (HttpURLConnection)url.openConnection();
				
uRLConnection.setDoOutput(true);
				
uRLConnection.connect();
				
InputStream is = uRLConnection.getInputStream();
				
BufferedReader br = new BufferedReader(new InputStreamReader(is));
				
String respJson = "";
				
String readLine = null;
				
while((readLine =br.readLine()) != null){
				   
respJson +=readLine;
				
}
				
is.close();
				
br.close();
				
uRLConnection.disconnect();
            

C#請求代碼示例(域名)

            	
string url = "http://api.weatherdt.com/common/?area=101010100|101010200&type=forecast&key="XXXXXXXX";
				
Uri httpURL = new Uri(url,true);
				
HttpWebRequest httpReq = (HttpWebRequest)WebRequest.Create(httpURL);
				
HttpWebResponse httpResp = (HttpWebResponse)httpReq.GetResponse();
				
Stream respStream = httpResp.GetResponseStream();
				
StreamReader respStreamReader = new StreamReader(respStream, Encoding.UTF8);
				
string jsonContent=respStreamReader.ReadToEnd();
				
Console.WriteLine(jsonContent);
            

圖形產(chǎn)品文檔

接口URL

http://api.weatherdt.com/pic/?area=101&type=1001&date=20160822&key=613e381aa0e0c9d377e2bce4cf14db87

area:地區(qū),(101)全國

type:圖片類型,只能請求一種類型

date:圖片日期,形式(YYYYMMDD)

key:密鑰

產(chǎn)品返回json串說明

				
{
				
    "date":"20160822",//日期
				
    "pictype":”1001",//圖形產(chǎn)品類型
				
    "content":[//圖片地址和時(shí)間
				
    {
				
            "picurl":"",//圖片地址
				
            "time":"201600820080002400"http://圖片日期   
				
    },
				
    {
				
            "picurl":"",//圖片地址
				
            "time":"201600820080004800"http://圖片日期
				
    }]
				
}
			

接口錯(cuò)誤編碼表

下載圖標(biāo)

天氣圖標(biāo)下載  點(diǎn)擊下載>>

預(yù)警圖標(biāo)下載  點(diǎn)擊下載>>

常見問題

接口調(diào)試

※內(nèi)部用戶接口說明

產(chǎn)品概述

簡介

    本文檔用于云平臺用戶得到授權(quán)后，對被授權(quán)數(shù)據(jù)進(jìn)行下載操作的說明。

下載范圍

    用戶得到某種類數(shù)據(jù)的授權(quán)后，可下載自授權(quán)之日起的所有文件。

文件下載

下載準(zhǔn)備

通過用戶登錄按鈕，登錄【用戶中心】-【使用記錄】，查找到當(dāng)前賬號的aid、akey,到被授權(quán)數(shù)據(jù)列表中找到該類數(shù)據(jù)的編碼bucketName。

下載流程

注：本平臺支持兩種方式下載文件，一種為接口調(diào)用方式，一種為執(zhí)行shell腳本方式。下載源碼

一、接口過程演示：

1、打開下載的源碼包->接口調(diào)用方式->FlieDownloadProcess.java，導(dǎo)入關(guān)聯(lián)的jar包

2、修改java文件中main方法的變量

     ①aid：用戶的aid；

     ② akey：用戶的akey；

     ③ bucketName：用戶被授權(quán)的數(shù)據(jù)編碼；

     ④ downloadPathPre：文件下載的目標(biāo)路徑。

3、執(zhí)行FlieDownloadProcess.java的main方法，獲得下載的文件

二、執(zhí)行shell腳本過程演示：

1、配置環(huán)境變量,打開下載的源碼包->shell腳本，將jq文件放到linux任意目錄下；

2、修改認(rèn)證信息

3、執(zhí)行下載操作

錯(cuò)誤編碼表