车辆实时定位查询
<p><strong>简要描述：</strong> </p>
<ul>
<li>车辆实时定位查询</li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>API地址： <a href="https://open-beta.56yzm.com:8443">https://open-beta.56yzm.com:8443</a> （不同的环境，不同的API地址）</li>
<li>请求地址：/open-api/location/car/zhongjiao/transTimeManageV3</li>
</ul>
<p><strong>请求头数据 </strong></p>
<ul>
<li>Content-Type : application/json;charset=UTF-8 </li>
<li>Authorization: Bearer {your_access_token} </li>
</ul>
<p><strong>入参参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">vnos</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>车牌号_车牌颜色，多个车辆以英文逗号分隔（最多 100 台车，颜色：1 蓝色、2 黄色、3黄绿（包含新能源））<br>例：京 A78601_1, 京A78602_2, 京A78603_3</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">startLonlat</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>始发地坐标(WGS84 坐标系 保留6位小数)（始发地坐标和目的地坐标为一组；始发地行政区划编码和目的地行政区划编码为一组；都输入的时候以始发地坐标、目的地坐标为准）<br>例：116.31795,30.4252</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">endLonlat</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>目的地坐标(WGS84 坐标系 保留6位小数)（始发地坐标和目的地坐标为一组；始发地行政区划编码和目的地行政区划编码为一组；都输入的时候以始发地坐标、目的地坐标为准）<br>例：110.9946817,25.9089816</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">startAreaCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>始发地行政区划编码（区县编码）（始发地坐标和目的地坐标为一组；始发地行政区划编码和目的地行政区划编码为一组；都输入的时候以始发地坐标、目的地坐标为准）<br>例：431102</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">endAreaCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>目的地行政区划编码（区县编码）（始发地坐标和目的地坐标为一组；始发地行政区划编码和目的地行政区划编码为一组；都输入的时候以始发地坐标、目的地坐标为准）<br>例：450324</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">timeNearby</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>时间范围，单位:小时，指返回车辆最近时间范围内的最后定位信息<br>例：24(注:单位为小时，结合需要实际使用情况动态设置)</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>入参示例</strong></p>
<pre><code>{&quot;vnos&quot;:&quot;闽GA5266_2&quot;}</code></pre>
<p><strong>返回参数说明</strong> </p>
<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;">firstVcl</td>
<td style="text-align: left;">object</td>
<td>首车查询结果</td>
</tr>
<tr>
<td style="text-align: left;">others</td>
<td style="text-align: left;">array</td>
<td>其余车辆列表。</td>
</tr>
</tbody>
</table>
<p><strong>返回参数firstVcl说明</strong> </p>
<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;">vno</td>
<td style="text-align: left;">string</td>
<td>车牌号 例：京 AB0001</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">string</td>
<td>状态码（业务查询状态：详见附录 A）<br>例：1001</td>
</tr>
<tr>
<td style="text-align: left;">lon</td>
<td style="text-align: left;">number</td>
<td>车辆最后定位经度（格式：1/600000.0（WGS84 坐标系））<br>例：19356858</td>
</tr>
<tr>
<td style="text-align: left;">lat</td>
<td style="text-align: left;">number</td>
<td>车辆最后定位纬度（格式：1/600000.0（WGS84 坐标系））<br>例：71847300</td>
</tr>
<tr>
<td style="text-align: left;">adr</td>
<td style="text-align: left;">string</td>
<td>车辆地理位置名称 <br>例：江苏省镇江市扬中市</td>
</tr>
<tr>
<td style="text-align: left;">utc</td>
<td style="text-align: left;">string</td>
<td>车辆定位时间（时间戳）<br>例：1635497914000</td>
</tr>
<tr>
<td style="text-align: left;">spd</td>
<td style="text-align: left;">string</td>
<td>速度（单位 km/h）<br>例：39.1</td>
</tr>
<tr>
<td style="text-align: left;">drc</td>
<td style="text-align: left;">string</td>
<td>方向（正北，大于 0 且小于 90：东北，等于 90：正东，大于 90 且小于180：东南，等于 180：正南，大于180 且小于 270：西南，等于 270：正西，大于 270且小于等于 359：西北，其他：未知）<br>例：231</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">string</td>
<td>省<br>例：江苏省</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">string</td>
<td>市<br>例：镇江市</td>
</tr>
<tr>
<td style="text-align: left;">country</td>
<td style="text-align: left;">string</td>
<td>县<br>例：扬中市</td>
</tr>
<tr>
<td style="text-align: left;">mil</td>
<td style="text-align: left;">string</td>
<td>里程（单位：km（车机上报点自带里程））<br>例：0.0</td>
</tr>
<tr>
<td style="text-align: left;">offlineState</td>
<td style="text-align: left;">string</td>
<td>离线状态（true:离线， false:在线）<br>例：true</td>
</tr>
<tr>
<td style="text-align: left;">offlineTime</td>
<td style="text-align: left;">string</td>
<td>离线时长（单位：分钟）<br>例：5422</td>
</tr>
<tr>
<td style="text-align: left;">runDistance</td>
<td style="text-align: left;">string</td>
<td>车辆已行驶距离（单位：km）<br>例：724.0</td>
</tr>
<tr>
<td style="text-align: left;">remainDistance</td>
<td style="text-align: left;">string</td>
<td>剩余运距（单位：km）<br>例：54.1</td>
</tr>
<tr>
<td style="text-align: left;">estimateArriveTime</td>
<td style="text-align: left;">string</td>
<td>预计到达时间<br>例：1626067123000</td>
</tr>
</tbody>
</table>
<p><strong>返回参数others说明</strong> </p>
<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;">status</td>
<td style="text-align: left;">string</td>
<td>状态码（业务查询状态：详见附录 A）<br>例：1001</td>
</tr>
<tr>
<td style="text-align: left;">lon</td>
<td style="text-align: left;">number</td>
<td>车辆最后定位经度（格式：1/600000.0（WGS84 坐标系））<br>例：19356858</td>
</tr>
<tr>
<td style="text-align: left;">lat</td>
<td style="text-align: left;">number</td>
<td>车辆最后定位纬度（格式：1/600000.0（WGS84 坐标系））<br>例：71847300</td>
</tr>
<tr>
<td style="text-align: left;">adr</td>
<td style="text-align: left;">string</td>
<td>车辆地理位置名称 <br>例：江苏省镇江市扬中市</td>
</tr>
<tr>
<td style="text-align: left;">utc</td>
<td style="text-align: left;">string</td>
<td>车辆定位时间（时间戳）<br>例：1635497914000</td>
</tr>
<tr>
<td style="text-align: left;">spd</td>
<td style="text-align: left;">string</td>
<td>速度（单位 km/h）<br>例：39.1</td>
</tr>
<tr>
<td style="text-align: left;">drc</td>
<td style="text-align: left;">string</td>
<td>方向（正北，大于 0 且小于 90：东北，等于 90：正东，大于 90 且小于180：东南，等于 180：正南，大于180 且小于 270：西南，等于 270：正西，大于 270且小于等于 359：西北，其他：未知）<br>例：231</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">string</td>
<td>省<br>例：江苏省</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">string</td>
<td>市<br>例：镇江市</td>
</tr>
<tr>
<td style="text-align: left;">country</td>
<td style="text-align: left;">string</td>
<td>县<br>例：扬中市</td>
</tr>
<tr>
<td style="text-align: left;">mil</td>
<td style="text-align: left;">string</td>
<td>里程（单位：km（车机上报点自带里程））<br>例：0.0</td>
</tr>
</tbody>
</table>
<p><strong>出参示例</strong></p>
<pre><code>{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;data&quot;: {
&quot;firstVcl&quot;: {
&quot;vno&quot;: &quot;闽GA5266&quot;,
&quot;status&quot;: &quot;1001&quot;,
&quot;lon&quot;: 68454662,
&quot;lat&quot;: 14169529,
&quot;adr&quot;: &quot;广东省惠州市龙门县龙门土一点,西南方向,50.0米&quot;,
&quot;utc&quot;: &quot;1729056768000&quot;,
&quot;spd&quot;: &quot;0.0&quot;,
&quot;drc&quot;: &quot;310&quot;,
&quot;province&quot;: &quot;广东省&quot;,
&quot;city&quot;: &quot;惠州市&quot;,
&quot;country&quot;: &quot;龙门县&quot;,
&quot;mil&quot;: &quot;724766.0&quot;,
&quot;offlineState&quot;: &quot;false&quot;,
&quot;offlineTime&quot;: null,
&quot;runDistance&quot;: null,
&quot;remainDistance&quot;: null,
&quot;estimateArriveTime&quot;: null
},
&quot;others&quot;: null
}
}</code></pre>