船舶历史轨迹查询（最大支持90天）
<p><strong>简要描述：</strong> </p>
<ul>
<li>船舶历史轨迹查询（最大支持90天）</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/ship/queryLocus</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;">id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>船舶在船讯网中的唯一识别码</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">btm</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>轨迹开始时间</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">etm</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>轨迹结束时间</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">cut</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>数据类型 0 不截断 1 可截断（如果轨迹数据量很大，不截断会造成长时间等待） (^[01]$) (数据类型(0:不截断 1:可截断))</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">tp</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>轨迹类型：0:普通,1:大数据抽稀,2:大数据完整，默认 0 （^[012]$）（轨迹类型(0:普通 1:大数据抽稀 2:大数据完整)）</td>
<td>-</td>
</tr>
<tr>
<td style="text-align: left;">sampleCount</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">number</td>
<td>抽样条数 (如果为空，则返回该时间段的所有数据，不为空，则显示对应的数量(包含第一个与最后一个位置，剩余的平均分割))</td>
<td>-</td>
</tr>
</tbody>
</table>
<p><strong>入参示例</strong></p>
<pre><code>{
&quot;id&quot;: &quot;string&quot;,
&quot;btm&quot;: &quot;string&quot;,
&quot;etm&quot;: &quot;string&quot;,
&quot;cut&quot;: &quot;string&quot;,
&quot;tp&quot;: &quot;string&quot;,
&quot;sampleCount&quot;: 0
}</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;">trackResDomain</td>
<td style="text-align: left;">object</td>
<td>轨迹公共返回类</td>
</tr>
<tr>
<td style="text-align: left;">dataType</td>
<td style="text-align: left;">number</td>
<td>dataType</td>
</tr>
<tr>
<td style="text-align: left;">utc</td>
<td style="text-align: left;">number</td>
<td>时间点(时间戳)</td>
</tr>
<tr>
<td style="text-align: left;">lon</td>
<td style="text-align: left;">number</td>
<td>经度,1/1000000 度</td>
</tr>
<tr>
<td style="text-align: left;">lat</td>
<td style="text-align: left;">number</td>
<td>纬度,1/1000000 度</td>
</tr>
<tr>
<td style="text-align: left;">sog</td>
<td style="text-align: left;">number</td>
<td>航速，毫米/秒</td>
</tr>
<tr>
<td style="text-align: left;">cog</td>
<td style="text-align: left;">number</td>
<td>航迹向，1/100 度</td>
</tr>
</tbody>
</table>
<p><strong>返回参数trackResDomain说明</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;">lon</td>
<td style="text-align: left;">number</td>
<td>经度</td>
</tr>
<tr>
<td style="text-align: left;">lat</td>
<td style="text-align: left;">number</td>
<td>纬度</td>
</tr>
<tr>
<td style="text-align: left;">locationTime</td>
<td style="text-align: left;">string</td>
<td>定位时间</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">string</td>
<td>车辆地理位置名称（模糊）</td>
</tr>
<tr>
<td style="text-align: left;">speed</td>
<td style="text-align: left;">number</td>
<td>速度</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">string</td>
<td>描述</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">string</td>
<td>省</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">string</td>
<td>市</td>
</tr>
<tr>
<td style="text-align: left;">country</td>
<td style="text-align: left;">string</td>
<td>县/区</td>
</tr>
</tbody>
</table>
<p><strong>出参示例</strong></p>
<pre><code>{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;操作成功&quot;,
&quot;data&quot;: [
{
&quot;trackResDomain&quot;: {
&quot;lon&quot;: 0,
&quot;lat&quot;: 0,
&quot;locationTime&quot;: &quot;string&quot;,
&quot;address&quot;: &quot;string&quot;,
&quot;speed&quot;: 0,
&quot;description&quot;: &quot;string&quot;,
&quot;province&quot;: &quot;string&quot;,
&quot;city&quot;: &quot;string&quot;,
&quot;country&quot;: &quot;string&quot;
},
&quot;dataType&quot;: 0,
&quot;utc&quot;: 0,
&quot;lat&quot;: 0,
&quot;lon&quot;: 0,
&quot;sog&quot;: 0,
&quot;cog&quot;: 0
}
]
}</code></pre>