我的Android进阶之旅------>关于调用Webservice查询火车票时刻表的几个接口介绍

今天发现一个可以提供火车票时刻表查询的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

==================================================================================================