气象数据服务接口示例、常用接口参数、返回码定义清单、返回数据结构.docxVIP

（资料性）接口示例 A.1 站点资料服务接口示例 A.1.1 地面资料服务接口示例 作为示例，表A.1给出了指定时间的地面资料检索接口。 表A.1指定时间的地面资料检索接口 接口名称 getSurfEleByTime 参数代码 中文名 参数类型 赋值格式/示例 必选/可选 dataCode 资料代码 字符串 示例：SURF_CHN_MUL_HOR 必选 elements 要素代码 字符串 多个以逗号(,)分隔 必选 times 时间 字符串 YYYYMMDDHHMISS 必选 返回码 见附录C 返回数据结构 站点类返回数据结构，见附录D.2 A.1.2 高空资料服务接口示例 作为示例，表A.2给出了指定时间、高度、经纬度范围的高空资料检索接口。 表A.2指定时间、高度、经纬度范围的高空资料检索接口 接口名称 getUparEleInRectByTimeAndVertical 参数代码 中文名 参数类型 赋值格式/示例 必选/可选 dataCode 资料代码 字符串 示例：UPAR_GLB_MUL_FTM 必选 elements 要素代码 字符串 多个以逗号(,)分隔 必选 times 时间 字符串 YYYYMMDDHHMISS 必选 verticals 垂直探测意义 字符串 多个以逗号(,)分隔 必选 minLat 起始纬度 浮点数 最多4位小数 必选 maxLat 终止纬度 浮点数 最多4位小数 必选 minLon 起始经度 浮点数 最多4位小数 必选 maxLon 终止经度 浮点数 最多4位小数 必选 返回码 见附录C 返回数据结构 站点类返回数据结构，见附录D.2 A.1.3 台风资料服务接口示例 作为示例，表A.3给出了指定时间段、台风编号（国际）的台风资料检索接口。 表A.3指定时间段、台风编号（国际）的台风资料检索接口 接口名称 getTyphByTimeRangeAndTyphGids 参数代码 中文名 参数类型 赋值格式/示例 必选/可选 dataCode 资料代码 字符串 示例：SEVP_WEFC_TYP_WT 必选 表A.3指定时间段、台风编号（国际）的台风资料检索接口（续） 接口ID getTyphByTimeRangeAndTyphGids 参数代码 中文名 参数类型 赋值格式/示例 必选/可选 timeRange 时间段 字符串 前开后开：(YYYYMMDDHHMISS,YYYYMMDDHHMISS)前开后闭：(YYYYMMDDHHMISS,YYYYMMDDHHMISS]前闭后开：[YYYYMMDDHHMISS,YYYYMMDDHHMISS)前闭后闭：[YYYYMMDDHHMISS,YYYYMMDDHHMISS] 必选 typhGIds 台风编号（国际） 字符串 多个以逗号(,)分隔 必选 reportCenters 编报中心 字符串 多个以逗号(,)分隔 可选 返回码 见附录C 返回数据结构 站点类返回数据结构，见附录D.2 A.2数值格点资料解析接口示例 A.2.1格点场解码要素服务接口示例 作为示例，表A.4给出了指定时间、预报层次、预报时效的单场单要素检索接口。 表A.4 指定时间、预报层次、预报时效的单场单要素检索接口 接口名称 getNafpEleGridByTimeAndLevelAndValidtime 参数代码 中文名 参数类型 赋值格式/示例 必选/可选 dataCode 资料代码 字符串 示例：NAFP_FOR_FTM_LOW_T639_NEHE 必选 time 时间（单个） 字符串 YYYYMMDDHHMISS 必选 fcstEle 预报要素（单个） 字符串 TEM：气温 必选 fcstLevel 预报层次（单个） 整数 1000：1000hpa层次 必选 validTime 预报时效（单个） 整数 24：24小时预报 必选 返回码 见附录C 返回数据结构 格点类返回数据结构，见附录D.3 A.2.2经纬度点要素服务接口示例 作为示例，表A.5给出了指定时间范围、预报层次、预报时段、经纬度的时间序列检索接口。 表A.5 指定时间范围、预报层次、预报时段、经纬度的时间序列检索接口 接口名称 getNafpEleAtPointByTimeAndLevelAndValidtimeRange 参数代码 中文名 参数类型 赋值格式/示例 必选/可选 dataCode 资料代码 字符串 示例： NAFP_FOR_FTM_LOW_T639_NEHE 必选 time 时间（单个） 字符串 YYYYMMDDHHMISS 必选 表A.5指定时间范围、预报层次、预报时段、经纬度的时间序列检索接口（续） 接口名称 getNafpEleAtPointByTimeAndLev