根据单一要素、某一时间点、经纬度范围查询地面实况站点观测数据
<h5>简要描述</h5>
<ul>
<li>基于指定的EWENS要素、时间和经纬度范围,查询并返回该要素的格点数据;</li>
<li>其中时间默认为当前最新整10分钟时刻;区域为东经:73.44°-135.08°,北纬:18.16°-53.56°;</li>
<li>当传递的时间不在当前时刻往前1小时之内的话,则返回返回最新整10分钟时刻的数据信息</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code> </code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>restful/dubbo </li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">element</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>要素,详见EWENS数据要素字典</td>
</tr>
<tr>
<td style="text-align: left;">dateTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>1小时内的某个整10分钟时刻;默认选择当前最新整10分钟时刻(向下取整);北京时</td>
</tr>
<tr>
<td style="text-align: left;">lonlat</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">float[]</td>
<td>经纬度范围;格式:[min_lon,min_lat,max_lon,max_lat];默认为[73.44f,18.16f,135.08f,53.56f]</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<ul>
<li>当数据量<strong>大于8M</strong>时,返回<strong>Redis的key值</strong>,示例如下:</li>
</ul>
<pre><code>{
"success": true,
"code": 200,
"message": "成功",
"data": {
"realtime": {
"type": "REDISKEY",
"value": "eco-base:ewens:20200204181000:RH:73.44-18.16-135.08-53.56",
"obj": null
}
}
}</code></pre>
<ul>
<li>当数据量<strong>小于等于8M</strong>时,返回<strong>Ewens单要素数据对象</strong>,示例如下:</li>
</ul>
<pre><code>{
"success": true,
"code": 200,
"message": "成功",
"data": {
"EwensData": {
"type": "VALUEOBJECT",
"value": "",
"obj": {
"variable":"RH",
"dateTime":"2020-02-04 18:15:56",
"START_LAT":18.16,
"END_LAT":53.56,
"STEP_LAT":0.01,
"SIZE_LAT":3541,
"START_LON":73.44,
"END_LON":135.08,
"STEP_LON":0.01,
"SIZE_LON":6163,
"dataArray":[234,234,226,298,301]
}
}
}
}</code></pre>
<h5>结果参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">返回参数名</th>
<th style="text-align: left;">参数类型</th>
<th style="text-align: left;">参数说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">success</td>
<td style="text-align: left;">boolean</td>
<td style="text-align: left;">请求是否成功<br>true:请求成功<br>false:请求失败</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">响应状态码<br>200:成功<br>202:请求参数错误<br>201:其他错误</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">状态码描述信息<br>200:成功<br>202:请求参数错误<br>201:其他错误</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">json</td>
<td style="text-align: left;">Ewens数据接口服务对象</td>
</tr>
</tbody>
</table>
<h5>Ewens数据接口服务对象说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">ReturnType</td>
<td>接口返回值描述;REDISKEY:要素在REDIS的key值;VALUEOBJECT:要素对象;FILEPATH:要素文件地址</td>
</tr>
<tr>
<td style="text-align: left;">value</td>
<td style="text-align: left;">String</td>
<td>当type为REDISKEY时,存放redis的key值</td>
</tr>
<tr>
<td style="text-align: left;">obj</td>
<td style="text-align: left;">T</td>
<td>当type为VALUEOBJECT时,存放Ewens单要素数据对象</td>
</tr>
</tbody>
</table>
<h5>Ewens单要素数据对象说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">variable</td>
<td style="text-align: left;">string</td>
<td>要素编码</td>
</tr>
<tr>
<td style="text-align: left;">dateTime</td>
<td style="text-align: left;">string</td>
<td>数据时间,格式:yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">START_LAT</td>
<td style="text-align: left;">float</td>
<td>起始纬度</td>
</tr>
<tr>
<td style="text-align: left;">END_LAT</td>
<td style="text-align: left;">float</td>
<td>结束纬度</td>
</tr>
<tr>
<td style="text-align: left;">STEP_LAT</td>
<td style="text-align: left;">float</td>
<td>纬度间隔</td>
</tr>
<tr>
<td style="text-align: left;">SIZE_LAT</td>
<td style="text-align: left;">int</td>
<td>纬度大小</td>
</tr>
<tr>
<td style="text-align: left;">START_LON</td>
<td style="text-align: left;">float</td>
<td>起始经度</td>
</tr>
<tr>
<td style="text-align: left;">END_LON</td>
<td style="text-align: left;">float</td>
<td>结束经度</td>
</tr>
<tr>
<td style="text-align: left;">STEP_LON</td>
<td style="text-align: left;">float</td>
<td>经度间隔</td>
</tr>
<tr>
<td style="text-align: left;">SIZE_LON</td>
<td style="text-align: left;">int</td>
<td>经度大小</td>
</tr>
<tr>
<td style="text-align: left;">dataArray</td>
<td style="text-align: left;">float[]</td>
<td>要素数据</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ol>
<li>返回的要素数据为float类型的一维数组,数据按先经向后纬向存放,第一个数据为最小经度,最大纬度的要素值。</li>
<li>当返回值为Redis的key值时,默认保存1分钟,key值规则为"eco-base:ewens:"+所传时间+":"+所传要素编码+":"+"经纬度范围,以'-'分割",例如:eco-base:ewens:20200212122000:RH:73.44-18.16-135.08-53.56。</li>
<li>EWENS数据要素字典(地面实况站点观测数据):
<a href="https://www.showdoc.com.cn/684009359051745?page_id=6304512148877846">https://www.showdoc.com.cn/684009359051745?page_id=6304512148877846</a>
<ul>
<li>撰写人:陈硕</li>
</ul></li>
</ol>