package com.evobms.project.vehicledata.service;

import java.util.Date;
import java.util.List;
import com.evobms.project.vehicledata.domain.VehicleLocation;

/**
 * 车辆位置数据Service接口
 *
 * @author ruoyi
 * @date 2025-11-15
 */
public interface IVehicleLocationService
{
    /**
     * 查询车辆位置数据
     *
     * @param id 车辆位置数据主键
     * @return 车辆位置数据
     */
    public VehicleLocation selectVehicleLocationById(Long id);

    /**
     * 查询车辆位置数据列表
     *
     * @param vehicleLocation 车辆位置数据
     * @return 车辆位置数据集合
     */
    public List<VehicleLocation> selectVehicleLocationList(VehicleLocation vehicleLocation);

    /**
     * 新增车辆位置数据
     *
     * @param vehicleLocation 车辆位置数据
     * @return 结果
     */
    public int insertVehicleLocation(VehicleLocation vehicleLocation);

    /**
     * 修改车辆位置数据
     *
     * @param vehicleLocation 车辆位置数据
     * @return 结果
     */
    public int updateVehicleLocation(VehicleLocation vehicleLocation);

    /**
     * 批量删除车辆位置数据
     *
     * @param ids 需要删除的车辆位置数据主键集合
     * @return 结果
     */
    public int deleteVehicleLocationByIds(Long[] ids);

    /**
     * 删除车辆位置数据信息
     *
     * @param id 车辆位置数据主键
     * @return 结果
     */
    public int deleteVehicleLocationById(Long id);

    VehicleLocation selectLatestByDeviceId(String deviceId);
    /**
     * 删除车辆位置数据信息
     * 位置轨迹：按时间范围返回位置列表，start/end 为毫秒时间戳，可选 limit 限制条数
     * @param deviceId
     * @return 结果
     */
    List<VehicleLocation> selectByDeviceAndRange(String deviceId, Date start, Date end, Integer limit);
}
