DB41∕T 1809-2019 气象服务数据接口规范

平台河南省地方标准公共服务

07.060平台河南省地方标准公共服务A

47DB41 41/T

1809—2019气象服务数据接口规范

发布

实施河南省市场监督管理局 发

布河南省地方标准公共服务平台DB41/T

1809—2019河南省地方标准公共服务平台 本标准按照GB/T

给出的规则起草。本标准由河南省气象标准化技术委员会提出并归口。本标准起草单位：河南省气象服务中心。营、李宁、徐慈远。河南省地方标准公共服务平台DB41/T

1809—2019河南省地方标准公共服务平台1 范围本标准规定了气象服务数据接口的术语和定义、访问方法、授权机制、效能要求和接口说明。本标准适用于气象服务数据接口的设计和使用。2 规范性引用文件凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T

中华人民共和国行政区划代码3 术语和定义下列术语和定义适用于本文件。3.1气象服务数据在公众、行业等气象服务中向用户提供的气象数据。4 访问方法4.1 访问地址URL采用IP地址。4.2 访问步骤气象服务数据接口按以下步骤访问：a)

册用户名和密码。或应由气象服务数据接口单位给用户在平台上创建用户名和密码；b)

APPid

和气象服务数据接口访问密钥

Key（Key

应具有有效期，有效期内用户可重复使用，超过有效期系统为用户重新生成

c)

用户应通过用户名和密码登陆平台，获取气象服务数据接口资源访问地址；d)

用户应在气象服务数据资源地址中加入

APPid

和

，形式

&appid=<APPid>&key=<Key>”,生成服务资源请求地址；e)

用户应采用

HTTP

协议中的

POST

方法调用气象服务数据资源请求地址，获取返回结果。4.3 服务请求河南省地方标准公共服务平台DB41/T

1809—2019河南省地方标准公共服务平台4.3.1 服务请求字符串编码服务请求字符串编码宜采用UTF-8字符集。4.3.2 服务请求参数 位置参数位置参数可采用下列五种编码之一：a)

按

GB/T

规定的中华人民共和国行政区划编码，所有行政区划的位置参数应为

12

12

0见附录

A

表

A.1）；b)

气象台站区站号（河南省气象台站区站号见附录

A

表

A.2）；c)

气象台站字母代号编码（河南省气象台站字母代号编码见附录

A

表

A.3）；d)

2000

国家大地坐标系经纬度信息；e)

其它约定的位置信息。 时间参数时间参数宜采用YYYYMMDDHHmmSS的格式。其中，YYYY4MM2DD2HH2位，24mm表示分钟（2位），SS表示秒（2位）。如无特殊说明，时间应为时间。4.3.3 请求字符串的组成服务请求字符串应包含服务请求参数、访问密钥等信息，不应包含明文密码等敏感信息。4.4 服务响应4.4.1 返回格式气象服务数据接口宜以格式返回结果（JSONB）。返回结果应包括响应代码、响应消息和数据体三部分。其中：a)

响应代码

格式宜为整数型（响应代码见附录

C）；b)

响应消息

resMsg

格式宜为字符型，返回内容应为响应代码

resCode

的详细说明（响应消息见附录

C）；c)

数据体

data

格式宜为数组型，返回内容应为气象服务数据的具体描述。4.4.2 返回结果编码返回结果编码宜采用UTF-8字符集。5 授权机制5.1 用户授权要求气象服务数据接口宜通过加密算法对用户进行授权。5.2 用户授权算法河南省地方标准公共服务平台DB41/T

1809—2019河南省地方标准公共服务平台字符串做32位加密，形成值。其中，YYYY表示年（4MM表示月（2位），DD表示日（26 效能要求6.1 并行性气象服务数据接口应提供多用户并行访问支持。6.2 响应时间气象服务数据接口响应时间应小于

ms。7 接口说明气象服务数据接口单位应提供接口说明，并应与气象服务数据接口一起提交用户使用。数据接口调用示例代码（数据接口说明示例见附录D）。410000000000410527000000411300000000410100000000410581000000411302000000410102000000410600000000411303000000410103000000410602000000411321000000410104000000410603000000411322000000410105000000410611000000411323000000410106000000410621000000411324000000410108000000410622000000411325000000410122000000410700000000411326000000410181000000410702000000411327000000410182000000410703000000411328000000410183000000410704000000411329000000410184000000410711000000411330000000410185000000410721000000411381000000410200000000410724000000411400000000410202000000410725000000411402000000410203000000410726000000411403000000410204000000410727000000411421000000410205000000410728000000411422000000410212000000410781000000411423000000410221000000410782000000411424000000410222000000410800000000411425000000410223000000410802000000411426000000410225000000410803000000411481000000410300000000410804000000411500000000410302000000410811000000411502000000410303000000410821000000411503000000服务公共地方标准河南省平台DB41/T

1809—2019服务公共地方标准河南省平台AA附

录 A（资料性附录）位置参数编码A.1 河南省县以上行政区划代码见表。表A.1表A.1 河南省县以上行政区划代码410304000000410822000000411521000000410305000000410823000000411522000000410306000000410825000000411523000000410311000000410882000000411524000000410322000000410883000000411525000000410323000000410900000000411526000000410324000000410902000000411527000000410325000000410922000000411528000000410326000000410923000000411600000000410327000000410926000000411602000000410328000000410927000000411621000000410329000000410928000000411622000000410381000000411000000000411623000000410400000000411002000000411624000000410402000000411003000000411625000000410403000000411024000000411626000000410404000000411025000000411627000000410411000000411081000000411628000000410421000000411082000000411681000000410422000000411100000000411700000000410423000000411102000000411702000000410425000000411103000000411721000000410481000000411104000000411722000000410482000000411121000000411723000000410500000000411122000000411724000000410502000000411200000000411725000000410503000000411202000000411726000000410505000000411203000000411727000000410506000000411221000000411728000000410522000000411224000000411729000000410523000000411281000000419001000000410526000000411282000000平台地方标准河南省公共服务DB41/T

1809—2019平台地方标准河南省公共服务表A.1 河南省县以上行政区划代码表A.1 河南省县以上行政区划代码见表。53889570665716257274538985706757169572815397257070571715728553974570715717357289539785707257175572905397957073571765729253982570745717757293539835707557178572945398457076571795729553985570775718057296539865707857181572975398757079571825729853988570805718357299539895708157184573905399057082571855739653991570835718658001539925708557187580045399357086571885800553994570875718958006539955708857190580075399757089571915800853998570905719258009548175709157193580105490057093571945810054901570945719558101549025709557196581045490357096571975811157051570975719858205570565709857261582075706357099572715820857065571565727358301平台公共地方标准河南省服务DB41/T

1809—2019平台公共地方标准河南省服务表A.2 河南省气象台站区站号表A.2 河南省气象台站区站号见表。BFAYBULBBUZCBUNXBTAYBFLBBUNIBUXIBUTYBTMJBUXYBTXABUNHBURYBUYOBUNZBUHXBUYCBFPSBUTBBULZBUSXBURZBFZMBFHIBTLCBULSBUSPBUXUBUYIBUWGBUQSBUQXBULNBUJXBURNBFPYBUXABTBFBUPIBUPYBUYSBUYXBUXNBUQFBFZZBUPSBUZYBUNLBUXGBFZKBUBYBUFXBUXZBUFGBUSCBUTQBUGYBUTKBUXPBFJTBUZMBUHYBFXIBUXWBUXMBTXHBTGSBUBABUDFBUCHBULUBUQYBFKFBUXCBUXXBUMZBUWSBUSABUHBBUWXBUTXBUDCBUHCBUWZBUQIBULYBUSHBUJYBULKBUSEBUGSBFXXBFXCBUFQBUXBBUWHBUYZBFLEHA-MOBUYJBUCGBUWYHA-CCBUFEBUYLBULIHA-IMSBUCYBUXHBFNYHA-MSCBUYYBFSQBUFCHA-LPCBUHUBUSYBUSQHA-WMOBUHJBULQBUTHHA-MICBFSFBUSUBUXEBTLSBUMQBUDZBUMCBUYUBUZP平台服务地方标准公共河南省DB41/T

1809—2019平台服务地方标准公共河南省表A.3表A.3 河南省气象台站字母编号代码resCodeIntresMsgStringdataArray地方标准公共服务河南省平台DB41/T

1809—2019地方标准公共服务河南省平台BB附

录 B（资料性附录）JSON

格式示例JSON{“resCode”:“…”,“resMsg”:“…“data”:{[……]}}JSON格式返回数据示例见表B.1。表B.1表B.1 JSON

格式返回数据示例000101

102103104105

106201APPId

202102031120412205133021430315304163051730618401公共地方标准河南省服务平