氣象大數據平臺隸屬于北京天譯科技有限公司，是中國天氣網面向高校、科研院所、社會各行業用戶及個人開發者，通過API接口方式提供氣象數據產品服務的官方載體。隨著氣象大數據平臺的逐漸完善，會面向廣大用戶提供更為豐富的氣象數據，從而滿足不同用戶的不同需求。 用戶通過氣象大數據平臺的定制數據，自由選擇想要全國4萬多個縣、鄉鎮站點，全球18萬個城市站點，自由選擇目前六大氣象產品中的任意要素，預報時長，以及更新頻率，方便直觀。
氣象大數據平臺面向公眾還有幾款套餐供大家選擇，目前有免費套餐，國內套餐，國內旅游套餐，國外套餐，國外旅游套餐，中國天氣氣象大數據平臺陸續還有更多不同的套餐來服務大眾。 氣象大數據平臺自運營以來，陸續和國內知名企業建立了合作伙伴關系，其中騰訊，奇虎360， 百度等國內一線互聯網公司有長期的業務合作，也有為新創公司提供天氣方面數據支持，如阿里媽媽，去滑雪GOSKI等。 氣象大數據平臺即是普通天氣應用愛好者的首選開發平臺，也是社會各行各業開拓天氣價值，提升服務質量， 促進本行業更好地發展的一個不錯的選擇。
氣象大數據平臺涉及的數據品類包括預報，實況，預警，空氣質量，指數，圖形產品，格點數據等，類型豐富。數據來源使用方式簡單便捷，跨平臺。
網站全國城市天氣預報，天氣預報服務性的APP應用，電視盒子天氣預報應用，游戲場景和天氣結合，農業災害預防，保險行業和天氣結合，醫療單位和疾病防治中心和天氣服務結合提升優化服務質量，單車出行應用服務用戶出行。
商務電話：010-68408994
技術支持電話：010-58991542
登錄氣象大數據平臺官方網站http://www.qqcao7.com，點擊右上角“注冊”按鈕進行注冊并激活帳號，如下圖所示：
http://api.weatherdt.com/common/?area=站表ID&type=天氣數據大類&key=741c428fc7116c6f718cb14f2dda49sm
http://api.weatherdt.com/common/?area=站表ID|站表ID|站表ID&type=天氣數據大類&key=741c428fc7116c6f718cb14f2dda49sm
單站點
請求URL: http://api.weatherdt.com/common/?area=站表ID&type=天氣數據大類&key=741c428fc7116c6f718cb14f2dda49sm
多站點
站點類型只能是4種類型的1種(中國站點,國外站點,旅游景點,機場),不能混,混著請求報錯
站點數量N(2<=N<=20),超出范圍報錯
請求URL: http://api.weatherdt.com/common/?area=areaId|areaId&type=天氣數據大類&key=741c428fc7116c6f718cb14f2dda49sm
單站點請求可以請求所有數據大類全部要素(推薦方式，簡潔)
http://api.weatherdt.com/common/?area=areaId&type=index&key=741c428fc7116c6f718cb14f2dda49sm
http://api.weatherdt.com/common/?area=areaId&type=index|forecast|alarm&key=741c428fc7116c6f718cb14f2dda49sm
多站點請求可以請求所有數據大類全部要素
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
| 參數 | 是否必須 | 示例 | 說明 |
|---|---|---|---|
| area | 必須 | 10010101001|10010101002 | 站號，多個之間使用|分隔，最多支持20個站號 |
| type | 必須 | type=forecast|alarm|air|observe或者單獨一個數據大類 | 請求數據類型，多個大類之間使用|分割 |
| key | 必須 | 741c428fc7116c6f718cb14f2dda49sm | 密鑰，與訂單對應 |
| 編碼 | 錯誤說明 | 備注 |
|---|---|---|
| CC1000 | 參數錯誤 | 檢查參數拼寫 |
| CC1003 | 訂單過期 | 請重新購買服務 |
| CC1004 | 訪問次數超限 | 請合理訪問接口 |
| CC1005 | 站點數過多錯誤 | 單次訪問請少于20個站點 |
| CC1006 | 訪問接口路徑錯誤 | 訪問接口路徑錯誤 |
| CC1100 | 連接超時 | 請稍后訪問 |
| CC1101 | 密鑰錯誤 | 檢查密鑰 |
| CC1102 | 系統無響應 | 請稍后訪問 |
| CC1200 | 請求無效站點錯誤 | 檢查請求站點 |
| CC1201 | 請求站點與要素過多錯誤 | 檢查站點數量或要素數量 |
| CC1300 | 請求要素格式錯誤 | 檢查要素請求格式 |
| CC1301 | 請求未定制類型數據 | 檢查定制類型數據 |
| CC1302 | 請求類型定制天數超出錯誤 | 檢查請求類型的定制天數 |
| CC1303 | 請求多站點與指數多要素錯誤 | 檢查站點數量或指數要素數量 |
{
"air": {//空氣質量
"101010100": {//站號
"2001006": {//數據大類
"006": "2.0",//SO2
"007": "32.0",//CO
"003": "65.0",//NO2
"004": "2.0",//O3
"000": "201611041000",//更新時間
"001": "290.0",//PM2.5
"005": "166.0",//PM10
"002": "290.0"http://AQI
}
}
},
"alarm": {//預警
"101010100": {//站號
"1001003": [//數據大類
{
"006": "02",//預警級別編號
"010": "201611032200545111大霧黃色",//預警信息
"008": "2016-11-03 22:00",//預警發布時間
"011": "10101-20161103220000-1202.html",//天氣網跳轉地址
"009": "北京市氣象臺03日22時00分發布大霧黃色預警,預計當前至4日10時左右本市有霧，部分地區能見度小于500米，請注意防范。",//預警發布內容
"001": "北京市",//預警發布單位的省級名稱
"005": "大霧",//預警類別名稱
"004": "12",//預警類別編號
"003": "",//預警發布單位的縣級名稱
"007": "黃色",//預警級別名稱
"002": ""http://預警發布單位的市級名稱
},
{
"006": "03",//預警級別編號
"010": "201611031750545111霾橙色",//預警信息
"008": "2016-11-03 17:50",//預警發布時間
"011": "10101-20161103175000-1303.html",//天氣網跳轉地址
"009": "北京市氣象臺03日17時50分更新發布霾橙色預警,預計3日夜間至4日，本市將出現中度到重度霾，能見度低，請注意防范。",//預警發布內容
"001": "北京市",//預警發布單位的省級名稱
"005": "霾",//預警類別名稱
"004": "13",//預警類別編號
"003": "",//預警發布單位的縣級名稱
"007": "橙色",//預警級別名稱
"002": ""http://預警發布單位的市級名稱
}
]
}
},
"forecast": {//預報
"24h": {//逐24小時
"101010100": {//站號
"1001001": [//數據大類
{
"006": "0",//晚上風力
"008": "0",//晚上方向
"007": "0",//白天方向
"003": "15",//白天溫度
"004": "4",//晚上溫度
"001": "53",//白天天氣現象編碼
"005": "0",//白天風力
"002": "53"http://晚上天氣現象編碼
},
{
"006": "0",//晚上風力
"008": "0",//晚上方向
"007": "0",//白天方向
"003": "17",//白天溫度
"004": "3",//晚上溫度
"001": "01",//白天天氣現象編碼
"005": "0",//白天風力
"002": "02"http://晚上天氣現象編碼
},
{
"006": "0",//晚上風力
"008": "0",//晚上方向
"007": "0",//白天方向
"003": "10",//白天溫度
"004": "4",//晚上溫度
"001": "02",//白天天氣現象編碼
"005": "0",//白天風力
"002": "07"http://晚上天氣現象編碼
}
],
"000": "201611040800"http://更新時間
}
}
},
"observe": {//實況
"101010100": {//站號
"1001002": {//數據大類
"006": "0",//當前降水量(單位是毫米)
"007": "1004",//當前氣壓(單位百帕)
"003": "1",//當前風力(單位是級,不用轉碼)
"004": "2",//當前風向編號
"000": "10:25",//實況發布時間
"005": "79",//當前濕度(單位%)
"002": "7"http://當前溫度(單位攝氏度)
}
}
},
"index": {//指數
"24h": {//逐24小時
"101010100": {//站號
"1001004": [//數據大類
{
"002": {
"002002": "較冷",//指數等級
"002003": "建議著厚外套加毛衣等服裝。年老體弱者宜著大衣、呢外套加羊毛衫。",//指數釋義
"002001": "穿衣指數"http://指數名稱
},
"000": "20161104",
"005": {
"005001": "交通指數",//指數名稱
"005003": "天氣較好，但能見度很低，交通氣象條件很差，車輛行駛緩慢，盡量減少出行。",//指數釋義
"005002": "很差"http://指數等級
},
"004": {
"004001": "感冒指數",//指數名稱
"004003": "晝夜溫差大，且空氣濕度較大，易發生感冒，請注意適當增減衣服，加強自我防護避免感冒。",//指數釋義
"004002": "易發"http://指數等級
}
},
{
"002": {
"002002": "較冷",//指數等級
"002003": "建議著厚外套加毛衣等服裝。年老體弱者宜著大衣、呢外套加羊毛衫。",//指數釋義
"002001": "穿衣指數"http://指數名稱
},
"000": "20161105",
"005": {
"005001": "交通指數",//指數名稱
"005003": "天氣較好，路面干燥，交通氣象條件良好，車輛可以正常行駛。",//指數釋義
"005002": "良好"http://指數等級
},
"004": {
"004001": "感冒指數",//指數名稱
"004003": "晝夜溫差很大，易發生感冒，請注意適當增減衣服，加強自我防護避免感冒。",//指數釋義
"004002": "易發"http://指數等級
}
},
{
"002": {
"002002": "較冷",//指數等級
"002003": "建議著厚外套加毛衣等服裝。年老體弱者宜著大衣、呢外套加羊毛衫。",//指數釋義
"002001": "穿衣指數"http://指數名稱
},
"000": "20161106",
"005": {
"005001": "交通指數",//指數名稱
"005003": "陰天，路面干燥，交通氣象條件良好，車輛可以正常行駛。",//指數釋義
"005002": "良好"http://指數等級
},
"004": {
"004001": "感冒指數",//指數名稱
"004003": "各項氣象條件適宜，無明顯降溫過程，發生感冒機率較低。",//指數釋義
"004002": "少發"http://指數等級
}
}
],
"000": "201611040800"http://更新時間
}
}
}
}
| 編碼 | 中文名稱 | 英文名稱 |
|---|---|---|
| 001 | 預報 | forecast |
| 002 | 實況 | observe |
| 003 | 預警 | alarm |
| 004 | 指數 | index |
| 006 | 空氣質量 | air |
| 數據類型 | 更新頻率 |
|---|---|
| 常規預報 | 每天發布3次 發布時間分別為：08時、12時、18時 |
| 實況 | 每小時更新一次 |
| 預警 | 不定期更新，為保證預警的時效性，建議程序啟動后每隔10分鐘進行一次輪循 |
| 指數 | 每天發布3次 發布時間分別為：08時、12時、18時 |
| 空氣質量 | 每小時更新一次 |
| 風向編號 | 中文名稱 | 英文名稱 |
|---|---|---|
| 0 | 無持續風向 | No wind |
| 1 | 東北風 | Northeast |
| 2 | 東風 | East |
| 3 | 東南風 | Southeast |
| 4 | 南風 | South |
| 5 | 西南風 | Southwest |
| 6 | 西風 | West |
| 7 | 西北風 | Northwest |
| 8 | 北風 | North |
| 9 | 旋轉風 | Whirl wind |
| 風力編號 | 中文名稱 | 英文名稱 |
|---|---|---|
| 0 | 微風 | <5.4m/s |
| 1 | 3-4級 | 5.5~7.9m/s |
| 2 | 4-5級 | 8.0~10.7m/s |
| 3 | 5-6級 | 10.8~13.8m/s |
| 4 | 6-7級 | 13.9~17.1m/s |
| 5 | 7-8級 | 17.2~20.7m/s |
| 6 | 8-9級 | 20.8~24.4m/s |
| 7 | 9-10級 | 24.5~28.4m/s |
| 8 | 10-11級 | 28.5~32.6m/s |
| 9 | 11-12級 | 32.7~36.9m/s |
| 天氣現象編碼 | 中文名稱 | 英文名稱 |
|---|---|---|
| 0 | 晴 | Sunny |
| 1 | 多云 | Cloudy |
| 2 | 陰 | Overcast |
| 3 | 陣雨 | Shower |
| 4 | 雷陣雨 | Thundershower |
| 5 | 雷陣雨伴有冰雹 | Thundershower with hail |
| 6 | 雨夾雪 | Sleet |
| 7 | 小雨 | Light rain |
| 8 | 中雨 | Moderate rain |
| 9 | 大雨 | Heavy rain |
| 10 | 暴雨 | Storm |
| 11 | 大暴雨 | Heavy storm |
| 12 | 特大暴雨 | Severe storm |
| 13 | 陣雪 | Snow flurry |
| 14 | 小雪 | Light snow |
| 15 | 中雪 | Moderate snow |
| 16 | 大雪 | Heavy snow |
| 17 | 暴雪 | Snowstorm |
| 18 | 霧 | Foggy |
| 19 | 凍雨 | Ice rain |
| 20 | 沙塵暴 | Duststorm |
| 21 | 小到中雨 | Light to moderate rain |
| 22 | 中到大雨 | Moderate to heavy rain |
| 23 | 大到暴雨 | Heavy rain to storm |
| 24 | 暴雨到大暴雨 | Storm to heavy storm |
| 25 | 大暴雨到特大暴雨 | Heavy to severe storm |
| 26 | 小到中雪 | Light to moderate snow |
| 27 | 中到大雪 | Moderate to heavy snow |
| 28 | 大到暴雪 | Heavy snow to snowstorm |
| 29 | 浮塵 | Dust |
| 30 | 揚沙 | Sand |
| 31 | 強沙塵暴 | Sandstorm |
| 53 | 霾 | Haze |
| 99 | 無 | Unknown |
| 32 | 濃霧 | Dense fog |
| 49 | 強濃霧 | Strong fog |
| 54 | 中度霾 | Moderate haze |
| 55 | 重度霾 | Severe haze |
| 56 | 嚴重霾 | Severe haze |
| 57 | 大霧 | Dense fog |
| 58 | 特強濃霧 | Extra heavy fog |
| 301 | 雨 | rain |
| 302 | 雪 | snow |
<?php
$url='http://api.weatherdt.com/common/?area=101020100&type=forecast&key=XXXXXX';
$resultJson=file_get_contents($url);
echo $resultJson;
?>
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();
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);
http://api.weatherdt.com/pic/?area=101&type=1001&date=20160822&key=613e381aa0e0c9d377e2bce4cf14db87
area:地區,(101)全國
type:圖片類型,只能請求一種類型
date:圖片日期,形式(YYYYMMDD)
key:密鑰
{
"date":"20160822",//日期
"pictype":”1001",//圖形產品類型
"content":[//圖片地址和時間
{
"picurl":"",//圖片地址
"time":"201600820080002400"http://圖片日期
},
{
"picurl":"",//圖片地址
"time":"201600820080004800"http://圖片日期
}]
}
| 編碼 | 錯誤說明 | 備注 |
|---|---|---|
| CC1000 | 參數錯誤 | 檢查參數拼寫 |
| CC1100 | 連接超時 | 請稍后訪問 |
| CC1101 | 密鑰錯誤 | 檢查密鑰 |
| CC1102 | 訪問日期超出訂購日期范圍 | 訪問日期超出訂購日期范圍 |
| CC1103 | 緩存已過期 | 緩存已過期 |
| CC1200 | 請求無效站點錯誤 | 檢查請求站點 |
| CC1300 | 請求未定制類型數據 | 請求未定制類型數據 |
天氣圖標下載 點擊下載>>
預警圖標下載 點擊下載>>
A：用戶中心【訂單管理】,【我的訂單】,【接口詳情】中,點擊鏈接在新的頁面下載購買的站號,要素,以及使用說明文檔。
A：用戶中心【訂單管理】,【我的訂單】中點擊訂單變更或者訂單續費，增加要素和站點只能使用訂單變更功能
A：可以提供發票。提交訂單時，請同時提交發票信息。如購買時沒有提交發票信息，則視為放棄開具發票權利，后期不再予以開具任何性質發票。使用個人用戶開具發票如是公司名稱同樣需提供“納稅人識別號”，如沒有上傳無法開具發票。如要開具'增值稅發票'，支付金額須大于1000元。本網站開具發票周期：每月10日-20日為上個自然月用戶開票，本月完成交易需等待次月開票周期。用戶可自行登錄用戶中心查詢發票郵寄情況。
A：白天已經過去，晚上更新預報時，再預報白天沒有意義。如果有需要，用戶可以對白天的數據自行進行緩存處理。
A：有需要平臺上尚未上線的數據，可以撥打商務電話010-68408994進行咨詢。
A：根據電子合約，平臺提供的數據，未經授權，不可以進行二次銷售。
A：可在幫助中心-下載圖標進行下載。
A：首先請確認是否同一站點數據，是否同一時次、同一更新時間。智慧氣象服務云平臺提供的數據與中國天氣網的數據為同一數據源。如有疑問，請撥打售后支持電話010-58991542。
A：有兩種方式:一種是在用戶中心【訂單管理】,【我的訂單】,【接口詳情】查看;一種是【訂單管理】,【我的訂單】中的產品名稱列,點擊國內站點,彈出詳情,就可看到密鑰。
| 參數 | 返回結果 |
|---|---|
| type：forecast area：101160901|101160801 key：fd034bf8fe70289698ec4ea79876feaa |
本文檔用于云平臺用戶得到授權后，對被授權數據進行下載操作的說明。
用戶得到某種類數據的授權后，可下載自授權之日起的所有文件。
通過用戶登錄按鈕，登錄【用戶中心】-【使用記錄】，查找到當前賬號的aid、akey,到被授權數據列表中找到該類數據的編碼bucketName。
注：本平臺支持兩種方式下載文件，一種為接口調用方式，一種為執行shell腳本方式。下載源碼
1、打開下載的源碼包->接口調用方式->FlieDownloadProcess.java，導入關聯的jar包
2、修改java文件中main方法的變量
①aid：用戶的aid；
② akey：用戶的akey；
③ bucketName：用戶被授權的數據編碼；
④ downloadPathPre：文件下載的目標路徑。
3、執行FlieDownloadProcess.java的main方法，獲得下載的文件
public static void main(String[] args) {
// TODO 用戶修改
String aid = "3ab50537ff444cedb8d10573ea81";
String akey = "9e2fd4b5b6d54cd5b5297f937a64";
String bucketName = "product-nmc-nwpr-eki";
String downloadPathPre = "D:\\user\\file\\";
try {
System.out.println("download file start!");
//1、獲取bucketId 示例
String bucketId = getBucketIdByName(aid, akey, bucketName);
// 2、獲取可下載的文件信息示例,返回類型為JSONArray，可能為null，需要進行空值判斷，避免空指針
JSONArray downFileIds = getDownFileIds(aid, akey, bucketId);
for (int i = 0; i < (downFileIds != null ? downFileIds.size() : 0); i++) {
JSONObject jo = JSON.parseObject(downFileIds.get(i).toString());
// 3、申請下載示例
String fileId = jo.getString("fileId");
String targetFileName = jo.getString("name");
JSONObject downApply = downApply(fileId, aid, akey, bucketId);
// 4、執行下載示例
String downloadURL = downApply.getString("downloadURL");
String downloadToken = downApply.getString("downloadToken");
down(downloadURL, downloadToken, downloadPathPre + targetFileName);
}
System.out.println("download file end");
} catch (Exception e) {
e.printStackTrace();
}
}
1、配置環境變量,打開下載的源碼包->shell腳本，將jq文件放到linux任意目錄下；
①[root@localhost json]# pwd
/user/json
[root@localhost json]# clear
[root@localhost json]# pwd
/user/json
[root@localhost json]# vi ~/.bash_profile
# .bash_profile
# Get the aliases and functions
if [ -f ~/.bashrc ]; then
. ~/.bashrc
fi
# User specific environment and startup programs
②PATH=$PATH:$HOME/bin:/user/json（第一步jq的目錄）
export PATH
③[root@localhost json]# source ~/.bash_profile
2、修改認證信息
aid=92775b34be5e4e89b47a82ba（用戶的aid）
akey=34243172bd030e04eae0c62（用戶的akey）
3、執行下載操作
[root@localhost user]# sh d.sh radar-png-az9734 /user/download
200
download success!
| 編碼 | 錯誤說明 | 備注 |
|---|---|---|
| B00001 | 缺少必填參數 | 請稍后訪問 |
| C00004 | 操作權限不足 | 請檢查授權數據 |
| I00003 | 存儲區或文件權限非法 | 請檢查數據是否有修改權限 |
| I00004 | 存儲區或文件不存在 | 文件未上傳 |
| I70203 | 用戶AID參數錯誤 | 用戶AID標識出錯 |
| I00021 | 時間參數校驗錯誤 | 請確認上傳的時間格式 |
數據來源：中央氣象臺 技術支持：北京天譯科技有限公司
未經書面授權禁止使用 Copyright?北京天譯科技有限公司 All Rights Reserved (2008-2025)，京ICP備15029900號
意見反饋