这是一款用于在铁道部12306官网爬取车票等信息的node.js应用。
An app to query Tickects and other information from 12306 website by node.js
演示地址(Demo Url):http://tickets.onelib.biz/
master分支为最新功能,所有功能都会最终同步到这里。
element分支为所有功能的原型
- 如果直接使用模块
TrainTickects
,则不需要任何依赖,直接引用此模块即可。建议切换到element
分支,这个是核心部分。
Require TrainTickects
directly if you just want to use TrainTickects
module. It's recommended to use branch element
, which is core part of all.
- 如果你要查看网页Demo,则需要安装,直接执行
npm install
即可。
Execute npm install
to install modules needed automaticly if you want to check website demo.
element
分支的主要文件结构如下:
Main Structure of branch element
:
root
|---TrainTickects.js // TrainTickects Module
|---test.js // Debug file, you can use this file to test
// each function in TrainTickects module
|---package.json // Dependences
|---cert
|---srca_der.cer // Certification
首次提交于 2017/07/20,制作了 TrainTickects
模块,实现了三个简单功能:
- 查询火车票
- 查询中途停靠站列表
- 收集所有火车站数据
2017/07/20 18:38 实现网页版小工具
- 可以输入中文站名、日期,从而查询火车
- 点击结果列表还可以查看本次列车的途经站点信息
2017/07/21 14:00 完善网页版功能
- 输入出发地、目的地时,出现下来选项,不必输入完整的名称;拼音(大小写均可)和中文均支持
- 到达时间与出发时间不在同一天时,会给出提示,“+1”、“+2”或更多
- 新增过滤功能:过滤车次、站名
请求方式为: Request:
https
Host:
kyfw.12306.cn/
查询前缀为: Query Prefix:
/otn/
已知的几个接口有:
Known interfaces as follows:
Interface | name | rule | Demo |
---|---|---|---|
leftTicket/query | 查询符合条件的车票 Query tickets that satisfy query conditions |
leftTicketDTO.train_date=<date> &leftTicketDTO.from_station= <from_station> &leftTicketDTO.to_station= <to_station> &purpose_codes=ADULT |
leftTicketDTO.train_date=2017-07-21 &leftTicketDTO.from_station= SZQ &leftTicketDTO.to_station= XMS &purpose_codes=ADULT |
czxx/queryByTrainNo | 查询某车次的途经站及时间 Query the stations&time of a train passing by |
train_no=<train_no> &from_station_telecode= <from_station_telecode> &to_station_telecode= <to_station_telecode> &depart_date= <depart_date> |
train_no=6i000D40920A &from_station_telecode= SZQ &to_station_telecode= XMS &depart_date= 2017-07-21 |
resources/js/framework/station_name.js | 获取所有火车站数据 Collection all stations data |
station_version=<version> |
station_version=1.8964 |
查询符合条件的车次、各类车票的剩余数量。
此接口为 TrainTickects
模块提供的接口,需要传入两个参数:config
和 callback
。
其中 config
为对象,其属性包括:
date
: String, 日期, 格式"yyyy-mm-dd"from_station
: String, 始发站车站代码,如"SZQ"end_station
: String, 终到站车站代码,如"XMS"print
: boolean, 是否后台打印
callback
为回调函数,允许为空。
下面为一个简单的测试例子:
var OL_TrainTickects = require('./TrainTickects');
// 测试查询火车票
var Config = {
date : '2017-07-24', // 日期, 格式"yyyy-mm-dd"
from_station : 'SZQ', // 始发站车站代码,这里是深圳
end_station : 'XMS', // 终到站车站代码,这里是厦门
print : true, // 打印查询结果
};
OL_TrainTickects.QueryTickects(Config, function(err, tickects) {
// console.log(tickects)
});
用于查询某车次的停靠站点及到站、发车和停靠时间。
此接口为 TrainTickects
模块提供的接口,需要传入两个参数:config
和 callback
。
其中 config
为对象,其属性包括:
train_no
: String, 列车编号, 如"6i000D40920A"from_station
: String, 始发站车站代码,如"SZQ"end_station
: String, 终到站车站代码,如"XMS"date
: String, 日期, 格式"yyyy-mm-dd"print
: boolean, 是否后台打印
callback
为回调函数,允许为空。
下面为一个简单的测试例子:
var OL_TrainTickects = require('./TrainTickects');
// 测试查询中途停靠站列表
var Config = {
train_no : '6i000D40920A', // 列车编号
from_station : 'SZQ', // 始发站车站代码
end_station : 'XMS', // 终到站车站代码
date : '2017-07-24', // 日期, 格式"yyyy-mm-dd"
print : true, // 是否打印
};
OL_TrainTickects.QueryStations(Config, function(err, sList) {
// console.log(sList)
});
执行效果:
手机全国所有火车站的数据。
此接口为 TrainTickects
模块提供的接口,只需要传入回调函数callback
即可,允许为空。
下面为一个简单的测试例子:
var OL_TrainTickects = require('./TrainTickects');
// 测试收集所有火车站数据
OL_TrainTickects.CollectStations(function(err, data) {
var fs = require('fs');
// 写入js文件
var dir = "./js/"
if(!fs.existsSync(dir)) {
fs.mkdirSync(dir);
}
fs.writeFile(dir+'stations_py.js', "var StationData = "+JSON.stringify(data));
})
执行效果:
查询火车票价格。
此接口为 TrainTickects
模块提供的接口,需要传入两个参数:config
和 callback
。
其中 config
为对象,其属性包括:
train_no
: String, 列车编号, 如"650000Z23001"from_station_no
: String, 出发地车序,如"01"to_station_no
: String, 目的地车序,如"23"seat_types
: String, 如"113"train_date
: String, 乘车日期,如"2017-07-23"print
: boolean, 是否后台打印
callback
为回调函数,允许为空。
下面为一个简单的测试例子:
// 测试查询票价
var Config = {
train_no : '650000Z23001', // 列车编号
from_station_no : '01', // 出发地车序
to_station_no : '23', // 目的地车序
seat_types : '113', // 如"113"
train_date : '2017-07-23', // 日期, 格式"yyyy-mm-dd"
};
OL_TrainTickects.QueryPrice(Config, function(err, tickects) {
console.log(tickects)
});
从12306获取到的原始数据结构如下:
{
validateMessagesShowId: '_validatorMessage',
status: true,
httpstatus: 200,
data:
{
result: [ '3ec5X9fRSYq5hiOeUulIj%2F6TbXHRQBiBhbLIFmE0GQj8rPSTYtSYZl6KDzSfChayvwsPRbgom0Fc%0Afi61kzfkhRhOqB6nkxQCUwijG2opA6FpNXyvejLtqlVrbqTiTVZMukqyucS5ldEcSsttYhaiTEdq%0ADS3WuQw4FUd8LazFoDT5eVXtAfyaNuuMtD9VR5dJKNAyMMBDI8T%2FeCJu0pPMIpxF%2FY%2FkWAK%2FANmK%0AqEKHximPszTr|预订|6i000D40920A|D4092|IOQ|XKS|IOQ|XKS|06:40|10:16|03:36|Y|yx1mCzhcHlabqde2UZwX9Y8XCtPt2nDYQaY%2BBGBmT33wpoaD|20170724|3|Q6|01|07|1|0|||||||有||||有|有|||O0M0O0|OMO',
...
],
flag: '1',
map: { XMS: '厦门', IOQ: '深圳北', XKS: '厦门北' },
messages: [],
validateMessages: {}
}
对我们来说,有意义的数据只要两个:data.result
和 map
。
其中,data.result
是一个数组,数组的每一个元素都代表一个符合条件的车次,包含了车次、起止站、各坐席票数等信息。
map
是一个对象,属性名为火车站的代码,属性值为该代码对应的中文站名。
map
的作用在于,当我们查询 深圳
到 厦门
的火车票时,可能出现 深圳北
、厦门北
这样的车站,它们和 深圳
到 厦门
不同,需要做好对应关系。
关于如何使用这个映射关系,在5.3节会做介绍。
从12306获取到的每一个车次的余票信息的原始数据如下:
可以看出,这些数据是以 |
为分割的,因此可以通过 split()
函数来切分原始数据:
arr = raw_data.split("|");
// Result
[
/* 0 */ 'uR7MTk54pjLluluefRzSndjJsuDNdhtgJK6caO246PF7XGyVDML5aJ6EgQZRE7yXyONObC8q4E5c%0ASfuGXEljez5PZuzJlFASnSuluBeLTzL06LR18feZ3AtLCG%2FjqeqBks3tpY168pxxeGdkPOr0rakC%0AhJ6gEXT%2Bbo0OSKVXn9fWm3pXsU16O9tZBcbD4LGLtUlynzNxM%2FB%2BN0rRNodacPi3VHx5wMIpgeaH%0AIF%2FkfW2ySCl1',
/* 1 */ '预订',
/* 2 */ '6i000D40920A',
/* 3 */ 'D4092',
/* 4 */ 'IOQ',
/* 5 */ 'XKS',
/* 6 */ 'IOQ',
/* 7 */ 'XKS',
/* 8 */ '06:40',
/* 9 */ '10:16',
/* 10 */ '03:36',
/* 11 */ 'Y',
/* 12 */ 'VYa0L6Eo5FxIlzIT86a%2BZ1aAkg1iGV%2FwY8DzVKRX2iKk0iN%2B',
/* 13 */ '20170724',
/* 14 */ '3',
/* 15 */ 'Q6',
/* 16 */ '01',
/* 17 */ '07',
/* 18 */ '1',
/* 19 */ '0',
/* 20 */ '',
/* 21 */ '',
/* 22 */ '',
/* 23 */ '',
/* 24 */ '',
/* 25 */ '',
/* 26 */ '有',
/* 27 */ '',
/* 28 */ '',
/* 29 */ '',
/* 30 */ '有',
/* 31 */ '有',
/* 32 */ '',
/* 33 */ '',
/* 34 */ 'O0M0O0',
/* 35 */ 'OMO' ]
可以看出,每个元素都严格对应一个数据;但是由于缺少文档,我不清楚每个位置代表什么意思。
不过,根据我们已知的情况, arr[3]
肯定是车次, arr[8]
肯定是发车时间, arr[9]
肯定是到达时间, arr[10]
肯定是总时间, arr[13]
肯定是乘车日期。
另外,根据后来做 OL_TrainTickects.QueryStations()
的时候分析其接口时可以知道:arr[2]
肯定是列车编号, 这个编号可以用在后面查询某车次中途停靠站信息中。
因此源代码中,是这样处理的:
...
tickect.train_no = temp[2]; // 火车编号
tickect.tId = temp[3]; // Train ID
tickect.sTime = temp[8]; // Start Time
tickect.eTime = temp[9]; // End Time
tickect.tTime = temp[10]; // Total Time
tickect.date = temp[13];
...
那么,剩余的一些字段该如何解读呢?
首先,我们看到了一些位置出现了 有
这个数值,但这并不足以让我们知道这些位置代表什么数据;我们看下面图中,一等座、二等座和无座三类席位都是 有
,我们仅仅能知道第26
30
31
个位置代表一等座、二等座和无座,并且顺序也不清楚。
这里提供一种比较笨的方法:大量查找不同起止站的列车,推理出各类坐席剩余票数在原始数据中的位置。
举个例子,我们在12306官网中查询一下深圳
-郑州
的列车:
可以知道商务座、一二等座的票数分别为 16
12
和 有
。那么我们同时查看余票的原始数据:
[ '9IQVfT3yCLkzmM1ZghLmyzwq%2Fn4vNliAfmnnwzZ01FtloWX5j1WC%2B2eLlKI7MhrbrUUwKKRc9zh7%0APzQNPa6qbZxP0F
9Sm4zin2w4d8sWSsB6ZlL8anu7LciQyVlV6XPMZqEMgcRW5T6tcH2MOmxuLsxH%0AE5L%2BJd8FmD029yCje%2F%2Bwir7yHyLyA
M7oElbTsa2c5C%2BfouxQU1V6lb1bcL%2FueyAUsI1qd0OObjT2%0Afg%3D%3D',
'预订',
'6i00000G7210',
'G72',
'NZQ',
'BXP',
'NZQ',
'ZAF',
'07:43',
'14:56',
'07:13',
'Y',
'UM2Ja13aKKsc6qxZtVDIqImzPYBW8yoFun0JxcFfLjb8BFPl',
'20170724',
'3',
'Q6',
'01',
'10',
'0',
'0',
'',
'',
'',
'',
'',
'',
'',
'',
'',
'',
/* 30 */ '有',
/* 31 */ '12',
/* 32 */ '16',
'',
'O0M090',
'OM9' ]
这样,很明显arr[30]
代表的是二等座,arr[31]
代表的是一等座,arr[32]
商务座。
用同样的方式,再查找其他车次的车票数,只要不全是相同的值,我们就能够通过对比这两个信息得到各个位置代表什么坐席。
根据多次尝试,得到以下结果(2017.07.20):
tickect.ruanwo = temp[23]; // 软卧
tickect.ruanzuo = temp[24]; // 软座
tickect.wuzuo = temp[26]; // 无座
tickect.yingwo = temp[28]; // 硬卧
tickect.yingzuo = temp[29]; // 硬座
tickect.scSeat = temp[30]; // 二等座
tickect.fcSeat = temp[31]; // 一等座
tickect.bcSeat = temp[32]; // 商务座 / 特等座
tickect.dongwo = temp[33]; // 动卧
5.1中的余票数据中,有四个站点代码:
/* 4 */ 'IOQ',
/* 5 */ 'XKS',
/* 6 */ 'IOQ',
/* 7 */ 'XKS',
发现4和6、5和7是一样的代码。原因很简单,因为我们出发的火车站就是始发站、到达的火车站就是终点站。
那么到底前两个是始发站/终点站,还是后两个是?我们可以在12306官网找一个例子:深圳
-梅州
的列车只有一趟,很好分析:
所以我们可以更改一下查询条件:惠州
-兴宁
,结果为:
// {HCQ: "惠州", ENQ: "兴宁"}
/* 4 */ 'SZQ',
/* 5 */ 'MOQ',
/* 6 */ 'HCQ',
/* 7 */ 'ENQ',
因此可以确定,5
和6
为此列车的始发站和终点站,6
和7
为实际的出发站和到达站。
由此,我们也可以根据map
信息来得到火车站代码对应的中文名:
/*
* 根据车站code转换为中文名称
*/
function TMapStations(code, map) {
if(map) {
var name = map[code];
if(name) {
return name
}
}
return code;
}
...
// 解析余票信息部分代码
tickect.fSation = TMapStations(temp[6], map); // From Station Name
tickect.tSation = TMapStations(temp[7], map); // To Station Name
...
感谢 落花落雨不落叶 的博文提供的帮助!