[置顶] 我的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

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