# TrainTicketInquiry

第一个测试代码提交 ， python获取车票信息脚本~




# 火车票查询工具

这是一个用于查询12306火车票信息的Python工具，支持查询高铁、动车、普通列车等多种车型的余票信息。

## 功能特性

- 📅 查询指定日期、出发地和目的地的火车票信息
- 🚄 支持多种车型（高铁、动车、普通列车）
- 📊 以表格形式展示查询结果
- 💾 支持将查询结果导出为Excel文件
- 🔗 自动生成12306官方查询链接

## 依赖安装

```bash
pip install requests openpyxl prettytable
```

## 文件结构

```
.
├── run_spider.py           # 主程序文件
├── city_data.json          # 城市名称与代码映射文件
├── trainSearchQuery.json   # 查询参数配置文件（可选）
└── README.md              # 说明文档
```

## 使用方法

### 方法一：交互式查询

直接运行程序，按照提示输入信息：

```bash
python run_spider.py
```

程序会依次询问：
1. 出发日期（格式：YYYY-MM-DD）
2. 出发地（城市名称）
3. 目的地（城市名称）

### 方法二：配置文件查询

创建 `trainSearchQuery.json` 文件，格式如下：

```json
{
    "DepartureDate": "2024-12-31T00:00:00",
    "DepartureStation": "北京",
    "ArrivalStation": "哈尔滨"
}
```

程序会自动读取配置文件进行查询。

### 方法三：命令行参数查询

```bash
python run_spider.py "2024-12-31" "北京" "哈尔滨"
```

## 输出说明

程序运行后会显示：
1. **表格视图**：包含车次、时间、历时、座位信息等
2. **数据保存**：自动保存为Excel文件（`日期_出发地_目的地.xlsx`）
3. **直达链接**：生成的12306官方查询链接

## 表格字段说明

| 字段 | 说明 |
|------|------|
| 车次 | 列车编号（如G123、K456） |
| 出发时间 | 列车发车时间 |
| 到达时间 | 列车到达时间 |
| 历时 | 运行时长 |
| 商务座 | 商务座余票 |
| 一等座 | 一等座余票 |
| 二等座 | 二等座余票 |
| 软卧 | 软卧余票 |
| 硬卧 | 硬卧余票 |
| 硬座 | 硬座余票 |
| 无座 | 无座余票 |
| 备注 | 其他信息 |

## 注意事项

1. **城市名称**：需要确保输入的城市名称在 `city_data.json` 中存在
2. **日期格式**：必须为 `YYYY-MM-DD` 格式
3. **网络连接**：需要保持网络通畅以访问12306接口
4. **Cookie更新**：如遇到查询失败，可能需要更新程序中的Cookie信息

## 城市数据更新

如果需要更新城市列表，可以执行以下操作：
1. 删除或备份现有的 `city_data.json`
2. 取消代码中 `get_city_data()` 的注释并运行
3. 程序会自动获取最新的城市代码映射

## 示例

```
请输入出发日期(YYYY-MM-DD)：2024-12-31
请输入出发地：北京
请输入目的地：哈尔滨

+-------+----------+----------+-------+--------+--------+--------+--------+--------+--------+--------+--------+
| 车次  | 出发时间 | 到达时间 | 历时  | 商务座 | 一等座 | 二等座 | 软卧   | 硬卧   | 硬座   | 无座   | 备注   |
+-------+----------+----------+-------+--------+--------+--------+--------+--------+--------+--------+--------+
| G381  | 07:00    | 11:23    | 04:23 | --     | 有     | 有     | --     | --     | --     | --     | --     |
| K39   | 23:00    | 13:12    | 14:12 | --     | --     | --     | 有     | 有     | 有     | 有     | --     |
+-------+----------+----------+-------+--------+--------+--------+--------+--------+--------+--------+--------+

数据保存完成！
12306直达链接(复制到浏览器打开)：https://kyfw.12306.cn/otn/leftTicket/init?linktypeid=dc&fs=北京,BJP&ts=哈尔滨,HBB&date=2024-12-31&flag=N,N,Y
```

## 许可证

本项目仅供学习和研究使用，请勿用于商业用途。查询数据来自12306官方网站。