氣象數(shù)據(jù)服務(wù)接口規(guī)范QXT 618-2021

IQX/T618—2021前言 Ⅱ 2規(guī)范性引用文件 13術(shù)語和定義 1 6接口參數(shù) 3 4附錄A(資料性)接口示例 6附錄B(規(guī)范性)常用接口參數(shù)定義 附錄C(規(guī)范性)常用返回碼定義 附錄D(規(guī)范性)返回?cái)?shù)據(jù)結(jié)構(gòu) 參考文獻(xiàn) 1氣象數(shù)據(jù)服務(wù)接口規(guī)范2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T2260—2007中華人民共和國行政區(qū)劃代碼GB/T2659—2000世界各國和地區(qū)名稱代碼QX/T37—2020氣象臺(tái)站歷史沿革數(shù)據(jù)文件格式QX/T102—2009氣象資料分類與編碼QX/T202—2013表格驅(qū)動(dòng)碼氣象數(shù)據(jù)傳輸文件規(guī)范QX/T327—2016氣象衛(wèi)星數(shù)據(jù)分類與編碼規(guī)范QX/T378—2017公共氣象服務(wù)產(chǎn)品文件命名規(guī)范下列術(shù)語和定義適用于本文件。對(duì)使用各種觀、探測(cè)手段獲取的大氣狀態(tài)、現(xiàn)象及其變化過程的記錄以及各類衍生資料進(jìn)行通信、解釋和處理而使用的信息的形式化表示。數(shù)據(jù)服務(wù)系統(tǒng)提供給應(yīng)用系統(tǒng)訪問數(shù)據(jù)的應(yīng)用編程接口。接口調(diào)用后返回的內(nèi)存對(duì)象的數(shù)據(jù)結(jié)構(gòu)。2序列化serialization將計(jì)算機(jī)內(nèi)存對(duì)象轉(zhuǎn)換為可保存或傳輸?shù)臄?shù)據(jù)格式的過程。小駝峰命名法LowerCamelCase軟件編程中的一套命名規(guī)則(慣例)。4接口組成4.1接口由4部分組成：接口名稱、接口參數(shù)、返回碼、返回?cái)?shù)據(jù)結(jié)構(gòu)。其中，接口名稱表達(dá)數(shù)據(jù)訪問的具體功能，接口參數(shù)表達(dá)數(shù)據(jù)訪問的輸入條件，返回碼表達(dá)數(shù)據(jù)訪問的調(diào)用狀態(tài)，返回?cái)?shù)據(jù)結(jié)構(gòu)表達(dá)返回?cái)?shù)據(jù)的內(nèi)存結(jié)構(gòu)。4.2一個(gè)接口可以有一個(gè)或多個(gè)參數(shù)，每個(gè)參數(shù)應(yīng)明確為必選或可選。4.3接口示例見附錄A。5接口名稱內(nèi)容不可為空，主要條件可為空。5.2接口名稱采用小駝峰命名法，命名格式為：{接口功能}《資料類型}{數(shù)據(jù)內(nèi)容}{主要條件}。5.3各組成部分的取值規(guī)則應(yīng)符合表1的規(guī)定。表1接口名稱各組成部分的取值規(guī)則組成部分代碼含義備注接口功能檢索氣象數(shù)據(jù)、元數(shù)據(jù)等接口功能及其取值可按需擴(kuò)展統(tǒng)計(jì)氣象數(shù)據(jù)資料類型地面氣象資料高空氣象資料海洋氣象資料氣象輻射資料農(nóng)業(yè)氣象和生態(tài)氣象資料數(shù)值預(yù)報(bào)產(chǎn)品大氣成分資料歷史氣候代用資料氣象災(zāi)害資料天氣雷達(dá)資料衛(wèi)星氣象資料3組成部分代碼含義備注資料類型科學(xué)試驗(yàn)和考察資料氣象服務(wù)產(chǎn)品空間天氣資料其他資料數(shù)據(jù)內(nèi)容要素適用于站點(diǎn)、格點(diǎn)場(chǎng)等要素?cái)?shù)據(jù)文件適用于文件形式的數(shù)據(jù)要素代碼列表具體的要素多個(gè)直接連接，不用分隔符主要條件(By|In|Of}{參數(shù)名)主要的參數(shù)條件多個(gè)以"And"連接；參數(shù)名應(yīng)符合6.2的規(guī)定性5個(gè)主要維度進(jìn)行定義；1類用于定義其他接口參數(shù)。參數(shù)類別及其描述的輸入條件應(yīng)符合表2的表2參數(shù)類別及其描述的輸入條件參數(shù)類別參數(shù)描述的輸入條件資料種類資料的范圍。如資料代碼要素范圍類資料的要素(含統(tǒng)計(jì)要素)范圍。如要素列表時(shí)間范圍類資料的時(shí)間范圍。如時(shí)間點(diǎn)空間范圍類資料的空間范圍。如經(jīng)緯度范圍特殊屬性類資料的其他特殊屬性范圍，如臺(tái)風(fēng)編號(hào)氣象資料參數(shù)”“氣象服務(wù)產(chǎn)品參數(shù)”等其他類6.2.2氣象數(shù)據(jù)訪問常用接口參數(shù)定義應(yīng)符合附錄B的規(guī)定。除此之外的參數(shù)可根據(jù)需要參照常用參數(shù)的定義進(jìn)行擴(kuò)展。47返回碼7.1返回碼分類返回碼分為2類，即成功和失敗。7.2返回碼定義7.2.1返回碼的定義由2部分組成：返回碼取值和含義。7.2.2成功類的返回碼取值為0。失敗類的返回碼取值為負(fù)數(shù)，取值規(guī)則為-{錯(cuò)誤類別代碼}{順序號(hào)}。其中，錯(cuò)誤類別代碼及名稱應(yīng)符合表3的規(guī)定，順序號(hào)為3位數(shù)字，從001開始。7.2.3常用返回碼定義應(yīng)符合附錄C的規(guī)定。除此之外的返回碼可按需、參照常用返回碼的定義進(jìn)行擴(kuò)展。表3錯(cuò)誤類別代碼及名稱錯(cuò)誤類別代碼錯(cuò)誤類別名稱0沒有數(shù)據(jù)1用戶驗(yàn)證失敗2接口與資料不匹配3接口參數(shù)錯(cuò)誤4沒有訪問權(quán)限5單次請(qǐng)求范圍過大6服務(wù)器連接錯(cuò)誤7數(shù)據(jù)庫操作錯(cuò)誤8數(shù)據(jù)文件錯(cuò)誤9服務(wù)器處理錯(cuò)誤其他錯(cuò)誤8返回?cái)?shù)據(jù)結(jié)構(gòu)8.1服務(wù)接口返回?cái)?shù)據(jù)的結(jié)構(gòu)分為3類：站點(diǎn)類、格點(diǎn)類和信息類，結(jié)構(gòu)及其適用數(shù)據(jù)范圍應(yīng)符合表4的規(guī)定。表4返回?cái)?shù)據(jù)結(jié)構(gòu)類別及其適用數(shù)據(jù)范圍返回?cái)?shù)據(jù)結(jié)構(gòu)類別適用數(shù)據(jù)范圍返回?cái)?shù)據(jù)內(nèi)容站點(diǎn)類站點(diǎn)類數(shù)據(jù)如：地面氣象資料、高空氣象資料、氣象災(zāi)害資料等二維站點(diǎn)數(shù)據(jù)及其描述信息、接口調(diào)用過程信息格點(diǎn)類格點(diǎn)類數(shù)據(jù)如：數(shù)值預(yù)報(bào)產(chǎn)品等二維格點(diǎn)場(chǎng)數(shù)據(jù)及其描述信息、接口調(diào)用過程信息信息類文件類數(shù)據(jù)如：天氣雷達(dá)資料、衛(wèi)星氣象資料、數(shù)值預(yù)報(bào)產(chǎn)品等文件信息列表及其描述信息、接口調(diào)用過程信息56(資料性)接口示例A.1站點(diǎn)類數(shù)據(jù)服務(wù)接口示例A.1.1地面氣象資料服務(wù)接口示例表A.1給出了指定時(shí)間的地面氣象資料檢索接口示例。表A.1指定時(shí)間的地面氣象資料檢索接口示例接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選資料代碼字符串資料代碼的英文標(biāo)識(shí)表示：中國時(shí)資料必選要素代碼字符串多個(gè)以逗號(hào)(,)分隔表示：檢索溫度、降水?dāng)?shù)據(jù)必選時(shí)間字符串表示：2008日00時(shí)00分00秒必選返回碼取值見附錄C返回?cái)?shù)據(jù)結(jié)構(gòu)站點(diǎn)類返回?cái)?shù)據(jù)結(jié)構(gòu)，描述見D.2A.1.2高空氣象資料服務(wù)接口示例表A.2給出了指定時(shí)間、垂直探測(cè)意義、經(jīng)緯度范圍的高空氣象資料檢索接口示例。表A.2指定時(shí)間、垂直探測(cè)意義、經(jīng)緯度范圍的高空氣象資料檢索接口示例接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選資料代碼字符串資料代碼的英文標(biāo)識(shí)表示：全球高空定時(shí)值資料必選要素代碼字符串多個(gè)以逗號(hào)(,)分隔表示：檢索溫度、氣壓數(shù)據(jù)必選7接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選時(shí)間字符串表示：200800時(shí)00分00秒必選垂直探測(cè)意義字符串多個(gè)以逗號(hào)(,)分隔表示：標(biāo)準(zhǔn)氣壓層必選起始緯度浮點(diǎn)數(shù)最多4位小數(shù)表示：北緯32.1度必選終止緯度浮點(diǎn)數(shù)最多4位小數(shù)表示：北緯40.3度必選起始經(jīng)度浮點(diǎn)數(shù)最多4位小數(shù)表示：東經(jīng)120.5度必選終止經(jīng)度浮點(diǎn)數(shù)最多4位小數(shù)表示：東經(jīng)130.0度必選返回碼取值見附錄C返回?cái)?shù)據(jù)結(jié)構(gòu)站點(diǎn)類返回?cái)?shù)據(jù)結(jié)構(gòu)，描述見D.2A.1.3氣象災(zāi)害資料服務(wù)接口示例表A.3給出了指定時(shí)間段、臺(tái)風(fēng)編號(hào)(國際)的臺(tái)風(fēng)資料檢索接口示例。接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選資料代碼字符串資料代碼的英文標(biāo)識(shí)表示：臺(tái)風(fēng)服務(wù)產(chǎn)品必選8表A.3指定時(shí)間段、臺(tái)風(fēng)編號(hào)(國際)的臺(tái)風(fēng)資料檢索接口示例(續(xù))接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選時(shí)間段字符串表示：2008日00時(shí)00時(shí)00分00秒(含)必選臺(tái)風(fēng)編號(hào)(國際)字符串多個(gè)以逗號(hào)(,)分隔表示：2020檢測(cè)對(duì)象編報(bào)中心字符串多個(gè)以逗號(hào)(,)分隔表示：歐洲報(bào)中心必選返回碼取值見附錄C返回?cái)?shù)據(jù)結(jié)構(gòu)站點(diǎn)類返回?cái)?shù)據(jù)結(jié)構(gòu)，描述見D.2A.2格點(diǎn)類數(shù)據(jù)解析接口示例A.2.1數(shù)值預(yù)報(bào)產(chǎn)品格點(diǎn)場(chǎng)解碼要素解析接口示例表A.4給出了指定時(shí)間、預(yù)報(bào)層次、預(yù)報(bào)時(shí)效的單場(chǎng)單要素檢索接口示例。表A.4指定時(shí)間、預(yù)報(bào)層次、預(yù)報(bào)時(shí)效的單場(chǎng)單要素檢索接口示例接口名稱getNafpEleGridByTimeAn接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選資料代碼字符串資料代碼的英文標(biāo)識(shí)表示：T639模式東北半球低分辨率產(chǎn)品必選9表A.4指定時(shí)間、預(yù)報(bào)層次、預(yù)報(bào)時(shí)效的接口名稱getNafpEleGridByTimeAnd接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選時(shí)間(單個(gè))字符串表示：起報(bào)時(shí)間2008分00秒必選預(yù)報(bào)要素(單個(gè))字符串一表示：檢索溫度要素預(yù)報(bào)層次(單個(gè))整數(shù)單位：百帕表示：檢索1000百帕氣壓層預(yù)報(bào)時(shí)效(單個(gè))整數(shù)預(yù)報(bào)時(shí)效，單位：小時(shí)表示：自起24小時(shí)必選返回碼取值見附錄C返回?cái)?shù)據(jù)結(jié)構(gòu)格點(diǎn)類返回?cái)?shù)據(jù)結(jié)構(gòu)，描述見D.3A.2.2數(shù)值預(yù)報(bào)產(chǎn)品經(jīng)緯度點(diǎn)要素解析接口示例表A.5給出了指定時(shí)間范圍、預(yù)報(bào)層次、預(yù)報(bào)時(shí)段、經(jīng)緯度點(diǎn)的時(shí)間序列檢索接口示例。接口名稱getNafpEleGridByTimeAnd接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選資料代碼字符串資料代碼的英文標(biāo)識(shí)必選時(shí)間(單個(gè))字符串分00秒必選預(yù)報(bào)要素(單個(gè))字符串一表示：檢索溫度要素必選接口名稱getNafpEleGridByTimeAnd接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選預(yù)報(bào)層次(單個(gè))整數(shù)氣壓層次的整數(shù)值，單位：百帕表示：檢索1000百帕氣壓層必選起始預(yù)報(bào)時(shí)效整數(shù)預(yù)報(bào)時(shí)效，單位：小時(shí)表示：自起報(bào)時(shí)間預(yù)24小時(shí)必選終止預(yù)報(bào)時(shí)效整數(shù)預(yù)報(bào)時(shí)效，單位：小時(shí)表示：自起報(bào)時(shí)間預(yù)48小時(shí)必選經(jīng)緯度點(diǎn)字符串多個(gè)以逗號(hào)(,)分隔表示：北緯32.1度，東經(jīng)120.2度的點(diǎn)必選返回碼取值見附錄C返回?cái)?shù)據(jù)結(jié)構(gòu)格點(diǎn)類返回?cái)?shù)據(jù)結(jié)構(gòu)，描述見D.3A.3文件信息類數(shù)據(jù)服務(wù)接口示例A.3.1天氣雷達(dá)資料服務(wù)接口示例表A.6給出了指定時(shí)間段的天氣雷達(dá)資料檢索接口示例。表A.6指定時(shí)間段的天氣雷達(dá)資料檢索接口示例接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選資料代碼字符串資料代碼的英文標(biāo)識(shí)表示：單站雷達(dá)基數(shù)據(jù)資料必選表A.6指定時(shí)間段的天氣雷達(dá)資料檢索接口示例(續(xù))接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選時(shí)間段字符串前開后開：前開后閉：前閉后開：前閉后閉：表示：2008日00時(shí)00時(shí)00分00秒(含)必選返回碼取值見附錄C返回?cái)?shù)據(jù)結(jié)構(gòu)信息類返回?cái)?shù)據(jù)結(jié)構(gòu)，描述見D.4A.3.2衛(wèi)星氣象資料服務(wù)接口示例表A.7給出了指定時(shí)間的衛(wèi)星氣象資料檢索接口示例。表A.7指定時(shí)間的衛(wèi)星氣象資料檢索接口示例接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選資料代碼字符串資料代碼的英文標(biāo)識(shí)星地球同片產(chǎn)品必選時(shí)間字符串表示：起報(bào)日00時(shí)00分00秒必選返回碼取值見附錄C返回?cái)?shù)據(jù)結(jié)構(gòu)信息類返回?cái)?shù)據(jù)結(jié)構(gòu)，描述見D.4A.3.3數(shù)值預(yù)報(bào)產(chǎn)品服務(wù)接口示例表A.8給出了指定時(shí)間、預(yù)報(bào)要素的數(shù)值預(yù)報(bào)產(chǎn)品檢索接口示例。接口名稱接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說明必選/可選資料代碼字符串資料代碼的英文標(biāo)識(shí)表示：T639辨率產(chǎn)品必選時(shí)間(單個(gè))字符串表示：起報(bào)日00時(shí)00分00秒必選預(yù)報(bào)要素字符串多個(gè)以逗號(hào)(,)分隔表示：檢索溫度、氣壓數(shù)據(jù)必選返回碼取值見附錄C返回?cái)?shù)據(jù)結(jié)構(gòu)信息類返回?cái)?shù)據(jù)結(jié)構(gòu)，描述見D.4(規(guī)范性)常用接口參數(shù)定義表B.1給出了常用接口參數(shù)定義。除此之外的參數(shù)，可按需、參照常用參數(shù)的定義進(jìn)行擴(kuò)展。表B.1類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明資料種類1資料代碼(單個(gè))字符串單個(gè)表示：中國地面逐小時(shí)資料資料代碼符合QX/T102—20095.1的規(guī)定要素范圍類2要素字段代碼字符串多個(gè)以逗號(hào)(,)分隔表示：小時(shí)降水、氣溫不應(yīng)用ALL和*3統(tǒng)計(jì)要素代碼字符串(,)分隔均值4要素值范圍字符串號(hào)(;)分隔其中，要素值范圍的格式：(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;[a,b]:大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示：能見度小于1000m,相對(duì)濕度大于70%表B.1常用接口參數(shù)定義(續(xù))類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明要素范圍類5統(tǒng)計(jì)值范圍字符串以分號(hào)(;)分隔其中，要素值范圍的格式：(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;[a,b]:大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b統(tǒng)計(jì)要素代碼取自時(shí)間范圍類6時(shí)間(單個(gè))字符串表示：2015年1月1日00時(shí)(整點(diǎn))年月日時(shí)分秒應(yīng)補(bǔ)全7時(shí)間字符串(,)分隔20150101020000表示：2015年1月1日00時(shí)、01時(shí)、02時(shí)共3個(gè)整點(diǎn)年月日時(shí)分秒應(yīng)補(bǔ)全8時(shí)間段字符串前開后開：(YYYYMMDDHHMISS,前開后閉：(YYYYMMDDHHMISS,前閉后開：[YYYYMMDDHHMISS,前閉后閉：[YYYYMMDDHHMISS,表示：大于2015年1月1日00時(shí)(整點(diǎn)),小于或等于2015年1月2日00時(shí)(整點(diǎn))年月日時(shí)分秒應(yīng)補(bǔ)全表B.1常用接口參數(shù)定義(續(xù)類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明時(shí)間范圍類9時(shí)間窗(分整數(shù)表示：某時(shí)間點(diǎn)前后90min,共180單位：分鐘(min)分鐘取整條件(分鐘)整數(shù)與timeRange配合使用小時(shí)取整條件(小時(shí))整數(shù)6表示：00、06、12、18時(shí)的數(shù)據(jù)與timeRange配合使用(單個(gè))整數(shù)表示：24h預(yù)報(bào)單位：小時(shí)(h)預(yù)報(bào)時(shí)效字符串多個(gè)以逗號(hào)(,)分隔表示：03、06、09時(shí)3個(gè)預(yù)報(bào)時(shí)效單位：小時(shí)(h)起始預(yù)報(bào)時(shí)效整數(shù)0單位：小時(shí)(h)終止預(yù)報(bào)時(shí)效整數(shù)表示：終止預(yù)報(bào)時(shí)效為168h單位：小時(shí)(h)(歷年同期)字符串表示：1月1日應(yīng)為4位數(shù)字截止月日(歷年同期)字符串表示：12月31日應(yīng)為4位數(shù)字起始年(歷年同期整數(shù)表示：2001年應(yīng)為4位數(shù)字截止年(歷年同期)整數(shù)表示：2016年應(yīng)為4位數(shù)字表B.1常用接口參數(shù)定義(續(xù))類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明時(shí)間范圍類日序字符串要素值范圍取值：1-365(平年),1-366(閏年);多個(gè)以逗號(hào)(,)分隔表示：第1,4,365天候序字符串要素值范圍取值1-72;多個(gè)以逗號(hào)(,)分隔表示：第1,10,72候旬序字符串要素值范圍取值1-36;多個(gè)以逗號(hào)(,)分隔表示：第1,12,36旬月序字符串要素值范圍取值1-12;多個(gè)以逗號(hào)(,)分隔表示：1,4,12月日序段字符串要素值范圍取值：1-365(平年),1-366(閏年);其中，要素值范圍的格式：(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;(a,b):大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示：日序大于1小于365表B.1常用接口參數(shù)定義類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明時(shí)間范圍類候序段字符串要素值范圍取值1-72;其中，要素值范圍的格式：(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;(a,b):大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示：候序大于1小于72旬序段字符串要素值范圍取值1-36;其中，要素值范圍的格式：(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;(a,b):大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示：旬序大于1小于或等于36月序段字符串要素值范圍取值1-12;其中，要素值范圍的格式：(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;[a,b]:大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示：月序大于1小于12品表B.1常用接口參數(shù)定義(續(xù))類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明空間范圍類站號(hào)字符串多個(gè)以逗號(hào)(,)分隔表示：北京站一起始站號(hào)字符串一表示：從54511站(含)開始一終止站號(hào)字符串一表示：到58238站(含)為止一起始經(jīng)度浮點(diǎn)數(shù)最多4位小數(shù)表示：經(jīng)度從116.3°(含)開始單位：度(°)終止經(jīng)度浮點(diǎn)數(shù)最多4位小數(shù)表示：經(jīng)度到118.25°(含)為止單位：度(°)起始緯度浮點(diǎn)數(shù)最多4位小數(shù)表示：緯度從31.14°(含)開始單位：度(°)終止緯度浮點(diǎn)數(shù)最多4位小數(shù)表示：緯度到39.56°(含)為止單位：度(°)經(jīng)緯度點(diǎn)字符串多個(gè)以逗號(hào)(,)分隔單位：度(°)臺(tái)站站網(wǎng)字符串多個(gè)以逗號(hào)(,)分隔表示：地面觀測(cè)站37—2020表3的規(guī)定臺(tái)站級(jí)別字符串多個(gè)以逗號(hào)(,)分隔表示：國家級(jí)基準(zhǔn)站37—2020表3的規(guī)定國內(nèi)行政編碼字符串多個(gè)以逗號(hào)(,)分隔表示：北京市GB/T2260—2007表1的規(guī)定表B.1常用接口參數(shù)定義(續(xù)類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明空間范圍類國家代碼字符串多個(gè)以逗號(hào)(,)分隔表示：中國國家代碼符合GB/T2659—2000表1的規(guī)定鎮(zhèn)代碼字符串多個(gè)以逗號(hào)(,)分隔表示：北京市東城區(qū)2260的規(guī)定流域編碼字符串多個(gè)以逗號(hào)(,)分隔表示：黃河流域流域編碼見全國流域區(qū)劃代碼表編報(bào)中心字符串多個(gè)以逗號(hào)(,)分隔表示：歐洲中尺度預(yù)報(bào)中心編報(bào)中心符合QX/T202—2013附錄B的規(guī)定垂直探測(cè)意義字符串多個(gè)以逗號(hào)(,)分隔表示：標(biāo)準(zhǔn)氣壓層垂直探測(cè)儀見《氣象觀測(cè)報(bào)告的解碼規(guī)則與算法》中3.3氣壓層次字符串多個(gè)以逗號(hào)(,)分隔氣壓層單位：百帕(hPa);氣壓層次下限整數(shù)表示：850hPa氣壓層單位：百帕(hPa);碼表3.15類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明空間范圍類氣壓層次上限整數(shù)表示：100hPa氣壓層單位：百帕(hPa);碼表3.15高度層次字符串多個(gè)以逗號(hào)(,)分隔表示：5000m高度層單位：米(m);高度層次下限浮點(diǎn)數(shù)具體單位因資料而異高度層次上限浮點(diǎn)數(shù)具體單位因資料而異飛行高度層次下限浮點(diǎn)數(shù)單位：米(m)用于飛機(jī)報(bào)資料飛行高度層次上限浮點(diǎn)數(shù)單位：米(m)用于飛機(jī)報(bào)資料土壤深度整數(shù)單位：厘米(cm)用于農(nóng)氣資料表B.1常用接口參數(shù)定義(續(xù))類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明特殊屬性類(臺(tái)風(fēng)資料參數(shù))(國際)字符串多個(gè)以逗號(hào)(,)分隔表示：2020年西太平洋第24個(gè)檢測(cè)對(duì)象一(國內(nèi))字符串多個(gè)以逗號(hào)(,)分隔表示：2020年第22個(gè)熱帶氣旋一臺(tái)風(fēng)名稱字符串多個(gè)以逗號(hào)(,)分隔表示：臺(tái)風(fēng)名稱為VAMCO—特殊屬性類(數(shù)值預(yù)報(bào)產(chǎn)品參數(shù))(單個(gè))字符串一表示：溫度預(yù)報(bào)要素符合QX/T102—2009表5的規(guī)定預(yù)報(bào)要素字符串多個(gè)以逗號(hào)(,)分隔表示：降水量，氣壓預(yù)報(bào)要素符合QX/T102—2009表5的規(guī)定(單個(gè))字符串一單位：百帕(hPa)預(yù)報(bào)層次字符串多個(gè)以逗號(hào)(,)分隔表示：850hPa和1000hPa單位：百帕(hPa)(單個(gè))字符串一表示：全球預(yù)報(bào)區(qū)域符合QX/T102—2009表2的規(guī)定預(yù)報(bào)區(qū)域字符串多個(gè)以逗號(hào)(,)分隔表示：南半球和北半球預(yù)報(bào)區(qū)域符合QX/T102—2009表2的規(guī)定集合預(yù)報(bào)成員(單個(gè))整數(shù)一1表示：第1個(gè)成員一怨表B.1常用接口參數(shù)定義(續(xù))類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明特殊屬性類(天氣雷達(dá)資料參數(shù))掃描方式字符串多個(gè)以逗號(hào)(,)分隔表示：圓錐掃描模式掃描方式見《氣測(cè)函〔2017〕48號(hào)觀測(cè)司關(guān)于新一代天氣雷達(dá) 件業(yè)務(wù)運(yùn)行的通知》附表1覆蓋范圍字符串多個(gè)以逗號(hào)(,)分隔覆蓋范圍見《氣測(cè)函〔2017〕48號(hào)觀測(cè)司關(guān)于新一代天氣雷達(dá) 件業(yè)務(wù)運(yùn)行的通知》附表1仰角字符串多個(gè)以逗號(hào)(,)分隔表示：仰角為1.5°單位：度(°)最小仰角字符串表示：最小仰角為1.5°單位：度(°)最大仰角字符串表示：最大仰角為6°單位：度(°)分辨率字符串多個(gè)以逗號(hào)(,)分隔1單位：千米(km)特殊屬性類(衛(wèi)星氣象資料參數(shù))衛(wèi)星標(biāo)識(shí)字符串多個(gè)以逗號(hào)(,)分隔表示：風(fēng)云1號(hào)A星327—2016表1的規(guī)定衛(wèi)星通道字符串多個(gè)以逗號(hào)(,)分隔表示：可見光通道327—2016表A.2的規(guī)定表B.1常用接口參數(shù)定義(續(xù))類別序號(hào)名稱含義賦值類型賦值格式賦值示例使用說明特殊屬性類(衛(wèi)星氣象資料參數(shù))儀器標(biāo)識(shí)字符串多個(gè)以逗號(hào)(,)分隔表示：大氣垂直探測(cè)系統(tǒng)327—2016表A.2的規(guī)定投影方式字符串多個(gè)以逗號(hào)(,)分隔表示：等面積投影327—2016表6的規(guī)定特殊屬性類(氣象服務(wù)產(chǎn)品參數(shù))服務(wù)產(chǎn)品代碼字符串多個(gè)以逗號(hào)(,)分隔表示：實(shí)景監(jiān)測(cè)T378—2017表A.3的規(guī)定其他類最大返回記錄數(shù)整數(shù)10,表示：最多返回10條一排序字段字符串(,)分隔；TEM/asc,表示：按氣溫升序SUM_PRE_1h/desc,表示：按累計(jì)降水降序要素代碼可以是普通要統(tǒng)計(jì)要素(statEles)返回唯一值(去重復(fù))字符串true或falsetrue,表示：去掉重復(fù)記錄(規(guī)范性)常用返回碼定義表C.1給出了常用的返回碼定義。除此之外的返回碼，可按需、參照常用返回碼的定義進(jìn)行擴(kuò)展。表C.1常用返回碼定義類別取值含義(英文)含義(中文)備注成功0調(diào)用成功有數(shù)據(jù)返回失敗無數(shù)據(jù)返回(沒有所需條件范圍的數(shù)據(jù))錯(cuò)誤類別：沒有數(shù)據(jù)用戶名缺失錯(cuò)誤類別：用戶驗(yàn)證失敗用戶不正確密碼缺失密碼錯(cuò)誤接口名不正確錯(cuò)誤類別：接口與資料不匹配資料代碼不正確參數(shù)賦值錯(cuò)誤錯(cuò)誤類別：接口參數(shù)錯(cuò)誤參數(shù)缺失參數(shù)多余或未定義沒有訪問該數(shù)據(jù)的權(quán)限錯(cuò)誤類別：沒有訪問權(quán)限沒有訪問該歷史數(shù)據(jù)的權(quán)限檢索的時(shí)間跨度超過范圍錯(cuò)誤類別：單次請(qǐng)求范圍過大檢索的時(shí)間點(diǎn)個(gè)數(shù)超過限制服務(wù)器連接失敗錯(cuò)誤類別：服務(wù)器連接錯(cuò)誤錯(cuò)誤類別：數(shù)據(jù)庫操作錯(cuò)誤文件不存在錯(cuò)誤類別：數(shù)據(jù)文件錯(cuò)誤文件不可讀接口基礎(chǔ)功能處理異常錯(cuò)誤類別：服務(wù)器處理錯(cuò)誤接口參數(shù)處理異常服務(wù)器其他異常錯(cuò)誤類別：其他錯(cuò)誤(規(guī)范性)返回?cái)?shù)據(jù)結(jié)構(gòu)D.1結(jié)構(gòu)描述說明D.1.1返回?cái)?shù)據(jù)結(jié)構(gòu)包含站點(diǎn)類、格點(diǎn)類、信息類3類，以C/C++、Fortran、C#、Java等幾類常用語言，表示服務(wù)接口的數(shù)據(jù)結(jié)構(gòu)及其序列化格式。其中，內(nèi)存對(duì)象結(jié)構(gòu)指服務(wù)接口返回的寄存在內(nèi)存中的thon等其他語言和xarray等其他序列化格式的表示，參照?qǐng)?zhí)行。D.1.2站點(diǎn)類結(jié)構(gòu)和格點(diǎn)類結(jié)構(gòu)均返回?cái)?shù)據(jù)具體內(nèi)容。信息類結(jié)構(gòu)僅返回文件URL等相關(guān)信息，不返回文件具體內(nèi)容，接口調(diào)用客戶端獲取URL后，使用通用的HTTP、TDS等服務(wù)協(xié)議去獲取文件具體內(nèi)容。因此，該結(jié)構(gòu)對(duì)NetCDF、GRIB1/2等具體的文件格式不敏感，都適用。D.2站點(diǎn)類返回?cái)?shù)據(jù)結(jié)構(gòu)表D.1給出了站點(diǎn)類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetArray2D信息，包括數(shù)組、記錄數(shù)、字段數(shù)、接口調(diào)用過程信息等。表D.1站點(diǎn)類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetArray2D信息結(jié)構(gòu)名稱使用說明適用于檢索站點(diǎn)要素資料、格點(diǎn)數(shù)據(jù)中單點(diǎn)或多點(diǎn)的要素值、臺(tái)站元數(shù)據(jù)信息、資料字段屬性信息等接口C/C++/Fortran結(jié)構(gòu)體成員成員名稱Fortran類型成員說明獲取的數(shù)據(jù)。一維長度rowCount,二維長度colCount記錄數(shù)字段數(shù)接收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合D.5的規(guī)定C#/Java類成員成員名稱C#/Java類型成員說明獲取的數(shù)據(jù)接收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合D.5的規(guī)定D.2.2序列化格式表D.2給出了站點(diǎn)類返回?cái)?shù)據(jù)的XML、JSON、JSONP、TEXT、HTML等幾類格式信息，包括數(shù)據(jù)和接口調(diào)用過程信息等。表D.2站點(diǎn)類返回?cái)?shù)據(jù)的序列化格式信息格式類型格式信息<DSreturnCode="返回碼"returnMessage="返回碼說明(含錯(cuò)誤信息)"rowCount="返回?cái)?shù)據(jù)行數(shù)"colCount="返回?cái)?shù)據(jù)列數(shù)"requestParams="調(diào)用參數(shù)"requestTime="接收請(qǐng)求時(shí)間"responseTime="返回請(qǐng)求結(jié)果時(shí)間"takeTime="耗時(shí)(毫秒)"〉(R字段名1="字段值1"字段名2="字段值2"……字段名n="字段值n"/)(R字段名1="字段值1"字段名2="字段值2"……字段名n="字段值n"/)(!-其他行數(shù)據(jù)，此處省略--)(returnCode:"返回碼",returnMessage:"返回碼說明(含錯(cuò)誤信息)",rowCount:"返回?cái)?shù)據(jù)行數(shù)",colCount:"返回?cái)?shù)據(jù)列數(shù)",requestParams:"調(diào)用參數(shù)",requestTime:"接收請(qǐng)求時(shí)間",responseTime:"返回請(qǐng)求結(jié)果時(shí)間",takeTime:"耗時(shí)(毫秒)",DS:[{字段名1:"字段值1",字段名2:”字段值2”,字段名3:"字段值3",……},{字段名1:"字段值1",字段名2:”字段值2”,字段名3:"字段值3",……},……//其他行數(shù)據(jù)，此處省略]}回調(diào)函數(shù)名稱({returnCode:"返回碼",returnMessage:"返回碼說明(含錯(cuò)誤信息)",rowCount:"返回?cái)?shù)據(jù)行數(shù)",colCount:"返回?cái)?shù)據(jù)列數(shù)",requestParams:"調(diào)用參數(shù)",requestTime:"接收請(qǐng)求時(shí)間",responseTime:"返回請(qǐng)求結(jié)果時(shí)間",takeTime:"耗時(shí)(毫秒)",DS:[{字段名1:"字段值1”,字段名2:”字段值2”,字段名3:"字段值3",……},{字段名1:"字段值1",字段名2:"字段值2”,字段名3:"字段值3",……},……//其他行數(shù)據(jù)，此處省略]表D.2站點(diǎn)類返回?cái)?shù)據(jù)的序列化格式信息(續(xù))格式類型格式信息//注：第1行，調(diào)用信息returnCode="返回碼"returnMessage="返回碼說明(含錯(cuò)誤信息)"rowCount="Count="返回?cái)?shù)據(jù)列數(shù)"requestParams="調(diào)用參數(shù)"requestTime="接收請(qǐng)求時(shí)間"resp回請(qǐng)求結(jié)果時(shí)間"takeTime="耗時(shí)(毫秒)"http://注：第2行，返回字段列表字段名1字段名2字段名3字段名4字段名5字段名6字段名7……//注：第3-n行，每行對(duì)應(yīng)一條數(shù)據(jù)記錄字段值1字段值2字段值3字段值4字段值5字段值6字段值7……(td)字段名1</td)<td)字段名2</td)<td)字段名3</td><!-其他字段，省略--)td)字段值1</td)<td)字段值2</td)<td)字段值3</td)<!-其他字段，省略--)td)字段值1</td)<td)字段值2</td)<td)字段值3(/td><!-其他字段，省略--)<!--其他行數(shù)據(jù)，此處省略-)D.3格點(diǎn)類返回?cái)?shù)據(jù)結(jié)構(gòu)信息，包括數(shù)組、網(wǎng)格定義、接口調(diào)用過程信息等。表D.3格點(diǎn)類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetGridArray2D信息結(jié)構(gòu)名稱使用說明適用于檢索格點(diǎn)數(shù)據(jù)中單一要素場(chǎng)，或區(qū)域裁剪的數(shù)據(jù)接口C/C++/Fortran結(jié)構(gòu)體成員成員名稱成員說明獲取的數(shù)據(jù)，排列方式：先緯度后經(jīng)度；其中，緯度從北到南，經(jīng)度從西到東；一維長度latCount,二維長度lonCount網(wǎng)格起始緯度網(wǎng)格起始經(jīng)度網(wǎng)格結(jié)束緯度網(wǎng)格結(jié)束經(jīng)度緯向格點(diǎn)數(shù)經(jīng)向格點(diǎn)數(shù)緯度格距經(jīng)度格距收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合D.5的規(guī)定C#/Java類成員成員名稱C#/Java類型成員說明獲取的數(shù)據(jù)，排列方式：先緯度后經(jīng)度；其中，緯度從北到南，經(jīng)度從西到東；一維長度latCount,二維長度lonCount網(wǎng)格起始緯度網(wǎng)格起始經(jīng)度網(wǎng)格結(jié)束緯度網(wǎng)格結(jié)束經(jīng)度緯向格點(diǎn)數(shù)經(jīng)向格點(diǎn)數(shù)緯度格距經(jīng)度格距收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合D.5的規(guī)定D.3.2序列化格式表D.4給出了格點(diǎn)類返回?cái)?shù)據(jù)的XML、JSON、JSONP、TEXT、HTML等幾類格式信息，包括數(shù)表D.4格點(diǎn)類返回?cái)?shù)據(jù)的序列化格式信息格式類型格式信息〈DSreturnCode="返回碼"returnMessage="返回碼說明(含錯(cuò)誤信息)"startLat="網(wǎng)格起始緯度"startLon="網(wǎng)格起始經(jīng)度"endLat="網(wǎng)格結(jié)束緯度"endLon="網(wǎng)格結(jié)束經(jīng)度"latCount="緯向格點(diǎn)數(shù)"lonCount="經(jīng)向格點(diǎn)數(shù)"latStep="緯度格距"lonStep="經(jīng)度格距"requestParams=”調(diào)用參數(shù)”requestTime="接收請(qǐng)求時(shí)間"responseTime="返回請(qǐng)求結(jié)果時(shí)間"takeTime="耗時(shí)(毫秒)">(R>值1,值2,值3,……值n(/R)(R>值1,值2,值3,……值n</R)<!-其他行數(shù)據(jù)，此處省略-)returnCode:"返回碼",returnMessage:"返回碼說明(含錯(cuò)誤信息)",startLat:"網(wǎng)格起始緯度",lonCount:"經(jīng)向格點(diǎn)數(shù)",latStep:"緯度格距",lonStep:“經(jīng)度格距",requestParams:"調(diào)用參數(shù)”,requestTime:"接收請(qǐng)求時(shí)間",responseTime:"返回請(qǐng)求結(jié)果時(shí)間",takeTime:"耗時(shí)(毫秒)",DS:[[字段值1,字段值2,字段值3,……],[字段值1,字段值2,字段值3,……],……//其他行數(shù)據(jù)，此處省略}回調(diào)函數(shù)名稱({returnCode:"返回碼",returnMessage:"返回碼說明(含錯(cuò)誤信息)",startLat:"網(wǎng)格起始緯度",lonCount:"經(jīng)向格點(diǎn)數(shù)",latStep:"緯度格距",lonStep:“經(jīng)度格距",requestParams:"調(diào)用參數(shù)”,requestTime:"接收請(qǐng)求時(shí)間",responseTime:"返回請(qǐng)求結(jié)果時(shí)間",takeTime:"耗時(shí)(毫秒)",DS:[[字段值1,字段值2,字段值3,……],[字段值1,字段值2,字段值3,……],……//其他行數(shù)據(jù)，此處省略]//注：第1行，調(diào)用信息returnCode="返回碼"returnMessage="返回碼說明(含錯(cuò)誤信息)"startLat="網(wǎng)格起始緯度"startLon="網(wǎng)格起始經(jīng)度"endLat="網(wǎng)格結(jié)束緯度"endLon="網(wǎng)格結(jié)束經(jīng)度"latCount="緯向格點(diǎn)數(shù)"lonCount="經(jīng)向格點(diǎn)數(shù)"latStep="緯度格距"lonStep="經(jīng)度格距"requestParams=”調(diào)用參數(shù)”requestTime="接收請(qǐng)求時(shí)間"responseTime="返回請(qǐng)求結(jié)果時(shí)間"takeTime="耗時(shí)(毫秒)"http://注：第2-n行，每行對(duì)應(yīng)一條數(shù)據(jù)記錄值1值2值3值4值5值6值7……表D.4格點(diǎn)類返回?cái)?shù)據(jù)的序列化格式信息(續(xù))格式類型格式信息(td)緯度\經(jīng)度</td)《td)經(jīng)度1(/td)(td)經(jīng)度2</td)<!--其他值省略-)(td)緯度1(/td)(td>值1(/td)(td)值2(/td)(!-其他值省略-->(td)緯度2(/td)(td)值1(/td)(td)值2(/td)(!-其他值省略--)(!--其他行數(shù)據(jù)，此處省略--)D.4信息類返回?cái)?shù)據(jù)結(jié)構(gòu)信息，包括文件信息清單、文件數(shù)、接口調(diào)用過程信息等。表D.5信息類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetFilesInfo信息結(jié)構(gòu)名稱使用說明適用于檢索文件列表信息的接口，一般為非結(jié)構(gòu)化數(shù)據(jù)，包括雷達(dá)、衛(wèi)星、服務(wù)產(chǎn)品、以及數(shù)值預(yù)報(bào)文件和圖形文件等C/C++/Fortran結(jié)構(gòu)體成員成員名稱Fortran類型成員說明檢索下載的文件信息清單，長度：fileCount,應(yīng)符合表D.6規(guī)定獲取的文件數(shù)收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合D.5的規(guī)定C#/Java類成員成員名稱C#/Java類型成員說明檢索下載的文件信息清單。應(yīng)符合表D.6的規(guī)定收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合D.5的規(guī)定表D.6給出了單個(gè)文件信息的內(nèi)存對(duì)象結(jié)構(gòu)FileInfo信息，包括接口調(diào)用客戶端文件名、全路徑、文件后綴、文件大小、接口服務(wù)端文件URL等。表D.6單個(gè)文件信息的內(nèi)存對(duì)象結(jié)構(gòu)FileInfo信息結(jié)構(gòu)名稱使用說明描述單個(gè)文件的信息。RetFilesInfo中的成員fileInfos,是本數(shù)據(jù)結(jié)構(gòu)的數(shù)組C/C++/Fortran結(jié)構(gòu)體成員成員名稱Fortran類型成員說明接口調(diào)用客戶端文件名(含后綴)接口調(diào)用客戶端文件全路徑名(路徑十文件名)。在僅獲取文件信息列表的接口中，該成員為空文件后綴文件大小，單位：比特(byte)圖片文件的base64編碼數(shù)據(jù)。對(duì)非圖片文件，該成員為空；對(duì)圖片文件，可為空(使用fileUrl)要素C#/Java類成員成員名稱C#/Java類型成員說明文件名(含后綴)文件全路徑名(路徑+文件名)文件后綴文件大小，單位：比特(byte)圖片文件的base64編碼數(shù)據(jù)。對(duì)非圖片文件，該成員為空；對(duì)圖片文件，可為空