package com.ruoyi.gps.service;

import com.ruoyi.gps.domain.CmsGpsLoginResponse;
import com.ruoyi.gps.domain.CmsVehicleDeviceResponse;
import com.ruoyi.gps.domain.CmsVehicleDeviceListResponse;
import com.ruoyi.gps.domain.CmsVehicleLocationResponse;
import com.ruoyi.gps.domain.CmsTrackDetailResponse;

/**
 * CMS GPS采集服务接口
 */
public interface ICmsGpsCollectService {
    /**
     * 登录CMS系统
     *
     * @param username 用户名
     * @param password 密码
     * @return 登录响应
     */
    CmsGpsLoginResponse login(String username, String password);

    /**
     * 查询车辆设备信息
     *
     * @return 车辆设备响应
     */
    CmsVehicleDeviceResponse queryVehicleDevices();

    /**
     * 获取车辆设备列表
     *
     * @param vehicleId 车牌号，多个以逗号分隔
     * @return 车辆设备列表响应
     */
    CmsVehicleDeviceListResponse getDeviceByVehicle(String vehicleId);

    /**
     * 获取车辆最新位置信息
     *
     * @param vehicleId 车牌号，多个以逗号分隔
     * @param toMap 地图经纬度转换（1：谷歌地图，2：百度地图）
     * @param geoAddress 是否解析地理位置（1：是）
     * @param currentPage 当前页码
     * @param pageRecords 每页记录数
     * @return 车辆位置信息响应
     */
    CmsVehicleLocationResponse getVehicleLocation(String vehicleId, Integer toMap, Integer geoAddress, Integer currentPage, Integer pageRecords);

    /**
     * 获取设备历史轨迹
     *
     * @param devIdno 设备号
     * @param begintime 开始时间（格式：yyyy-MM-dd HH:mm:ss）
     * @param endtime 结束时间（格式：yyyy-MM-dd HH:mm:ss）
     * @param distance 距离（单位：KM，可选）
     * @param parkTime 停车时长（单位：秒，可选）
     * @param geoaddress 是否解析地理位置（1：是，可选）
     * @param currentPage 当前查询页码（可选）
     * @param pageRecords 每页条数（可选）
     * @param toMap 地图经纬度转换（1：谷歌地图，2：百度地图，可选）
     * @return 历史轨迹响应
     */
    CmsTrackDetailResponse queryTrackDetail(String devIdno, String begintime, String endtime,
            Double distance, Integer parkTime, Integer geoaddress, Integer currentPage,
            Integer pageRecords, Integer toMap);
}