12306火车时刻表查询接口

摘要

本文讲解12306网站接口查询火车时刻表信息
接口中用到的方法在文章最后

一、 根据车次查询内部火车编号

接口：https://search.12306.cn/search/v1/train/search
参数： keyword， date
请求类型： GET

/**
 * 根据车次名称查询列车编号
 * @param keyword 车次名
 * @param date 发车日期 (格式: yyyyMMdd)
 */
private List searchTrainInfos(String keyword, String date) {
    date = checkTrainSearchDate(date, "yyyyMMdd")
    String response = HttpUtils.sendGet("https://search.12306.cn/search/v1/train/search",
            "keyword=" + keyword.trim() + "&date=" + date);
    JSONObject object = new JSONObject(response);
    if (object.optBoolean("status")) {
        JSONArray data = object.optJSONArray("data");
        if (data != null) {
            return JSON.parseArray(data.toString(), TrainInfo.class);
        }
    }
    throw new RuntimeException("未查询到车次信息. " + object.optString("errorMsg"));
}

列车信息实体类 TrainInfo

import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;

import java.io.Serializable;

/**
 * 车次信息
 */
@Data
public class TrainInfo implements Serializable {
    private String date ;

    @JsonProperty(value = "from_station")
    private String fromStation ;

    @JsonProperty(value = "station_train_code")
    private String stationTrainCode ;

    @JsonProperty(value = "to_station")
    private String toStation ;

    @JsonProperty(value = "total_num")
    private String totalNum ;

    @JsonProperty(value = "train_no")
    private String trainNo ;
}

二、 根据列车编号查询时刻表信息

接口：https://kyfw.12306.cn/otn/queryTrainInfo/query
参数： trainNo， date
请求类型： GET

/**
 * 根据列车编号查询时刻表信息
 * @param trainNo 列车编号, 是上面接口返回数据中心的train_no
 * @param date 查询日期 (格式: yyyy-MM-dd)
 */
private List searchTrainStations(String trainNo, String date) {
    if (StringUtils.isBlank(trainNo)) {
        throw new RuntimeException("未查询到相关列车信息");
    }
    date = checkTrainSearchDate(date, "yyyy-MM-dd");
    String response = HttpUtils.sendGet("https://kyfw.12306.cn/otn/queryTrainInfo/query",
            "leftTicketDTO.train_no="+ trainNo +"&leftTicketDTO.train_date="+date +"&rand_code=");
    JSONObject object = new JSONObject(response);
    if (object.optBoolean("status")) {
        JSONObject jsonObject = object.optJSONObject("data");
        if (jsonObject != null) {
            JSONArray array = jsonObject.optJSONArray("data");
            if (array != null) {
                List list = JSON.parseArray(array.toString(), TrainStation.class);
                TrainStation station = list.get(0);
                list.forEach(i -> {
                    i.setStartStationName(station.getStartStationName());
                    i.setEndStationName(station.getEndStationName());
                    i.setTrainClassName(station.getTrainClassName());
                });
                return list;
            }
        }
    }
    throw new RuntimeException("未查询到相关列车信息. " + JSON.toJSONString(object.opt("messages")));
}

列车到站时刻详情

import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;

import java.io.Serializable;
import java.util.List;

/**
 * 列车到站时刻详情
 * @author xyang
 * @date 2021-08-02 9:15
 */
@Data
public class TrainStation implements Serializable {
    /** 车站名称 */
    @JsonProperty(value = "station_name")
    private String stationName;

    /** 列车类型 */
    @JsonProperty(value = "train_class_name")
    private String trainClassName;

    /** 是否起始站 (y/n)*/
    @JsonProperty(value = "is_start")
    private String isStart;

    @JsonProperty(value = "service_type")
    private String serviceType;

    /** 起始站点名称 */
    @JsonProperty(value = "start_station_name")
    private String startStationName;

    /** 终点站名称 */
    @JsonProperty(value = "end_station_name")
    private String endStationName;

    /** 发车时间 */
    @JsonProperty(value = "start_time")
    private String startTime;

    /** 到站时间 */
    @JsonProperty(value = "arrive_time")
    private String arriveTime;

    /** 车次编号 */
    @JsonProperty(value = "station_train_code")
    private String stationTrainCode;

    /** 到站顺序 */
    @JsonProperty(value = "station_no")
    private String stationNo;

    @JsonProperty(value = "wz_num")
    private String wzNum;

    /** 到站历时天数 (0:当天, 1:次日, 2:第三日, ....) */
    @JsonProperty(value = "arrive_day_diff")
    private Integer arriveDayDiff;

    /** 历时时长 */
    @JsonProperty(value = "running_time")
    private String runningTime;

    /** 历时 (当日到达, 次日到达...)*/
    @JsonProperty(value = "arrive_day_str")
    private String arriveDayStr;

    @JsonProperty(value = "OT")
    private List