Jva项目中船舶的航行时间戳以及航速、航向等状态信息的api接口文档

在Java项目的API接口文档中，关于船舶的航行时间戳、航速和航向的状态信息通常会设计为以下几个部分：

**接口名称**: `ShipNavigationService` 或 `VesselStatusAPI`

// 使用注解如@GET, @Path等标明HTTP请求方式和路径
@Path("/ship/{shipId}")
public interface ShipNavigationAPI {

    // 获取单艘船的实时航行状态
    @GET
    @Produces(MediaType.APPLICATION_JSON)
    VesselStatus getRealTimeStatus(@PathParam("shipId") String shipId);

    // 格式化的时间戳返回
    @GET
    @Path("/timestamp")
    TimestampResponse getLastTimestamp(@PathParam("shipId") String shipId);

    // 更新历史数据接口
    @POST
    void updateHistoricalData(VesselStatusUpdateRequest request);
}

// 请求和响应模型示例
public class VesselStatus {
    private LocalDateTime timestamp;
    private double speedKnots;
    private double headingDegrees;
    // ...其他字段...
}

public class TimestampResponse {
    private LocalDateTime latestTimestamp;
    // 可能包含上一次更新的时间点
    private LocalDateTime lastUpdateTime;
}

public class VesselStatusUpdateRequest {
    private String shipId;
    private VesselStatus vesselStatus;
    // ...其他用于提交的状态数据...
}