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

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