氣象數(shù)據(jù)服務(wù)接口規(guī)范Serviceinterfacespecificationformeteorologicaldata2023-08-06發(fā)布國(guó)家市場(chǎng)監(jiān)督管理總局國(guó)家標(biāo)準(zhǔn)化管理委員會(huì)GB/T42877—2023前言 I1范圍 2規(guī)范性引用文件 3術(shù)語(yǔ)和定義 4接口組成 25接口名稱 26接口參數(shù) 37返回碼 48返回?cái)?shù)據(jù)結(jié)構(gòu) 49證實(shí)方法 5附錄A(資料性)氣象數(shù)據(jù)服務(wù)接口示例 6附錄B(規(guī)范性)接口參數(shù)定義 附錄C(規(guī)范性)返回碼取值含義 附錄D(規(guī)范性)返回?cái)?shù)據(jù)結(jié)構(gòu) 參考文獻(xiàn) I本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由中國(guó)氣象局提出。本文件由全國(guó)氣象基本信息標(biāo)準(zhǔn)化技術(shù)委員會(huì)(SAC/TC346)歸口。本文件起草單位：國(guó)家氣象信息中心、廣東省氣象探測(cè)數(shù)據(jù)中心、四川省氣象探測(cè)數(shù)據(jù)中心、陜西氣象信息中心、內(nèi)蒙古自治區(qū)氣象信息中心、華云信息技術(shù)工程有限公司。1氣象數(shù)據(jù)服務(wù)接口規(guī)范本文件規(guī)定了氣象數(shù)據(jù)服務(wù)接口的組成、名稱、參數(shù)、返回碼與返回?cái)?shù)據(jù)結(jié)構(gòu)，并描述了對(duì)應(yīng)的證實(shí)方法。本文件適用于氣象數(shù)據(jù)服務(wù)接口的設(shè)計(jì)開發(fā)、調(diào)取應(yīng)用和氣象數(shù)據(jù)的提供、使用。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T2260—2007中華人民共和國(guó)行政區(qū)劃代碼GB/T2659—2000世界各國(guó)和地區(qū)名稱代碼GB/T40153—2021氣象資料分類與編碼QX/T37—2020氣象臺(tái)站歷史沿革數(shù)據(jù)文件格式QX/T202—2013表格驅(qū)動(dòng)碼氣象數(shù)據(jù)傳輸文件規(guī)范QX/T327—2016氣象衛(wèi)星數(shù)據(jù)分類與編碼規(guī)范QX/T378—2017公共氣象服務(wù)產(chǎn)品文件命名規(guī)范3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。氣象數(shù)據(jù)meteorologicaldata使用各種觀測(cè)、探測(cè)手段獲取的地球表面和地球大氣的狀態(tài)、現(xiàn)象及其變化過(guò)程的記錄，以及以此為基礎(chǔ)，通過(guò)各種技術(shù)方法進(jìn)行加工處理生成的各類衍生和加工產(chǎn)品。[服務(wù)]接口serviceinterface信息系統(tǒng)為開放特定業(yè)務(wù)功能而發(fā)布的可供其他系統(tǒng)調(diào)用的應(yīng)用編程函數(shù)。數(shù)據(jù)類別datacategory具有共同屬性(或特征)的數(shù)據(jù)的集合。服務(wù)接口調(diào)用后返回的、用以標(biāo)識(shí)調(diào)用成功與否和錯(cuò)誤原因等信息的狀態(tài)碼。注：一般用一個(gè)數(shù)字表示。2服務(wù)接口調(diào)用后返回的內(nèi)存對(duì)象的數(shù)據(jù)組織方式。將計(jì)算機(jī)內(nèi)存對(duì)象轉(zhuǎn)換為可保存或傳輸?shù)臄?shù)據(jù)格式的過(guò)程。4接口組成4.1接口應(yīng)由4部分組成：a)接口名稱：表達(dá)數(shù)據(jù)訪問(wèn)的具體功能；b)接口參數(shù)：表達(dá)數(shù)據(jù)訪問(wèn)的輸入條件；c)返回碼：表達(dá)數(shù)據(jù)訪問(wèn)的調(diào)用狀態(tài)；d)返回?cái)?shù)據(jù)結(jié)構(gòu)：表達(dá)返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)。4.2一個(gè)接口可有一個(gè)或多個(gè)參數(shù)，每個(gè)參數(shù)應(yīng)明確為必選或可選。接口示例見附錄A,接口參數(shù)定義、返回碼取值和返回?cái)?shù)據(jù)結(jié)構(gòu)應(yīng)分別符合附錄B、附錄C和附錄D的規(guī)定。5接口名稱5.1接口名稱應(yīng)由4部分組成：接口功能、數(shù)據(jù)類別、數(shù)據(jù)內(nèi)容、主要條件。其中，接口功能、數(shù)據(jù)類別、數(shù)據(jù)內(nèi)容不應(yīng)為空，主要條件可為空。5.2接口名稱宜采用小駝峰命名法1,命名格式為：{接口功能}{數(shù)據(jù)類別}{數(shù)據(jù)內(nèi)容}{主要條件}。各組成部分的取值應(yīng)符合表1的規(guī)則。表1接口名稱各組成部分的取值規(guī)則組成部分代碼含義備注接口功能直接獲取氣象數(shù)據(jù)或資料的方法接口功能的范圍為提供數(shù)據(jù)，不包含回寫數(shù)據(jù)。接口功能及其代碼取值宜根據(jù)需要擴(kuò)展值、平均、計(jì)數(shù)等統(tǒng)計(jì)方法數(shù)據(jù)類別地面氣象資料符合GB/T40153—2021第5章的要求高空氣象資料海洋氣象資料氣象輻射資料Agme農(nóng)業(yè)氣象和生態(tài)氣象資料Nafp數(shù)值預(yù)報(bào)產(chǎn)品大氣成分資料第一個(gè)單詞的所有字母均為小寫，從第二個(gè)單詞開始之后的每個(gè)單詞的首字母大寫、其余字母均小寫。3表1接口名稱各組成部分的取值規(guī)則(續(xù))組成部分代碼含義備注數(shù)據(jù)類別歷史氣候代用資料符合GB/T40153—2021第5章的要求氣象災(zāi)害資料天氣雷達(dá)資料衛(wèi)星氣象資料科學(xué)試驗(yàn)和考察資料氣象服務(wù)產(chǎn)品空間天氣資料其他資料數(shù)據(jù)內(nèi)容要素適用于站點(diǎn)類、格點(diǎn)類數(shù)據(jù)(要素形式)文件適用于信息類數(shù)據(jù)(文件形式)要素代碼列表數(shù)據(jù)中所包含的全部或部分要素多個(gè)直接連接，不用分隔符主要條件{參數(shù)名稱主要參數(shù)條件多個(gè)條件以“And”連接。參數(shù)名稱應(yīng)符合附錄B的規(guī)定，連接規(guī)則應(yīng)符合6.2的規(guī)定6接口參數(shù)6.1接口參數(shù)宜分為6類。其中，5類用于限定數(shù)據(jù)范圍，分別按照數(shù)據(jù)的代碼、要素、時(shí)間、空間、特殊屬性5個(gè)主要維度定義；1類用于定義其他接口參數(shù)。參數(shù)類別及其描述的輸入條件應(yīng)符合表2的規(guī)定。表2參數(shù)類別及其描述的輸入條件參數(shù)類別參數(shù)描述的輸入條件數(shù)據(jù)代碼類數(shù)據(jù)代碼。如：數(shù)據(jù)代碼(單個(gè))要素范圍類數(shù)據(jù)的要素(含統(tǒng)計(jì)要素)范圍。如：要素列表時(shí)間范圍類數(shù)據(jù)的時(shí)間范圍。如：時(shí)間點(diǎn)、時(shí)間段空間范圍類數(shù)據(jù)的空間范圍。如：經(jīng)度和緯度范圍特殊屬性類數(shù)據(jù)的其他特殊屬性范圍。如：臺(tái)風(fēng)編號(hào)。分為“數(shù)值預(yù)報(bào)產(chǎn)品參數(shù)”“天氣雷達(dá)資料參數(shù)”“衛(wèi)星氣象資料參數(shù)”“氣象服務(wù)產(chǎn)品參數(shù)”等其他類接口其他參數(shù)。如：結(jié)果排序字段6.2接口參數(shù)定義應(yīng)由名稱、含義、賦值類型、賦值格式、賦值示例、使用說(shuō)明組成。其中，名稱宜采用小駝峰命名法連接。6.3接口參數(shù)定義應(yīng)符合附錄B的規(guī)定。其他接口參數(shù)宜根據(jù)需要按照接口參數(shù)定義擴(kuò)展。47.1返回碼分為成功類、失敗類。成功類的返回碼取值為0。失敗類的返回碼取值為負(fù)數(shù)，取值規(guī)則為-{錯(cuò)誤類別代碼}{順序號(hào)}。其中，錯(cuò)誤類別代碼和名稱應(yīng)符合表3的規(guī)定，順序號(hào)為3位數(shù)字，從001開始。表3錯(cuò)誤類別代碼和名稱錯(cuò)誤類別代碼錯(cuò)誤類別名稱0沒(méi)有數(shù)據(jù)1用戶驗(yàn)證失敗2接口與數(shù)據(jù)不匹配3接口參數(shù)錯(cuò)誤4沒(méi)有訪問(wèn)權(quán)限5單次請(qǐng)求范圍過(guò)大6服務(wù)器連接錯(cuò)誤7數(shù)據(jù)庫(kù)操作錯(cuò)誤8數(shù)據(jù)文件錯(cuò)誤9服務(wù)器處理錯(cuò)誤其他錯(cuò)誤7.2返回碼的取值含義應(yīng)符合附錄C的規(guī)定。未定義的返回碼，宜根據(jù)需要按照返回碼的取值含義擴(kuò)展。8返回?cái)?shù)據(jù)結(jié)構(gòu)8.1接口返回?cái)?shù)據(jù)結(jié)構(gòu)類別分為：站點(diǎn)類、格點(diǎn)類和信息類。返回?cái)?shù)據(jù)結(jié)構(gòu)類別、適用數(shù)據(jù)范圍、返回?cái)?shù)據(jù)內(nèi)容應(yīng)符合表4的規(guī)定。表4接口返回?cái)?shù)據(jù)結(jié)構(gòu)類別信息返回?cái)?shù)據(jù)結(jié)構(gòu)類別適用數(shù)據(jù)范圍返回?cái)?shù)據(jù)內(nèi)容站點(diǎn)類站點(diǎn)類數(shù)據(jù)。如：地面氣象資料、高空氣象資料、海洋氣象資料、氣象輻射資料、農(nóng)業(yè)氣象和生態(tài)氣象資料、大氣成分資料、歷史氣候代用資料、氣象災(zāi)害資料、空間天氣資料等二維站點(diǎn)數(shù)據(jù)及其描述信息、接口調(diào)用過(guò)程信息格點(diǎn)類格點(diǎn)類數(shù)據(jù)。如：數(shù)值預(yù)報(bào)產(chǎn)品等二維格點(diǎn)場(chǎng)數(shù)據(jù)及其描述信息、接口調(diào)用過(guò)程信息信息類資料、數(shù)值預(yù)報(bào)產(chǎn)品、科學(xué)試驗(yàn)和考察資料、氣象服務(wù)產(chǎn)品、其他資料等文件信息列表及其描述信息、接口調(diào)用過(guò)程信息58.2接口返回?cái)?shù)據(jù)結(jié)構(gòu)描述應(yīng)符合D.1的規(guī)定，站點(diǎn)類、格點(diǎn)類、信息類應(yīng)分別按D.2、D.3和D.4的規(guī)9證實(shí)方法9.1接口發(fā)布者應(yīng)提供接口說(shuō)明文檔、測(cè)試方案說(shuō)明文檔。9.2審核接口說(shuō)明文檔應(yīng)包括但不限于接口設(shè)計(jì)和服務(wù)功能、接口發(fā)布網(wǎng)站與在線支持、接口應(yīng)用開發(fā)與實(shí)踐等內(nèi)容。9.3審核測(cè)試方案說(shuō)明文檔應(yīng)包括但不限于測(cè)試環(huán)境、測(cè)試準(zhǔn)備、功能測(cè)試用例、非功能測(cè)試用例、測(cè)試流程等內(nèi)容。9.4模擬接口使用者應(yīng)通過(guò)接口開發(fā)驗(yàn)證程序測(cè)試接口運(yùn)行情況。驗(yàn)證程序應(yīng)按照接口說(shuō)明文檔的接口名稱和參數(shù)輸入，調(diào)用后的返回碼和返回?cái)?shù)據(jù)結(jié)構(gòu)與接口說(shuō)明文檔、測(cè)試方案說(shuō)明文檔應(yīng)一致。6(資料性)氣象數(shù)據(jù)服務(wù)接口示例A.1站點(diǎn)類數(shù)據(jù)服務(wù)接口示例表A.1指定時(shí)間的地面氣象資料檢索接口示例接口名稱getSurfEleByTime接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選數(shù)據(jù)代碼字符串標(biāo)識(shí)_HOR表示：中國(guó)地面逐小時(shí)數(shù)據(jù)必選要素代碼字符串多個(gè)以逗號(hào)(,)分隔表示：檢索溫度、降水?dāng)?shù)據(jù)必選時(shí)間字符串YYYYMMDDHH-MISS表示：2008年1月1日00點(diǎn)00分00秒必選表A.2給出了指定時(shí)間、垂直探測(cè)意義、經(jīng)緯度范圍的高空氣象資料檢索接口示例。表A.2指定時(shí)間、垂直探測(cè)意義、經(jīng)緯度范圍的高空氣象資料檢索接口示例接口名稱getUparEleInRectByTimeAndVertical接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選數(shù)據(jù)代碼字符串?dāng)?shù)據(jù)代碼的英文標(biāo)識(shí)UPAR_GLBMUL_FTM表示：全球高空定時(shí)值數(shù)據(jù)必選要素代碼字符串分隔表示：檢索溫度、氣壓數(shù)據(jù)必選意義字符串分隔表示：標(biāo)準(zhǔn)氣壓層必選minLat起始緯度浮點(diǎn)數(shù)最多4位小數(shù)表示：北緯32.1度必選maxLat終止緯度浮點(diǎn)數(shù)最多4位小數(shù)表示：北緯40.3度必選minLon起始經(jīng)度浮點(diǎn)數(shù)最多4位小數(shù)表示：東經(jīng)120.5度必選maxLon終止經(jīng)度浮點(diǎn)數(shù)最多4位小數(shù)表示：東經(jīng)130.0度必選7GB/T42877—2023A.1.3氣象災(zāi)害資料服務(wù)接口示例表A.3給出了指定時(shí)間段、臺(tái)風(fēng)編號(hào)(國(guó)際)的臺(tái)風(fēng)資料檢索接口示例。接口名稱getTyphByTimeRangeAndTyphGids接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選dataCode數(shù)據(jù)代碼字符串?dāng)?shù)據(jù)代碼的英文標(biāo)識(shí)SEVP_WEFC_TYP_WT表示：臺(tái)風(fēng)服務(wù)產(chǎn)品必選timeRange時(shí)間段字符串前開后開：YYYYMMDDHHMISS)前開后閉：YYYYMMDDHHMISS]前閉后開：YYYYMMDDHHMISS)前閉后閉：YYYYMMDDHHMISS]20080102000000]表示：2008年1分00秒(不含)到(含)必選typhGlds臺(tái)風(fēng)編號(hào)(國(guó)際)字符串多個(gè)以逗號(hào)(,)分隔WP242020表示：2020年西太平洋第24個(gè)檢測(cè)對(duì)象必選編報(bào)中心字符串多個(gè)以逗號(hào)(,)分隔ECED表示：歐洲中期數(shù)值預(yù)報(bào)中心必選A.2格點(diǎn)類數(shù)據(jù)服務(wù)接口示例A.2.1數(shù)值預(yù)報(bào)產(chǎn)品格點(diǎn)場(chǎng)要素服務(wù)接口示例接口名稱getNafpEleGridByTimeAndLevelAndValidtime接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選dataCode數(shù)據(jù)代碼字符串標(biāo)識(shí)NAFP_FOR_FTM_LOW_T639_NE-HE表示：T639模式東北半球低分辨率產(chǎn)品必選時(shí)間(單個(gè))字符串YYYYMMDDHH-MISS20080101000000表示：起報(bào)時(shí)間2008必選8接口名稱getNafpEleGridByTimeAndLevelAndValidtime接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選fcstEle預(yù)報(bào)要素(單字符串—表示：檢索溫度要素必選festLevel預(yù)報(bào)層次(單整數(shù)氣壓層次的整數(shù)值，單位：百帕表示：檢索1000百帕氣壓層必選validTime預(yù)報(bào)時(shí)效(單整數(shù)預(yù)報(bào)時(shí)效，單位：小時(shí)表示：自起報(bào)時(shí)間預(yù)報(bào)時(shí)效為24小時(shí)必選A.2.2數(shù)值預(yù)報(bào)產(chǎn)品經(jīng)緯度點(diǎn)要素服務(wù)接口示例接口名稱getNafpEleGridByTimeAndLevelAndValidtime接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選dataCode數(shù)據(jù)代碼字符串標(biāo)識(shí)NAFP_FORT639_NEHE必選時(shí)間(單個(gè))字符串YYYYMMDDHH-MISS20080101000000表示：起報(bào)時(shí)間2008必選fcstEle預(yù)報(bào)要素(單字符串表示：檢索溫度要素必選fcstLevel預(yù)報(bào)層次(單整數(shù)氣壓層次的整數(shù)值，單位：百帕表示：檢索1000百帕氣壓層必選minVT時(shí)效整數(shù)預(yù)報(bào)時(shí)效，單位：小時(shí)表示：自起報(bào)時(shí)間預(yù)報(bào)時(shí)效為24小時(shí)必選maxVT時(shí)效整數(shù)預(yù)報(bào)時(shí)效，單位：小時(shí)表示：自起報(bào)時(shí)間預(yù)報(bào)時(shí)效為48小時(shí)必選經(jīng)緯度點(diǎn)字符串多個(gè)經(jīng)緯度點(diǎn)以逗號(hào)(,)分隔32.1/120.2表示：北緯32.1度，東經(jīng)120.2度的點(diǎn)必選A.3信息類數(shù)據(jù)服務(wù)接口示例A.3.1天氣雷達(dá)資料服務(wù)接口示例表A.6給出了指定時(shí)間段的天氣雷達(dá)資料檢索接口示例。9表A.6指定時(shí)間段的天氣雷達(dá)資料檢索接口示例接口名稱getRadaFileByTimeRange接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選數(shù)據(jù)代碼字符串?dāng)?shù)據(jù)代碼的英文標(biāo)識(shí)RADA_L2_FMT表示：?jiǎn)握纠走_(dá)基數(shù)據(jù)必選時(shí)間段字符串前開后開：(YYYYMM-DDHHMISS,YYYYM-MDDHHMISS)前開后閉：(YYYYMM-DDHHMISS,YYYYM-MDDHHMISS]前閉后開：[YYYYMM-DDHHMISS,YYYYM-MDDHHMISS)前閉后閉：[YYYYMM-DDHHMISS,YYYYM-MDDHHMISS]20080102000000]表示：2008年1月1(不含)到2008年100秒(含)必選A.3.2衛(wèi)星氣象資料服務(wù)接口示例表A.7給出了指定時(shí)間的衛(wèi)星氣象資料檢索接口示例。表A.7指定時(shí)間的衛(wèi)星氣象資料檢索接口示例接口名稱getSateFileByTime接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選數(shù)據(jù)代碼字符串標(biāo)識(shí)SATE_GEO_IM-AGE_MTR2R表示：MTR2R衛(wèi)星地球同步軌道圖片產(chǎn)品必選時(shí)間字符串YYYYMMDDHH-MISS表示：起報(bào)時(shí)間2008必選A.3.3數(shù)值預(yù)報(bào)產(chǎn)品服務(wù)接口示例表A.8給出了指定時(shí)間、預(yù)報(bào)要素的數(shù)值預(yù)報(bào)產(chǎn)品文件檢索接口示例。表A.8指定時(shí)間、預(yù)報(bào)要素的數(shù)值預(yù)報(bào)產(chǎn)品文件檢索接口示例接口名稱getNafpFileByElementAndTime接口參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明必選/可選數(shù)據(jù)代碼字符串標(biāo)識(shí)NAFP_FOR_FTM_LOW_T639_NEHE表示：T639模式東北半球低分辨率產(chǎn)品必選時(shí)間(單個(gè))字符串YYYYMMDDHH-MISS表示：起報(bào)時(shí)間2008必選預(yù)報(bào)要素字符串多個(gè)以逗號(hào)(,)分隔表示：檢索溫度、氣壓數(shù)據(jù)必選GBGB/T42877-2023(規(guī)范性)接口參數(shù)定義接口參數(shù)定義應(yīng)符合表B.1的規(guī)定。表B.1接口參數(shù)定義二類別序號(hào)參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明數(shù)據(jù)代碼類1數(shù)據(jù)代碼(單字符串單個(gè)SURF_CHN_MUL_HOR表示：中國(guó)地面逐小時(shí)數(shù)據(jù)2021第5章的規(guī)定要素范圍類2代碼字符串多個(gè)以逗號(hào)(,)分隔PRE_1h,TEM表示：小時(shí)降水、氣溫不應(yīng)用ALL和×3代碼字符串格式：統(tǒng)計(jì)函數(shù)_要素代碼，多個(gè)以逗號(hào)(,)分隔表示：小時(shí)降水的累計(jì)值，氣溫的平均值統(tǒng)計(jì)函數(shù)包括：SUM、MAX、MIN、AVG、COUNT4要素值范圍字符串以分號(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,小于或等于bVIS:(,1000);RHU:(70,)表示：能見度小于1000m,相對(duì)濕度大于70%類別序號(hào)參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明要素范圍類5statEleValueRanges統(tǒng)計(jì)值范圍字符串其中，要素值范圍的格式；(a,):大于a:(a,):大于或等于a;(,a):小于a;(,a):小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;(a,b):大于a,小于或等于b;[a,b]:大于或等于a,小于或等于bSUM_PRE_1h:(50,)表示：累計(jì)降水大于或等于50mm統(tǒng)計(jì)要素代碼取自statEles時(shí)間范圍類6時(shí)間(單個(gè))字符串YYYYMMDDHHMISS20150101000000表示：2015年1月1日00時(shí)(整點(diǎn))年月日時(shí)分秒應(yīng)補(bǔ)全7times時(shí)間字符串YYYYMMDDHHMISS,多個(gè)以逗號(hào)(,)分隔20150101000000,20150101010000,20150101020000表示：2015年1月1日00時(shí)、01時(shí)、02時(shí)共3個(gè)整點(diǎn)年月日時(shí)分秒應(yīng)補(bǔ)全8timeRange時(shí)間段字符串前開后開：(YYYYMMDDHHMISS,YYYYM-MDDHHMISS);前開后閉：(YYYYMMDDHHMISS,YYYYM-MDDHHMISS];前閉后開：[YYYYMMDDHHMISS,YYYYM-MDDHHMISS);前閉后閉：[YYYYMMDDHHMISS,YYYYM-MDDHHMISS](20150101000000,20150102000000)表示：大于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ù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明時(shí)間范圍類9minWindow時(shí)間窗(分鐘)整數(shù)180min的時(shí)間段單位：分鐘(minminSeparate分鐘取整條件(分鐘)整數(shù)表示：0min,10min,20min,30min,40min,50,min的數(shù)據(jù)與timeRange配合使用hourSeparate小時(shí)取整條件(小時(shí))整數(shù)6表示：00,06,12,18時(shí)的數(shù)據(jù)與timeRange配合使用validTime預(yù)報(bào)時(shí)效(單個(gè))整數(shù)表示：24小時(shí)預(yù)報(bào)單位：小時(shí)(h)validTimes預(yù)報(bào)時(shí)效字符串多個(gè)以逗號(hào)(,)分隔表示：03、06、09時(shí)3個(gè)預(yù)報(bào)時(shí)效單位：小時(shí)(h)minVT起始預(yù)報(bào)時(shí)效整數(shù)0表示：起始預(yù)報(bào)時(shí)效為0時(shí)單位：小時(shí)(h)maxVT終止預(yù)報(bào)時(shí)效整數(shù)表示：終止預(yù)報(bào)時(shí)效為168時(shí)單位：小時(shí)(h)minMD起始月日(歷年同期)字符串MMDD表示：1月1日maxMD截止月日(歷年同期)字符串MMDD表示：12月31日minYear起始年(歷年同期)整數(shù)YYYY表示：2001年maxYear截止年(歷年同期)整數(shù)YYYY表示：2016年daysOfYear日序字符串要素值范圍取值：1～365(平年),1～366(閏年)。多個(gè)以逗號(hào)(,)分隔表示：第1,4,365天僅用于累年日值數(shù)據(jù)類別序號(hào)參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明時(shí)間范圍類pensOfYear候序字符串要素值范圍取值1～72。多個(gè)以逗號(hào)(,)分隔表示：第1,10.72候僅用于累年侯值數(shù)據(jù)旬序字符串要素值范圍取值1～36。多個(gè)以逗號(hào)(,)分隔表示：第1,12,36旬僅用于累年旬值數(shù)據(jù)monsOfYear月序字符串要素值范圍取值1～12。多個(gè)以逗號(hào)(,)分隔表示：1,4,12月僅用于累年月值數(shù)據(jù)日序段字符串要素值范圍取值：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僅用于累年日值數(shù)據(jù)penRangeOfYear候序段字符串要素值范圍取值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僅用于累年侯值數(shù)據(jù)表B.1接口參數(shù)定義(續(xù))示類別序號(hào)參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明時(shí)間范圍類tenRangeOfYear旬序段字符串要素值范圍取值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僅用于累年旬值數(shù)據(jù)monRangeOfYear月序段字符串要素值范圍取值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僅用于累年月值數(shù)據(jù)空間范圍類站號(hào)字符串多個(gè)以逗號(hào)(,)分隔54511.58238表示：北京站和南京站minStald起始站號(hào)字符串表示：從54511站(含)開始maxStald終止站號(hào)字符串表示：到58238站(含)為止minLon起始經(jīng)度浮點(diǎn)數(shù)最多4位小數(shù)表示：經(jīng)度從116.3°(含)開始單位：度(°);取值范圍：(0,360)類別序號(hào)參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明空間范圍類maxLon終止經(jīng)度浮點(diǎn)數(shù)最多4位小數(shù)表示：經(jīng)度到118.25°(含)為止單位：度();取值范圍：(0,360)minLat起始緯度浮點(diǎn)數(shù)最多4位小數(shù)31.14表示：緯度從31.14°(含)開始單位：度();取值范圍：[—90,90_maxLat終止緯度浮點(diǎn)數(shù)最多4位小數(shù)39.56表示：緯度到39.56°(含)為止單位：度():取值范圍：[—90,90_經(jīng)緯度點(diǎn)字符串多個(gè)以逗號(hào)(,)分隔39.56/116.3表示：緯度為39.56°、經(jīng)度為116.3°的點(diǎn)單位：度();緯度范圍：[-90,90];經(jīng)度范圍：(0.360)netCodes臺(tái)站站網(wǎng)字符串多個(gè)以逗號(hào)(,)分隔表示：地面觀測(cè)站氣象臺(tái)站站網(wǎng)符合QX/T37-2020中表3的規(guī)定staLevels臺(tái)站級(jí)別字符串多個(gè)以逗號(hào)(,)分隔表示：國(guó)家級(jí)基準(zhǔn)站臺(tái)站級(jí)別符合QX/T37—2020中表3的規(guī)定adminCodes國(guó)內(nèi)行政編碼字符串多個(gè)以逗號(hào)(,)分隔表示：北京市國(guó)內(nèi)行政編碼符合GB/T2260-2007中表1的規(guī)定nationCodes國(guó)家代碼字符串多個(gè)以逗號(hào)(,)分隔表示：中國(guó)國(guó)家代碼應(yīng)符合GB/T2659—2000中表1的規(guī)定townCodes鎮(zhèn)代碼字符串多個(gè)以逗號(hào)(,)分隔表示：北京市東城區(qū)鎮(zhèn)代碼符合GB/T2260的規(guī)定basinCodes流域編碼字符串多個(gè)以逗號(hào)(,)分隔DA表示：黃河流域流域編碼見HJ932—2017《中國(guó)地表水環(huán)境水體代碼編碼規(guī)則》中的全國(guó)流域區(qū)劃代碼表reportCenters編報(bào)中心字符串多個(gè)以逗號(hào)(,)分隔ECED表示：歐洲中期數(shù)值預(yù)報(bào)中心編報(bào)中心符合QX/T202-2013附錄B的規(guī)定verticals垂直探測(cè)意義字符串多個(gè)以逗號(hào)(,)分隔65536表示：標(biāo)準(zhǔn)氣壓層垂直探測(cè)意義見《氣象觀測(cè)報(bào)告的解碼規(guī)則與算法》中表B.1接口參數(shù)定義(續(xù))號(hào)類別序號(hào)參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明空間范圍類pLayers氣壓層次字符串多個(gè)以逗號(hào)(,)分隔500.700.850表示：500hPa、700hPa、850hPa三個(gè)氣壓層單位：百帕(hPa);氣壓層次見WMO.ManualminPLayer氣壓層次下限整數(shù)表示：850hPa氣壓層單位：百帕(hPa);306).VolumeI.2,代碼表3.15maxPLayer氣壓層次上限整數(shù)表示：100hPa氣壓層單位：百帕(hPa);306).VolumeI.2,代碼表3.15hLayers高度層次字符串多個(gè)以逗號(hào)(,)分隔表示：5000m高度層單位：米(m);高度層次見WMO.ManualminHLayer高度層次下限浮點(diǎn)數(shù)表示：最低層次為15m單位：根據(jù)數(shù)據(jù)種類內(nèi)容確定maxHLayer高度層次上限浮點(diǎn)數(shù)表示；最高層次上限200hPa單位：根據(jù)數(shù)據(jù)種類內(nèi)容確定minFLayer飛行高度層次下限浮點(diǎn)數(shù)表示：高度層次下限為1200m單位：米(m);用于飛機(jī)報(bào)數(shù)據(jù)maxFLayer飛行高度層次上限浮點(diǎn)數(shù)表示：高度層次上限為6000m單位：米(m);用于飛機(jī)報(bào)數(shù)據(jù)土壤深度整數(shù)表示：土壤深度為320cm單位：厘米(cm);用于農(nóng)氣數(shù)據(jù)GB/TGB/T42877-2023類別序號(hào)參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明特殊屬性類(臺(tái)風(fēng)資料參數(shù))typhGIds臺(tái)風(fēng)編號(hào)(國(guó)際)字符串多個(gè)以逗號(hào)(,)分隔WP242020表示：2020年西太平洋第24個(gè)檢測(cè)對(duì)象typhCIds臺(tái)風(fēng)編號(hào)(國(guó)內(nèi))字符串多個(gè)以逗號(hào)(,)分隔2022表示：2020年第22個(gè)熱帶氣旋typhNames臺(tái)風(fēng)名稱字符串多個(gè)以逗號(hào)(,)分隔VAMCO表示：臺(tái)風(fēng)名稱為VAMCO特殊屬性類(數(shù)值預(yù)報(bào)產(chǎn)品參數(shù))fcstEle預(yù)報(bào)要素(單個(gè))字符串TEM表示：溫度預(yù)報(bào)要素應(yīng)符合QX/T102-2009表5的規(guī)定fcstEles預(yù)報(bào)要素字符串多個(gè)以逗號(hào)(,)分隔PRE,PRS表示：降水量，氣壓預(yù)報(bào)要素應(yīng)符合QX/T102-2009表5的規(guī)定fcstLevel預(yù)報(bào)層次(單個(gè))字符串表示：1000hPa單位：百帕(hPa)fcstLevels預(yù)報(bào)層次字符串多個(gè)以逗號(hào)(,)分隔850.1000表示：850hPa和1000hPa單位：百帕(hPa)fcstArea預(yù)報(bào)區(qū)域(單個(gè))字符串GLB表示：全球預(yù)報(bào)區(qū)域應(yīng)符合GB/T40153-2021表2的規(guī)定fcstAreas預(yù)報(bào)區(qū)域字符串多個(gè)以逗號(hào)(,)分隔SHE,NHE表示：南半球和北半球預(yù)報(bào)區(qū)域應(yīng)符合GB/T40153—2021表2的規(guī)定特殊屬性類(天氣雷達(dá)資料參數(shù))radarScans掃描方式字符串多個(gè)以逗號(hào)(,)分隔PPI表示：圓錐掃描模式radarRects覆蓋范圍字符串多個(gè)以逗號(hào)(,)分隔表示：230kmradarElevs仰角字符串多個(gè)以逗號(hào)(,)分隔表示：仰角為1.5°單位：度(°)表B.1接口參數(shù)定義(續(xù))類別序號(hào)參數(shù)名稱含義賦值類型賦值格式賦值示例使用說(shuō)明特殊屬性類(天氣雷達(dá)資料參數(shù))minRadarElev最小仰角字符串表示：最小仰角為1.5°單位：度(°)maxRadarEley最大仰角字符串表示：最大仰角為6單位：度(°)radarResos分辨率字符串多個(gè)以逗號(hào)(,)分隔1表示：空間分辨率為1km單位：千米(km)特殊屬性類(衛(wèi)星氣象資料參數(shù))satelliteNames衛(wèi)星標(biāo)識(shí)字符串多個(gè)以逗號(hào)(,)分隔FY1-A表示：風(fēng)云1號(hào)A星衛(wèi)星標(biāo)識(shí)符合QX/T327—2016表1的規(guī)定channels衛(wèi)星通道字符串多個(gè)以逗號(hào)(,)分隔VIS表示：可見光通道衛(wèi)星通道符合QX/T327—2016表A.2的規(guī)定儀器標(biāo)識(shí)字符串多個(gè)以逗號(hào)(,)分隔VASS表示：大氣垂直探測(cè)系統(tǒng)儀器標(biāo)識(shí)符合QX/T327—2016表A.2的規(guī)定projectNames投影方式字符串多個(gè)以逗號(hào)(,)分隔AEA表示：等面積投影投影方式符合QX/T327—2016表6的規(guī)定sevpProdCodes服務(wù)產(chǎn)品代碼字符串多個(gè)以逗號(hào)(,)分隔CMR]表示：實(shí)景監(jiān)測(cè)服務(wù)產(chǎn)品代碼符合QX/T3782017中表A.3的規(guī)定其他類錄數(shù)整數(shù)表示：最多返回10條orderBy排序字段字符串格式：要素代碼/排序方向，多個(gè)以逗號(hào)(,)分隔；排序方向包括：asc(升序)、desc(降TEM/asc表示：按氣溫升序；SUM_PRE_1h/desc表示：按累計(jì)降水降序要素代碼可以是普通要素(elements),也可以是統(tǒng)計(jì)要素(statEles)distinct返回唯一值(去重復(fù))字符串true或falsetrue表示：去掉重復(fù)記錄默認(rèn)是distinct=false,不可范圍”同時(shí)使用(規(guī)范性)返回碼取值含義返回碼的取值含義應(yīng)符合表C.1的規(guī)定。其他返回碼宜根據(jù)需要按照返回碼的取值含義擴(kuò)展。表C.1返回碼取值含義類別取值含義(英文)含義(中文)備注成功類0Callsucceed調(diào)用成功有數(shù)據(jù)返回失敗類Nodataisretrieved無(wú)數(shù)據(jù)返回(沒(méi)有所需條件范圍的數(shù)據(jù))錯(cuò)誤類別：沒(méi)有數(shù)據(jù)-1001MissinguserID用戶名缺失錯(cuò)誤類別：用戶驗(yàn)證失敗-1002Invaliduser用戶名不存在-1003Missingpassword密碼缺失-1004Passworderror密碼錯(cuò)誤-2001InterfacelDerror接口名錯(cuò)誤錯(cuò)誤類別：接口與數(shù)據(jù)不匹配-2002DataCodeerror數(shù)據(jù)代碼錯(cuò)誤-3001Parametervalueerror參數(shù)賦值錯(cuò)誤錯(cuò)誤類別：接口參數(shù)錯(cuò)誤-3002Missingparameter參數(shù)缺失-3003Uselessparameter參數(shù)多余或未定義-4001Norighttoaccessthedata沒(méi)有訪問(wèn)該數(shù)據(jù)的權(quán)限錯(cuò)誤類別：沒(méi)有訪問(wèn)權(quán)限-4002Norighttoaccessthehistorydata沒(méi)有訪問(wèn)該歷史數(shù)據(jù)的權(quán)限-5001檢索的時(shí)間跨度超過(guò)范圍錯(cuò)誤類別：?jiǎn)未握?qǐng)求范圍過(guò)大-5002Timeparameternumberexceeds檢索的時(shí)間點(diǎn)個(gè)數(shù)超過(guò)限制-6001Failedtoconnectserver服務(wù)器連接失敗錯(cuò)誤類別：服務(wù)器連接錯(cuò)誤-7001錯(cuò)誤類別：數(shù)據(jù)庫(kù)操作錯(cuò)誤-8001Filedoesnotexist文件不存在錯(cuò)誤類別：數(shù)據(jù)文件錯(cuò)誤-8002Filecannotberead文件不可讀-9001接口基礎(chǔ)功能處理異常錯(cuò)誤類別：服務(wù)器處理錯(cuò)誤-9002Failedtoprocessparameter接口參數(shù)處理異常-10001Otherexceptionofserver服務(wù)器其他異常錯(cuò)誤類別：其他錯(cuò)誤GB/T42877—2023(規(guī)范性)返回?cái)?shù)據(jù)結(jié)構(gòu)D.1結(jié)構(gòu)描述說(shuō)明語(yǔ)言，表示接口的內(nèi)存對(duì)象結(jié)構(gòu)及其序列化格式。其中，內(nèi)存對(duì)象結(jié)構(gòu)為接口返回的寄存在內(nèi)存中的數(shù)據(jù)結(jié)構(gòu)，宜直接被程序調(diào)用；序列化字符串包括XML、JSON、JSONP、TEXT、HTML等格式；Python等其他語(yǔ)言和xarray等其他序列化格式的表示，參照使用。返回文件內(nèi)容信息；接口調(diào)用客戶端獲取URL后，使用通用的HTTP、TDS等服務(wù)協(xié)議去獲取文件內(nèi)容信息，信息類結(jié)構(gòu)適用NetCDF、GRIB1/2等文件格式。D.2站點(diǎn)類返回?cái)?shù)據(jù)結(jié)構(gòu)D.2.1內(nèi)存對(duì)象結(jié)構(gòu)：RetArray2D站點(diǎn)類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetArray2D信息，包括數(shù)組、記錄數(shù)、字段數(shù)、接口調(diào)用過(guò)程信息等，應(yīng)符合表D.1的規(guī)定。表D.1站點(diǎn)類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetArray2D信息結(jié)構(gòu)名稱RetArray2D使用說(shuō)明適用于檢索站點(diǎn)類數(shù)據(jù)、格點(diǎn)類數(shù)據(jù)中單點(diǎn)或多點(diǎn)的要素值、臺(tái)站元數(shù)據(jù)信息等接口Fortran結(jié)構(gòu)體成員成員名稱requestInfoRequestInfoFortran類型Character(*,*,*)Type(RequestInfo)成員說(shuō)明長(zhǎng)度rowCount,二維長(zhǎng)度colCount記錄數(shù)字段數(shù)接口調(diào)用過(guò)程信息，包括返回碼、錯(cuò)誤信息、請(qǐng)求的參數(shù)、請(qǐng)求接收合D.5的規(guī)定類成員成員名稱requestInfoC#/Java類型RequestInfo成員說(shuō)明獲取的數(shù)據(jù)接口調(diào)用過(guò)程信息，包括返回碼、錯(cuò)誤信息、請(qǐng)求的參數(shù)、請(qǐng)求接收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合D.5的規(guī)定D.2.2序列化格式站點(diǎn)類返回?cái)?shù)據(jù)的XML、JSON、JSONP、TEXT、HTML等幾類格式信息，包括數(shù)據(jù)和接口調(diào)用過(guò)程信息等，應(yīng)符合表D.2的規(guī)定。表D.2站點(diǎn)類返回?cái)?shù)據(jù)的序列化格式信息格式類型格式信息《DSreturnCode="返回碼"returnMessage="返回碼說(shuō)明(含錯(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:"返回碼說(shuō)明(含錯(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:”返回碼說(shuō)明(含錯(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="返回碼說(shuō)明(含錯(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í)(毫秒)"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)格點(diǎn)類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetGridArray2D信息，包括數(shù)組、網(wǎng)格定義、接口調(diào)用過(guò)程信息結(jié)構(gòu)名稱RetGridArray2D使用說(shuō)明適用于檢索站點(diǎn)類數(shù)據(jù)、格點(diǎn)類數(shù)據(jù)中單點(diǎn)或多點(diǎn)的要素值、臺(tái)站元數(shù)據(jù)信息等接口表D.3格點(diǎn)類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetGC/C++/Fortran結(jié)構(gòu)體成員成員名稱startLatstartLonendLatendLonlatCountlonCountrequestInfoC/C++類型float[][-floatfloatfloatfloatfloatfloatRequestInfoFortran類型Real(*,realrealrealrealrealrealType(Request成員說(shuō)明獲取的數(shù)二維長(zhǎng)度始緯度始經(jīng)度束緯度束經(jīng)度緯向格點(diǎn)數(shù)點(diǎn)數(shù)緯度格距經(jīng)度格距程信息，包括返回碼、錯(cuò)誤信息、請(qǐng)求的參數(shù)、請(qǐng)求接收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合規(guī)定C#/Java類成員成員名稱startLatstartLonendLatendLonlatCountlonCountrequestInfoC#/Java類型floatfloatfloatfloatfloatfloatfloatRequestInfo成員說(shuō)明度從西到二維長(zhǎng)度始緯度始經(jīng)度束緯度束經(jīng)度緯向格點(diǎn)數(shù)點(diǎn)數(shù)緯度格距經(jīng)度格距程信息，包括返回碼、錯(cuò)誤信息、請(qǐng)求的參數(shù)、請(qǐng)求接收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合規(guī)定D.3.2序列化格式GB/T42877—2023表D.4格點(diǎn)類返回?cái)?shù)據(jù)的序列化格式信息格式類型格式信息XML<?xmlversion="1.0"encoding="UTF-8"?><DSreturnCode="返回碼"returnMessage="返回碼說(shuō)明(含錯(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ù)，此處省略--)JSON{returnCode:“返回碼”,returnMessage:"返回碼說(shuō)明(含錯(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í)(毫秒)”,DS:[[字段值1,字段值2,字段值3,……],[字段值1,字段值2,字段值3,……],……//其他行數(shù)據(jù)，此處省略]}JSONP回調(diào)函數(shù)名稱({returnCode:"返回碼",returnMessage:"返回碼說(shuō)明(含錯(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í)(毫秒)",DS:[[字段值1,字段值2,字段值3,……],[字段值1,字段值2,字段值3,……],……//其他行數(shù)據(jù)，此處省略]TEXT//注：第1行，調(diào)用信息returnCode=“返回碼”returnMessage="返回碼說(shuō)明(含錯(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í)(毫秒)”//注：第2-n行，每行對(duì)應(yīng)一條數(shù)據(jù)記錄值1值2值3值4值5值6值7……表D.4格點(diǎn)類返回?cái)?shù)據(jù)的序列化格式信息(續(xù))格式類型格式信息HTML(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)信息類返回?cái)?shù)據(jù)的內(nèi)存對(duì)象結(jié)構(gòu)RetFilesInfo信息，包括文件信息清單、文件數(shù)、接口調(diào)用過(guò)程信結(jié)構(gòu)名稱RetFilesInfo使用說(shuō)明適用于檢索文件列表信息的接口，一般為非結(jié)構(gòu)化預(yù)報(bào)文件和圖形文件等C/C++/Fortran結(jié)構(gòu)體成員成員名稱filelnfosfileCountrequestInfoC/C++類型FileInfo[]RequestInfoFortran類型Type(Filelnfo)(*)Type(RequestInfo)成員說(shuō)明檢索下載的文件信息清單，長(zhǎng)度：fileCount,應(yīng)符合表D.6規(guī)定獲取的文件數(shù)接口調(diào)用過(guò)程信息，包括返回碼、錯(cuò)誤信息、請(qǐng)求的參數(shù)、請(qǐng)求接收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合D.5的規(guī)定C#/Java類成員成員名稱fileInfosrequestInfoC#/Java類型Filelnfo[]RequestInfo成員說(shuō)明檢索下載的文件信息清單。應(yīng)符合表D.6的規(guī)定接口調(diào)用過(guò)程信息，包括返回碼、錯(cuò)誤信息、請(qǐng)求的參數(shù)、請(qǐng)求接收時(shí)間、結(jié)果返回時(shí)間、耗時(shí)等，應(yīng)符合附錄D.5的規(guī)定GB/T42877—2023D.4.2單個(gè)文件信息的內(nèi)存對(duì)象結(jié)構(gòu)：FileInfo單個(gè)文件信息的內(nèi)存對(duì)象結(jié)構(gòu)Filelnfo信息，包括接口調(diào)用客戶端文件名、全路徑、文件后綴、文件大小、接口服務(wù)端文件URL等，應(yīng)符合表D.6的規(guī)定。表D.6單個(gè)文件信息的內(nèi)存對(duì)象結(jié)構(gòu)FileInfo信息結(jié)構(gòu)名稱Filelnfo使用說(shuō)明描述單個(gè)文件的信息。RetFilesInfo中的成員filelnfos,是本數(shù)據(jù)結(jié)構(gòu)的數(shù)組Fortran結(jié)構(gòu)體成員成員名稱類型Fortran類型CharacterCharacter(*)CharacterCharacterCharacter(*)Character(*,成員說(shuō)明接口調(diào)用客戶端文件名(含后接口調(diào)用客戶端文件全路徑名(路徑十文件名)。在僅獲取文件信息列表員為空文件后綴文件URLbase64編碼數(shù)除固定輸出的要素類成員成員名稱類型成員說(shuō)明文件名(含后綴)文件全路徑名文件后綴服務(wù)端文base64編碼數(shù)除固定輸出的要素D.4.3序列化格式信息類返回?cái)?shù)據(jù)的XML、JSON、JSONP、TEXT、HTML等幾類格式信息，包括文件信息清單、文件數(shù)、接口調(diào)用過(guò)程信息等，應(yīng)符合表D.7的規(guī)定。表D.7信息類返回?cái)?shù)據(jù)的序列化格式信息格式類型格式信息XML<?xmlversion="1.0"encoding="UTF-8"?><DSreturnCode="返回碼"returnMessage="返回碼說(shuō)明(含錯(cuò)誤信息)"fileCount="文件數(shù)"requestParams=“調(diào)用參數(shù)”requestTime="接收請(qǐng)求時(shí)間"responseTime="返回請(qǐng)求結(jié)果時(shí)間"表D.7信息類返回?cái)?shù)據(jù)的序列化格式信息(續(xù))格式類型格式信息takeTime="耗時(shí)(毫秒)"〉<RfileName=""fileUrl=""suffix=""size=""imgBase64=""attributesl=""…attributesn=""/)<RfileName=""fileUrl=""suffix=""size=""imgBase64=""attributesl=""…attributesn=""/)<!-其他行數(shù)據(jù)，此處省略--〉{returnCode:“返回碼”,returnMessage:“返回碼說(shuō)明(含錯(cuò)誤信息)”,fileCount:"文件數(shù)",requestParams:“調(diào)用參數(shù)",requestTime: