API 文档

Appearance

船舶实时位置 ​

简要描述 ​

船舶历史轨迹查询

请求地址 ​

/v4/api/ship/operateHistory
参数名必选类型说明
Token是string应用令牌

请求参数 ​

参数名必选类型层级说明示例
mmsi是string1船舶mmsi249888000
startTime否long1开始时间，utc秒1752105600
endTime否long1结束时间，utc秒1752123600
  • 请求对象
java

@NotBlank(message = "mmsi不能为空")
@Schema(description = "船舶mmsi")
private String mmsi;

@NotNull(message = "开始时间不能为空")
@Schema(description = "开始时间，utc秒")
private Long startTime;

@NotNull(message = "结束时间不能为空")
@Schema(description = "结束时间，utc秒")
private Long endTime;

返回参数 ​

java

@Getter
@Setter
public class HistoryRes implements Serializable {

    @Schema(description = "定位时间（单位：utc秒）")
    private String posTime;

    @Schema(description = "经度（单位：1/10000分）")
    private String lon;

    @Schema(description = "纬度（单位：1/10000分）")
    private String lat;

    @Schema(description = "航向（单位：0.1度）")
    private String cog;

    @Schema(description = "航艏向（单位：度）")
    private String heading;

    @Schema(description = "航速（单位：0.1节）")
    private String sog;

    @Schema(description = "转向率（度/分钟）")
    private String rot;

    @Schema(description = "ais航行状态", example = "0 = 发动机使用中，1 = 锚泊，2 = 未操纵，3 = 有限适航性，4 = 受 船舶吃水限制，5 = 系泊，6 = 搁浅，7 = 从事捕捞，8 = 航行中， 9 =留做将来修正导航状态，10=留做将来修正导航状态， 11 = 机动船尾推作业（区域使用）， 12 = 机动船顶推或侧推作业（区域使用），\n" +
            "13 = 留做将来用， 14 = AIS-SART（现行的）、MOB-AIS、EPIRB-AIS ,15 = 未规定=默认值")
    private String aisNavStatus;

}

返回示例 ​

json
{
  "code": 200,
  "data": [
    {
      "aisNavStatus": null,
      "cog": "3181",
      "heading": "309",
      "lat": "1639537",
      "lon": "60750082",
      "posTime": "1752105606",
      "rot": null,
      "sog": "37"
    },
    {
      "aisNavStatus": null,
      "cog": "3112",
      "heading": "309",
      "lat": "1641012",
      "lon": "60748625",
      "posTime": "1752105795",
      "rot": null,
      "sog": "40"
    },
    {
      "aisNavStatus": null,
      "cog": "3112",
      "heading": "309",
      "lat": "1641012",
      "lon": "60748624",
      "posTime": "1752105797",
      "rot": null,
      "sog": "40"
    },
    {
      "aisNavStatus": null,
      "cog": "3270",
      "heading": "334",
      "lat": "1642834",
      "lon": "60746925",
      "posTime": "1752106006",
      "rot": null,
      "sog": "43"
    },
    {
      "aisNavStatus": null,
      "cog": "3270",
      "heading": "334",
      "lat": "1642834",
      "lon": "60746924",
      "posTime": "1752106007",
      "rot": null,
      "sog": "43"
    },
    {
      "aisNavStatus": null,
      "cog": "3447",
      "heading": "353",
      "lat": "1644913",
      "lon": "60746077",
      "posTime": "1752106187",
      "rot": null,
      "sog": "45"
    },
    {
      "aisNavStatus": null,
      "cog": "57",
      "heading": "6",
      "lat": "1647276",
      "lon": "60746008",
      "posTime": "1752106376",
      "rot": null,
      "sog": "44"
    },
    {
      "aisNavStatus": null,
      "cog": "61",
      "heading": "6",
      "lat": "1647403",
      "lon": "60746014",
      "posTime": "1752106389",
      "rot": null,
      "sog": "43"
    }
  ],
  "msg": "业务处理成功"
}