今天发现一个可以提供火车票时刻表查询的WebService,先记录下来以后如果写一个火车票时刻表查询的Android App的话就用的着。首先该WebService的的名字是TrainTimeWebService,地址是:http://webservice.webxml.com.cn/WebServices/TrainTimeWebService.asmx。
当然关于WebService的相关知识可以查看本人的另外文章:
- 我的Android进阶之旅------>Android通过调用Webservice实现天气预报(地址:http://blog.csdn.net/ouyang_peng/article/details/8868708)
- 我的Android进阶之旅------>WebService的读书笔记(地址:http://blog.csdn.net/ouyang_peng/article/details/8868690)
下面就来介绍火车时刻表查询的几个接口:
getStationNameDataSet :
1、作用:获得本火车时刻表Web Services支持的全部站台名称和拼音缩写 DataSet
2、说明:输入参数:无;返回数据:结构为 站台名称、拼音缩写,按拼音缩写升序排列3、实例:调用该接口后返回的XML数据,部分代码如下所示,有些站点没有拼音缩写:
<StationName diffgr:id="StationName1985" msdata:rowOrder="1984"> <station_name>深圳</station_name> <station_shortcode>SZ</station_shortcode> </StationName> <StationName diffgr:id="StationName2001" msdata:rowOrder="2000"> <station_name>深圳西</station_name> <station_shortcode>SZX</station_shortcode> </StationName> <StationName diffgr:id="StationName86" msdata:rowOrder="85"> <station_name>深圳北</station_name> <station_shortcode/> </StationName> <StationName diffgr:id="StationName87" msdata:rowOrder="86"> <station_name>深圳东</station_name> <station_shortcode/> </StationName>
getStationName :
1、作用:获得本火车时刻表Web Services支持的全部站台名称2、说明:输入参数:无,输出参数 String()3、实例:调用该接口后返回的XML数据,部分代码如下所示:
<ArrayOfString xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://WebXml.com.cn/"> <string>深圳</string> <string>深圳北</string> <string>深圳东</string> <string>深圳西</string> </ArrayOfString>
getStationAndTimeDataSetByTrainCode :
1、作用:通过火车车次查询本火车时刻表
DataSet
2、说明:输入参数:车次代号字符串,空字符串默认上海到北京D32次,UserID = 商业用户ID(普通用户不需要);返回数据:DataSet,Item.(TrainCode)=车次、Item.(FirstStation)=始发站、Item.(LastStation)=终点站、Item.(StartStation)=发车站、Item.(StartTime)=发车时间、Item.(ArriveStation)=到达站、Item.(ArriveTime)=到达时间、Item.(KM)=里程(KM)、Item.(UseDate)=历时3、实例:如图我们输入车次D7001再调用该接口后,
返回的XML数据部分代码如下所示:
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"> <getStationAndTime xmlns=""> <TimeTable diffgr:id="TimeTable1" msdata:rowOrder="0" diffgr:hasChanges="inserted"> <TrainCode>D7001</TrainCode> <FirstStation>广州</FirstStation> <LastStation>深圳</LastStation> <StartStation>广州</StartStation> <StartTime>06:03:00</StartTime> <ArriveStation>深圳</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>147</KM> <UseDate>1:31</UseDate> </TimeTable> </getStationAndTime> </diffgr:diffgram>
getStationAndTimeDataSetByTrainCode :
1、作用:通过火车车次查询本火车时刻表(支持模糊查询)
DataSet
2、说明:输入参数:车次代号字符串(支持模糊查询),空字符串默认上海到北京D32次,UserID = 商业用户ID(普通用户不需要);
返回数据:DataSet,Item.(TrainCode)=车次、Item.(FirstStation)=始发站、Item.(LastStation)=终点站、
Item.(StartStation)=发车站、Item.(StartTime)=发车时间、Item.(ArriveStation)=到达站、Item.(ArriveTime)=到达时间、
Item.(KM)=里程(KM)、Item.(UseDate)=历时
3、实例:如图我们输入车次D700,再调用该接口进行模糊查询后,
返回的XML数据部分代码如下所示:
<getStationAndTime xmlns=""> <TimeTable diffgr:id="TimeTable1" msdata:rowOrder="0" diffgr:hasChanges="inserted"> <TrainCode>D7001</TrainCode> <FirstStation>广州</FirstStation> <LastStation>深圳</LastStation> <StartStation>广州</StartStation> <StartTime>06:03:00</StartTime> <ArriveStation>深圳</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>147</KM> <UseDate>1:31</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable2" msdata:rowOrder="1" diffgr:hasChanges="inserted"> <TrainCode>D7002</TrainCode> <FirstStation>深圳</FirstStation> <LastStation>广州</LastStation> <StartStation>深圳</StartStation> <StartTime>07:46:00</StartTime> <ArriveStation>广州</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>147</KM> <UseDate>1:34</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable3" msdata:rowOrder="2" diffgr:hasChanges="inserted"> <TrainCode>D7003</TrainCode> <FirstStation>广州</FirstStation> <LastStation>深圳</LastStation> <StartStation>广州</StartStation> <StartTime>09:32:00</StartTime> <ArriveStation>深圳</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>147</KM> <UseDate>1:35</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable4" msdata:rowOrder="3" diffgr:hasChanges="inserted"> <TrainCode>D7004</TrainCode> <FirstStation>深圳</FirstStation> <LastStation>广州东</LastStation> <StartStation>深圳</StartStation> <StartTime>11:20:00</StartTime> <ArriveStation>广州东</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>139</KM> <UseDate>1:19</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable5" msdata:rowOrder="4" diffgr:hasChanges="inserted"> <TrainCode>D7005</TrainCode> <FirstStation>广州东</FirstStation> <LastStation>深圳</LastStation> <StartStation>广州东</StartStation> <StartTime>12:54:00</StartTime> <ArriveStation>深圳</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>139</KM> <UseDate>1:19</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable6" msdata:rowOrder="5" diffgr:hasChanges="inserted"> <TrainCode>D7006</TrainCode> <FirstStation>深圳</FirstStation> <LastStation>广州东</LastStation> <StartStation>深圳</StartStation> <StartTime>14:25:00</StartTime> <ArriveStation>广州东</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>139</KM> <UseDate>1:19</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable7" msdata:rowOrder="6" diffgr:hasChanges="inserted"> <TrainCode>D7007</TrainCode> <FirstStation>广州东</FirstStation> <LastStation>深圳</LastStation> <StartStation>广州东</StartStation> <StartTime>15:56:00</StartTime> <ArriveStation>深圳</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>139</KM> <UseDate>1:19</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable8" msdata:rowOrder="7" diffgr:hasChanges="inserted"> <TrainCode>D7008</TrainCode> <FirstStation>深圳</FirstStation> <LastStation>广州东</LastStation> <StartStation>深圳</StartStation> <StartTime>17:27:00</StartTime> <ArriveStation>广州东</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>139</KM> <UseDate>1:19</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable9" msdata:rowOrder="8" diffgr:hasChanges="inserted"> <TrainCode>D7009</TrainCode> <FirstStation>广州东</FirstStation> <LastStation>深圳</LastStation> <StartStation>广州东</StartStation> <StartTime>18:58:00</StartTime> <ArriveStation>深圳</ArriveStation> <ArriveTime>07:34:00</ArriveTime> <KM>139</KM> <UseDate>1:19</UseDate> </TimeTable> </getStationAndTime>
getStationAndTimeByTrainCode :
1、作用:通过火车车次查询火车时刻表 String()
2、说明:输入参数:车次代号字符串,空字符串默认上海到北京D32次,UserID = 商业用户ID(普通用户不需要);
返回数据:一个一维字符串数组 String(9),String(0)=车次、String(1)=始发站、String(2)=终点站、
String(3)=发车站、String(4)=发车时间、String(5)=到达站、String(6)=到达时间、String(7)=里程(KM)、
String(8)=历时、String(9)=空字符串(备用)
3、实例:如图我们输入车次D7001,再调用该接口进行模糊查询后,
返回的XML数据部分代码如下所示:
<ArrayOfString xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://WebXml.com.cn/"> <string>D7001</string> <string>广州</string> <string>深圳</string> <string>广州</string> <string>06:03:00</string> <string>深圳</string> <string>07:34:00</string> <string>147</string> <string>1:31</string> <string/> </ArrayOfString>
getStationAndTimeByStationName:
1、作用:通过发车站和到达站查询火车时刻表 DataSet
2、说明:输入参数:StartStation = 发车站,ArriveStation = 到达站(支持第一个字匹配模糊查询),空字符串默认发车站上海
和到达站北京,UserID = 商业用户ID(普通用户不需要);
返回数据:DataSet,Item.(TrainCode)=车次、Item.(FirstStation)=始发站、Item.(LastStation)=终点站、
Item.(StartStation)=发车站、Item.(StartTime)=发车时间、Item.(ArriveStation)=到达站、
Item.(ArriveTime)=到达时间、Item.(KM)=里程(KM)、Item.(UseDate)=历时
3、实例:如图我们输入发车站:深圳、到达站:广州,再调用该接口进行模糊查询后,
返回的XML数据部分代码如下所示:
<getStationAndTime xmlns=""> <TimeTable diffgr:id="TimeTable1" msdata:rowOrder="0" diffgr:hasChanges="inserted"> <TrainCode>D7002</TrainCode> <FirstStation>深圳</FirstStation> <LastStation>广州</LastStation> <StartStation>深圳</StartStation> <StartTime>07:46:00</StartTime> <ArriveStation>广州东</ArriveStation> <ArriveTime>09:05:00</ArriveTime> <KM>139</KM> <UseDate>01:19</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable2" msdata:rowOrder="1" diffgr:hasChanges="inserted"> <TrainCode>D7002</TrainCode> <FirstStation>深圳</FirstStation> <LastStation>广州</LastStation> <StartStation>深圳</StartStation> <StartTime>07:46:00</StartTime> <ArriveStation>广州</ArriveStation> <ArriveTime>09:20:00</ArriveTime> <KM>147</KM> <UseDate>01:34</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable137" msdata:rowOrder="136" diffgr:hasChanges="inserted"> <TrainCode>K9060\K9061</TrainCode> <FirstStation>深圳西</FirstStation> <LastStation>怀化</LastStation> <StartStation>深圳西</StartStation> <StartTime>19:08:00</StartTime> <ArriveStation>广州</ArriveStation> <ArriveTime>21:18:00</ArriveTime> <KM>162</KM> <UseDate>02:10</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable138" msdata:rowOrder="137" diffgr:hasChanges="inserted"> <TrainCode>K9064\K9065</TrainCode> <FirstStation>深圳西</FirstStation> <LastStation>铜仁</LastStation> <StartStation>深圳西</StartStation> <StartTime>11:20:00</StartTime> <ArriveStation>广州</ArriveStation> <ArriveTime>13:50:00</ArriveTime> <KM>162</KM> <UseDate>02:30</UseDate> </TimeTable> <TimeTable diffgr:id="TimeTable139" msdata:rowOrder="138" diffgr:hasChanges="inserted"> <TrainCode>K9076</TrainCode> <FirstStation>深圳东</FirstStation> <LastStation>常德</LastStation> <StartStation>深圳东</StartStation> <StartTime>19:05:00</StartTime> <ArriveStation>广州</ArriveStation> <ArriveTime>21:24:00</ArriveTime> <KM>139</KM> <UseDate>02:19</UseDate> </TimeTable> </getStationAndTime>
getDetailInfoByTrainCode :
1、作用:通过火车车次查询列车经由车站明细 DataSet
2、说明:输入参数:车次代号字符串,空字符串默认上海到北京D32次,UserID = 商业用户ID(普通用户不需要);
返回数据:DataSet,Item.(TrainStation)=车站名称、Item.(ArriveTime)=到站时间、
Item.(StartTime)=发车时间、Item.(KM)=里程(KM)
3、实例:如图我们输入发车站:深圳、到达站:广州,再调用该接口进行模糊查询后,
返回的XML数据部分代码如下所示:
<getDetailInfo xmlns=""> <TrainDetailInfo diffgr:id="TrainDetailInfo1" msdata:rowOrder="0" diffgr:hasChanges="inserted"> <TrainStation>广州(车次:D7001)</TrainStation> <ArriveTime/> <StartTime>06:03:00</StartTime> <KM>0</KM> </TrainDetailInfo> <TrainDetailInfo diffgr:id="TrainDetailInfo2" msdata:rowOrder="1" diffgr:hasChanges="inserted"> <TrainStation>广州东</TrainStation> <ArriveTime>06:13:00</ArriveTime> <StartTime>06:15:00</StartTime> <KM>8</KM> </TrainDetailInfo> <TrainDetailInfo diffgr:id="TrainDetailInfo3" msdata:rowOrder="2" diffgr:hasChanges="inserted"> <TrainStation>石龙</TrainStation> <ArriveTime>06:41:00</ArriveTime> <StartTime>06:43:00</StartTime> <KM>69</KM> </TrainDetailInfo> <TrainDetailInfo diffgr:id="TrainDetailInfo4" msdata:rowOrder="3" diffgr:hasChanges="inserted"> <TrainStation>常平</TrainStation> <ArriveTime>06:54:00</ArriveTime> <StartTime>06:56:00</StartTime> <KM>90</KM> </TrainDetailInfo> <TrainDetailInfo diffgr:id="TrainDetailInfo5" msdata:rowOrder="4" diffgr:hasChanges="inserted"> <TrainStation>樟木头</TrainStation> <ArriveTime>07:03:00</ArriveTime> <StartTime>07:05:00</StartTime> <KM>103</KM> </TrainDetailInfo> <TrainDetailInfo diffgr:id="TrainDetailInfo6" msdata:rowOrder="5" diffgr:hasChanges="inserted"> <TrainStation>深圳</TrainStation> <ArriveTime>07:34:00</ArriveTime> <StartTime/> <KM>147</KM> </TrainDetailInfo> </getDetailInfo>
通过对以上几个接口的合理应用,我们就能通过调用这些接口,通过处理返回的XML数据,
能够实现比较简单的Android火车票时刻查询应用。
==================================================================================================
作者:欧阳鹏 欢迎转载,与人分享是进步的源泉!
转载请保留原文地址:http://blog.csdn.net/ouyang_peng
==================================================================================================