WS_Market Web Service

WS_Market

The following operations are supported. For a formal definition, please review the Service Description.

InsertFB

InsertNew

Save_Location_Cell

Save_Location_Wifi

TestHeader

encodeBase64

getAD

getAdBanner

getAirlinesByAirportID
輸入機場的server POI ID與出發/到達(IntType)及相關條件來取得該機場所有航班資料
傳入參數

參數名稱	參數型態	參數說明
nAirportID	int	機場之POIID
nIntType	int	出發 /到達 (Depart: 0, Arrival:1)
str_airway	string	航班所屬的航空公司(ALL或航空公司代碼) str_airway要以4.6取得所有航空公司代碼與名稱 getAirCompany ()取得
str_depart	string	航班的出發地或目的地(ALL或機場代碼) str_depart要以4.7取得所有機場代碼與名稱getAirport ()取得
str_s_time	string	查詢起始時間hhmm；24小時制
str_e_time	string	查詢終止時間hhmm；24小時制

參數輸入範例

參數	值
nAirportID	540973
nIntType	1
str_airway	BR
str_depart	ALL
str_s_time	1500
str_e_time	1510

回傳格式

回傳值	說明
DC_AP	抵達之航空站/起飛之航空站
DC_ServiceID	航班編號
DC_AC	航空公司
DC_ScheduTime	預定起飛時間/預定抵達時間
DC_ActualTime	實際起飛時間/實際抵達時間
DC_Gate	登機門
DC_Terminal	航廈
DC_Remark	狀態 (已飛 - Departed / 時間更改 - schedule changed / 取消 - cancelled / 已到 - arrived / 準時 - on time / 延誤 - delayed / 提早 - early / 報到 / 登機 )

回傳範例
[{"DT_FIDS":[{"DC_AP":"馬尼拉","DC_ServiceID":"BR272","DC_AC":"長榮航空","DC_ScheduTime":"15:00","DC_ActualTime":"15:00","DC_Gate":"C5","DC_Terminal":"2 ","DC_Remark":"準時"},{"DC_AP":"大阪","DC_ServiceID":"BR2131","DC_AC":"長榮航空","DC_ScheduTime":"15:05","DC_ActualTime":"15:05","DC_Gate":"C1","DC_Terminal":"2 ","DC_Remark":"準時"}]}]

getBusStopsByCity
以縣市和關鍵字搜尋公車站點
傳入參數

參數名稱	參數型態	參數說明
nCategoryID	int	交通工具類別
nCityID	short	勤崴縣市ID
strKeyword	string	關鍵字
dLat	int	Lat經緯度(緯度X1000000,經度 X1000000) 此為用戶目前所在緯度
dLon	int	Lon經緯度(緯度X1000000,經度 X1000000) 此為用戶目前所在經度

參數輸入範例

參數	值
nCategoryID	1101
nCityID	1
strKeyword	青島
dLat	25047924
dLon	121517081

回傳格式

回傳值	說明
name	站點名稱
id	站點ID(相當於POIID)
Lat	站點的緯度
Lon	站點的經度
Region	站點所在的行政區
CategoryID	交通工具類別

回傳結果將依用戶所在經緯度排序後，回傳前26筆結果

回傳範例
[{"DataTable_BusStopsByCity":[{"name":"台北車站(青島)","id":501347,"Lat":25044773,"Lon":121517776,"Region":3,"CategoryID":1101},{"name":"台北車站(青島)","id":511446,"Lat":25044834,"Lon":121518310,"Region":3,"CategoryID":1101},{"name":"青島林森路口","id":502477,"Lat":25043790,"Lon":121522018,"Region":3,"CategoryID":1101}]}]

getCateCompany
查詢特定分類之營運業者
傳入參數
參數名稱參數型態參數說明
nCategoryID int 交通工具代號

參數輸入範例
參數值
nCategoryID 1101

回傳格式
回傳值說明
CompanyID 營運業者ID
CH 營運業者名稱

回傳範例
[{"View_CateCompany":[{"CompanyID":1,"CH":"三重客運"},{"CompanyID":2,"CH":"大都會客運"},{"CompanyID":3,"CH":"欣欣客運"},{"CompanyID":4,"CH":"首都客運"},{"CompanyID":5,"CH":"東南客運"},{"CompanyID":6,"CH":"台北客運"},{"CompanyID":7,"CH":"基隆市公車處"},{"CompanyID":8,"CH":"光華巴士"},{"CompanyID":9,"CH":"指南客運"}]}]

getEBusInfoByRoute
指定路線取得各站EBUS資訊
傳入參數

參數名稱	參數型態	參數說明
nRouteID	int	路線ID

參數輸入範例

參數	值
nRouteID	119

回傳格式

回傳值	說明
id	站點POIID
time	到站時間(秒) 如果為0~60，會顯示進站中如果為-1時，代表目前未發車如果為null時，代表目前公務部門端無資料
desc	文字訊息一般會顯示"約X分"，一分內以內會顯示"進站中" 特殊定義 -1，代表目前未發車 -2，代表"交管不停靠"

回傳範例
[{"e_stop_forward": [{"id":502987,"time":-1,"desc":"未發車"},{"id":503014,"time":104,"desc":"約1分"},{"id":503015,"time":191,"desc":"約3分"}]}]

getEBusInfoByStop
指定站點取得各路線EBUS資訊
傳入參數
參數名稱參數型態參數說明
nStopID int 站點POIID

參數輸入範例
參數值
nStopID 503014

回傳格式
回傳值說明
id 路線ID
time 到站時間(秒)
desc 文字訊息

回傳範例
[{"e_routes":[{"id":101,"time":1239,"desc":"約20分"},{"id":119,"time":108,"desc":"約1分"},{"id":121,"time":74,"desc":"約1分"},{"id":904,"time":-1,"desc":"未發車"}]}]

getLocTableByKeyword

getLocTableByKeyword_Map

getLocTableByKeyword_POI

getMRTStations
取得所有捷運站點清單
傳入參數
參數名稱參數型態參數說明
無無無

回傳格式
回傳值說明
RouteID 捷運路線ID
POIID 站點ID
StationSort 站點排序
Region 站點所在的行政區
Company_ID 營運業者ID
Lat 站點的緯度
Lon 站點的經度
Station_Name 站點名稱

回傳範例
[{"DataTable_MRTStations":[{"RouteID":50000,"POIID":508396,"StationSort":1,"Region":68,"Company_ID":23,"Lat":25167818,"Lon":121445561,"Station_Name":"捷運淡水站 "},{"RouteID":50000,"POIID":508395,"StationSort":2,"Region":68,"Company_ID":23,"Lat":25154042,"Lon":121458872,"Station_Name":"捷運紅樹林站 "},{"RouteID":50000,"POIID":508392,"StationSort":3,"Region":68,"Company_ID":23,"Lat":25136940,"Lon":121459479,"Station_Name":"捷運竹圍站 "}]}]

getPass

getPathBetween2POIs
輸入路線ID，回傳路線實際軌跡
傳入參數
參數名稱參數型態參數說明
nRouteID int 路線ID
GoBack int 0:去程 1:反程
nDepartPOIID int 出發站點ID
nArrivalPOIID int 到達站點ID

參數輸入範例
參數值
nRouteID 119
GoBack 0
nDepartPOIID 502665
nArrivalPOIID 502667

回傳格式
回傳值說明
StartLon Lon
StartLat Lat

回傳範例
[{"path":[{"StartLon":121459266,"StartLat":24991685},{"StartLon":121459028,"StartLat":24991852},{"StartLon":121458315,"StartLat":24992617},{"StartLon":121458213,"StartLat":24992719},{"StartLon":121457975,"StartLat":24992974}]}]

getRouteInfo_Photo
取得公車照片
傳入參數
參數名稱參數型態參數說明
RouteID int 路線ID

參數輸入範例
參數值
RouteID 119

回傳格式
回傳型態說明
string 照片路徑

回傳範例
http://www.gotcha.com.tw/Route_Image_320X240/,台北客運\245[德霖學院-台北市政府].JPG,台北客運\245[德霖學院-台北市政府]-2.JPG,

getRouteInfo_StopsBackward
公車、捷運、長途客運或船舶的返程站點清單(若沒有返程的清單，則回傳空的array即可)
傳入參數
參數名稱參數型態參數說明
nCategoryID int 交通工具代號
nRouteID int 營運路線ID

參數輸入範例
參數值
nCategoryID 1101
nRouteID 119

回傳格式
回傳值說明
id 公車/客運/船舶站點ID(相當於POIID)
name 公車/客運/船舶站點名
order 此站點在路線中的順序
Region 行政區
Lat 站點緯度
Lon 站點經度

回傳範例
[{"stops_backward":[{"id":511613,"name":"市政府(市府路)","order":1,"Region":12,"Lat":25038343,"Lon":121563743},{"id":500010,"name":"興雅國中","order":2,"Region":12,"Lat":25037126,"Lon":121568222},{"id":500055,"name":"松壽路口","order":3,"Region":12,"Lat":25035934,"Lon":121567184}]}]

getRouteInfo_StopsForward
公車、捷運、長途客運或船舶去程的站點清單
傳入參數
參數名稱參數型態參數說明
nCategoryID int 交通工具代號
nRouteID int 營運路線ID

參數輸入範例
參數值
nCategoryID 1101
nRouteID 119

回傳格式
回傳值說明
id 公車/客運/船舶站點ID(相當於POIID)
name 公車/客運/船舶站點名
order 此站點在路線中的順序
Region 行政區
Lat 站點緯度
Lon 站點經度

回傳範例
[{"stops_forward":[{"id":510308,"name":"台北客運四海站","order":1,"Region":61,"Lat":24966711,"Lon":121459770},{"id":537699,"name":"四海站","order":2,"Region":61,"Lat":24966817,"Lon":121459594},{"id":502987,"name":"少年觀護所","order":3,"Region":61,"Lat":24969680,"Lon":121459587},{"id":503009,"name":"清化里","order":4,"Region":61,"Lat":24971342,"Lon":121459495},{"id":503010,"name":"德霖技術學院","order":5,"Region":61,"Lat":24972978,"Lon":121458831},{"id":507307,"name":"清和里","order":6,"Region":61,"Lat":24974500,"Lon":121458801},{"id":503011,"name":"檳榔科","order":7,"Region":61,"Lat":24977577,"Lon":121458992},{"id":505832,"name":"清水派出所","order":8,"Region":61,"Lat":24980365,"Lon":121459144}]}]

getRouteInfo_TimeTable
公車、捷運、長途客運或船舶營運班次的時刻表(若為文字敘述而非固定班表，則回傳字串即可，如： "timetable":"頭末班車0600-2400..."
傳入參數
參數名稱參數型態參數說明
nRouteID int 路線ID

參數輸入範例
參數值
nRouteID 119

回傳格式
第一部分為文字訊息
回傳型態說明
string 文字訊息

第二部分為多筆資料JSON
回傳值說明
DateTypeID 日期型態代碼
Schedule 發車時間，以分為單位(ex:340代表 05:40)
StationName 發車站名稱
Note 註記

回傳範例
["頭末班車:05:30-22:00 發車班距:尖峰7-10分離峰12-15分例假日15-20分",{"timetable":[{"DateTypeID":3,"Schedule":330,"StationName":"台北客運四海站","Note":""},{"DateTypeID":3,"Schedule":345,"StationName":"台北客運四海站","Note":""},{"DateTypeID":3,"Schedule":360,"StationName":"台北客運四海站","Note":""},{"DateTypeID":3,"Schedule":375,"StationName":"台北客運四海站","Note":""}]}]

getRoutes
路線資料查詢-公車、長途客運或船舶
傳入參數

參數名稱	參數型態	參數說明
nCategoryID	int	交通工具代號
nID	int	若nCategoryID為公車，則代表地區的ID(Area)，-1則為搜全區。若nCategoryID為長途客運或船舶，則代表營運公司的ID
strKeyword	String	公車/客運路線名稱(船舶可忽略)

參數輸入範例

參數	值
nCategoryID	1101
nID	-1
strKeyword	245

回傳格式

回傳值	說明
RouteID	公車/客運/船舶路線ID
name	公車/客運/船舶路線名稱
company	公車/客運/船舶營運公司

回傳範例
[{"DataTable_Route":[{"RouteID":119,"name":"245[德霖學院-台北101]","company":"台北客運"},{"RouteID":1193,"name":"245[加昌站-火車站]","company":"高雄市公車處"},{"RouteID":1248,"name":"245[加昌站-火車站][繞駛高雄大學校區]","company":"高雄市公車處"},{"RouteID":428,"name":"小16[繞駛永公路245巷34弄]","company":"首都客運"}]}]

getRoutesByPOI
取得通過該POI的所有交通路線
傳入參數
參數名稱參數型態參數說明
int_POIID int 該站點之POI ID

參數輸入範例
參數值
int_POIID 500010

回傳格式
回傳值說明
RouteID 路線ID
name 路線名稱
company 公司名稱
direction 1:去程 0:回程

回傳範例
[{"DataTable_RoutePOIID":[{"RouteID":119,"name":"245[德霖學院-台北101]","company":"台北客運","direction":0},{"RouteID":119,"name":"245[德霖學院-台北101]","company":"台北客運","direction":1},{"RouteID":127,"name":"棕6[動物園-捷運市政府站]","company":"欣欣客運","direction":0},{"RouteID":127,"name":"棕6[動物園-捷運市政府站]","company":"欣欣客運","direction":1},{"RouteID":128,"name":"棕7[新店-台北市政府]","company":"台北客運","direction":0}]}]

getRoutesByTwoPoints
由起站/終站POI ID及其他可能需要之額外資訊，取得"當前時間"兩點間可能之替代路線
傳入參數
參數名稱參數型態參數說明
nCategoryID int 交通工具代號
nDepartPOIID int 起站之POIID
nArrivalPOIID int 到站之POIID
nTrainType int 火車種類(高鐵、飛機可忽略，填0)

參數輸入範例
參數值
nCategoryID 1101
nDepartPOIID 500983
nArrivalPOIID 503000
nTrainType 0

回傳格式
回傳值說明
RouteID 路線ID
name 路線名稱
category 交通工具代號
period 時間
price 價格
schedule 時間間距

回傳範例
[{"RouteID":119,"name":"245[德霖學院-台北101]","category":1101,"period":12,"price":15,"schedule":"頭末班車:05:30-22:00 發車班距:尖峰7-10分離峰12-15分例假日15-20分"},{"RouteID":221,"name":"701[迴龍-台北]","category":1101,"period":12,"price":15,"schedule":"頭末班車:05:30-22:20 發車班距:尖峰12-15分離峰15-20分例假日15-20分"},{"RouteID":225,"name":"702[三峽-台北]","category":1101,"period":12,"price":15,"schedule":"頭末班車:05:30-21:00 發車班距:尖峰15-20分離峰20-30分例假日30-40分"},{"RouteID":624,"name":"310[板橋-士林]","category":1101,"period":12,"price":15,"schedule":"頭末班車:0540-21:45 發車班距:尖峰7-10分離峰10-15分例假日10-15分"}]

getRoutesByTwoPoints_RT

由起站/終站POI ID及其他可能需要之額外資訊，取得"當前時間"兩點間可能之替代路線
傳入參數

參數名稱	參數型態	參數說明
nCategoryID	int	交通工具代號
nDepartPOIID	int	起站之POIID
nArrivalPOIID	int	到站之POIID
nTrainType	int	火車種類(高鐵、飛機可忽略，填0)
RequestTime	DateTime	轉乘的時間

參數輸入範例

參數	值
nCategoryID	1101
nDepartPOIID	500983
nArrivalPOIID	503000
nTrainType	0
RequestTime	2014-10-08T12:23:00

回傳格式

回傳值	說明
RouteID	路線ID
name	路線名稱
category	交通工具代號
period	時間
price	價格
schedule	時間間距

回傳範例

[{
    "RouteID": 119,
    "name": "245[德霖學院-台北101][平日]",
    "category": 1101,
    "period": 12,
    "price": 15,
    "schedule": "頭末班車:05:20-22:00 發車班距:尖峰7-10分 離峰10-15分"
},
{
    "RouteID": 121,
    "name": "656[德霖學院-捷運台大醫院站]",
    "category": 1101,
    "period": 12,
    "price": 15,
    "schedule": "頭末班車:05:30-22:30 發車班距:尖峰4-6分 離峰5-10分 例假日10-15分"
},
{
    "RouteID": 221,
    "name": "701[迴龍-捷運西門站]",
    "category": 1101,
    "period": 12,
    "price": 15,
    "schedule": "頭末班車:05:30-22:20 發車班距:尖峰12-15分 離峰15-20分 例假日15-20分"
},
{
    "RouteID": 624,
    "name": "310[板橋-士林]",
    "category": 1101,
    "period": 12,
    "price": 15,
    "schedule": "頭末班車:04:50-22:30 發車班距:尖峰7-10分 離峰、例假日10-15分"
},
{
    "RouteID": 3567,
    "name": "245[德霖學院-台北101][假日]",
    "category": 1101,
    "period": 12,
    "price": 15,
    "schedule": "頭末班車:05:30-22:00 發車班距:例假日15-20分 [假日不停靠市政府(市府路)站位]"
}]

getStationInfo
站點ID取得站點經緯度、站點電話、站點照片等資訊(適用於捷運、長途客運、船舶)
傳入參數
參數名稱參數型態參數說明
int_POIID int 該站點之POI ID

參數輸入範例
參數值
int_POIID 500010

回傳格式
回傳值說明
Lat 站點緯度
Lon 站點經度
phone 站點電話(如果沒有電話回傳null)
Region 站點所在的行政區

回傳範例
[{"POI_Table":[{"Lat":25037126,"Lon":121568222,"phone":"","Region":12}]}]

getStationInfo_Photo
取得站點照片
傳入參數
參數名稱參數型態參數說明
POIID int 該站點之POI ID

參數輸入範例
參數值
POIID 500039

回傳格式
回傳型態說明
string 照片路徑

回傳範例
http://www.gotcha.com.tw/Station_Image_320X240/,500039_0.jpg,500039_1.jpg,500039_2.jpg,500039_3.jpg,500039_4.jpg,

getStationsAndTime
以班次代碼來搜尋該班次所經過之站點及時間表(到站時間)(適用於火車、高鐵、飛機)
傳入參數
參數名稱參數型態參數說明
nCategoryID int 交通工具類別
nRouteID int 班次之routeID

參數輸入範例
參數值
nCategoryID 1104
nRouteID 60030

回傳格式
回傳值說明
POIID 經過站點之POIID
Schedule 經過站點的時間
name 經過站點名稱
StationSort 站點之順序ID

回傳範例
[{"DataTable_StationsAndTime":[{"POIID":508634,"Schedule":831,"name":"斗六火車站 ","StationSort":1},{"POIID":508633,"Schedule":839,"name":"斗南火車站 ","StationSort":2},{"POIID":508722,"Schedule":843,"name":"石龜火車站 ","StationSort":3}]}]

getStationsByCategoryID
取得特定分類之所有站點(公車、長途客運除外)
傳入參數
參數名稱參數型態參數說明
nCategoryID int 交通工具代號

參數輸入範例
參數值
nCategoryID 1104

回傳格式
回傳值說明
name 站點名稱
id 站點ID
Lat 站點的緯度
Lon 站點的經度
Region 站點所在的行政區
CategoryID 交通工具代號

回傳範例
[{"DataTable_BusStopsByCity":[{"name":"台北車站 ","id":508659,"Lat":25047924,"Lon":121517081,"Region":3,"CategoryID":1104},{"name":"板橋火車站 ","id":508657,"Lat":25014051,"Lon":121463815,"Region":56,"CategoryID":1104},{"name":"基隆火車站 ","id":508665,"Lat":25132302,"Lon":121739466,"Region":24,"CategoryID":1104},{"name":"林鳳營火車站 ","id":508753,"Lat":23242592,"Lon":120320973,"Region":241,"CategoryID":1104}]}]

getStationsByLoc
取得附近站點
傳入參數

參數名稱	參數型態	參數說明
nCategoryID	int	交通工具代號取全部：-1 市區公車：0x1 捷運：0x2 長途客運：0x4 火車：0x8 高鐵：0x16 飛機：0x32 船舶：0x64
nCityID	short	勤崴縣市ID
strKeyword	string	關鍵字
dLat	int	Lat經緯度(緯度X1000000,經度 X1000000)
dLon	int	Lon經緯度(緯度X1000000,經度 X1000000)

參數輸入範例

參數	值
nCategoryID	4
nCityID	1
strKeyword	客運
dLat	25047924
dLon	121517081

回傳格式

回傳值	說明
name	站點名稱
id	站點ID(相當於POIID)
Lat	站點的緯度
Lon	站點的經度
Region	站點所在的行政區
CategoryID	交通工具類別

回傳範例
[{"DataTable_BusStopsByCity":[{"name":"日統客運台北站","id":511355,"Lat":25048351,"Lon":121509468,"Region":5,"CategoryID":1103},{"name":"豐榮客運捷運忠孝復興站","id":512704,"Lat":25041501,"Lon":121542846,"Region":2,"CategoryID":1103},{"name":"尊龍客運忠孝復興站","id":509007,"Lat":25040899,"Lon":121543571,"Region":2,"CategoryID":1103},{"name":"統聯客運松山站","id":511054,"Lat":25046081,"Lon":121577583,"Region":12,"CategoryID":1103},{"name":"統聯客運景美站","id":511055,"Lat":24992456,"Lon":121540412,"Region":7,"CategoryID":1103}]}]

getTaiTrainCarClass

回傳格式

回傳值	說明
BinraryTrainType	台鐵車種mask
CarClassName	火車種類名稱
Order	火車種類排序

回傳範例

[
   {
      "BinraryTrainType":32769,
      "CarClassName":"自強號",
      "Order":1
   },
   {
      "BinraryTrainType":2,
      "CarClassName":"PP自強號",
      "Order":2
   },
   {
      "BinraryTrainType":4,
      "CarClassName":"太魯閣號",
      "Order":3
   },
   {
      "BinraryTrainType":8,
      "CarClassName":"普悠瑪號",
      "Order":4
   },
   {
      "BinraryTrainType":16,
      "CarClassName":"莒光號",
      "Order":5
   },
   {
      "BinraryTrainType":32,
      "CarClassName":"復興號",
      "Order":6
   },
   {
      "BinraryTrainType":256,
      "CarClassName":"區間快車",
      "Order":7
   },
   {
      "BinraryTrainType":128,
      "CarClassName":"區間車",
      "Order":8
   },
   {
      "BinraryTrainType":512,
      "CarClassName":"普快車",
      "Order":9
   },
   {
      "BinraryTrainType":8192,
      "CarClassName":"林鐵區間車",
      "Order":10
   },
   {
      "BinraryTrainType":16384,
      "CarClassName":"阿里山號",
      "Order":11
   }
]

getTicketFee
依據路線和出發/抵達站的資料，取得公車、長途客運、火車、高鐵、飛機、船舶票價
傳入參數

參數名稱	參數型態	參數說明
nCategoryID	int	交通工具類別
nRouteID	int	營運路線ID(火車、高鐵忽略，可填0)
nStartStationData	int	出發站點在路線中的順序(公車或長途客運)，或站點的ID(火車、高鐵、飛機、船舶)
nEndStationData	int	抵達站點在路線中的順序(公車或長途客運)，或站點的ID(火車、高鐵、飛機、船舶)
nTrainType	int	火車車種類別(其他交通工具可忽略填0)

參數輸入範例

參數	值
nCategoryID	1103
nRouteID	696
nStartStationData	1
nEndStationData	10
nTrainType	0

回傳格式

回傳型態	說明
int	票價

回傳範例
35

getTrainLines
以起站/終站POIID、日期、(或火車種類)來查詢班次(適用於火車、高鐵、飛機)
傳入參數

參數名稱

參數型態

參數說明

nCategoryID

int

交通工具類別

nDepartPOIID

int

起站之POIID

nArrivalPOIID

int

到站之POIID

nDateType

int

日期型態代碼

種類	一般時段	假日時段	每日行駛	星期一	星期二	星期三	星期四	星期五	星期六	星期日
代碼	1	2	3	11	12	13	14	15	16	17

nTrainType

int

火車種類(高鐵、飛機可忽略，填0)
火車車種為bitmask的值，車種mask值參照如下
int TRAIN_TYPE_MASK_ZIQIANG = 0x01; // 自強
int TRAIN_TYPE_MASK_JUGUANG = 0x02; // 莒光
int TRAIN_TYPE_MASK_FUSHING = 0x04; // 復興/區間
int TRAIN_TYPE_MASK_NORMAL = 0x08; // 普通

參數輸入範例

參數	值
nCategoryID	1104
nDepartPOIID	552459
nArrivalPOIID	553815
nDateType	1
nTrainType	4

回傳格式

回傳值	說明
RouteID	班次routeID
name	班次名稱
type	火車種類
stime	起站時間
etime	終站時間
DateTypeID	日期型態代碼
price	價格

回傳範例
[{"View_Lines":[{"RouteID":62711,"name":"1846-新竹-九讚頭","type":3,"stime":389,"etime":393,"DateTypeID":1,"price":15},{"RouteID":62630,"name":"1834-新竹-內灣","type":3,"stime":1066,"etime":1070,"DateTypeID":1,"price":15},{"RouteID":62712,"name":"1848-新竹-九讚頭","type":3,"stime":1244,"etime":1248,"DateTypeID":1,"price":15}]}]

getTrainLinesByDateRange

以起站/終站POIID、日期、(或火車種類)來查詢班次(適用於火車、高鐵)
傳入參數

參數名稱	參數型態	參數說明
nCategoryID	int	交通工具類別
nDepartPOIID	int	起站之POIID
nArrivalPOIID	int	到站之POIID
nTrainType	int	火車種類(高鐵填0) 火車車種為bitmask的值，車種mask值參照 API getTaiTrainCarClass
str_Start_Date	string	yyyy-MM-dd 年-月-日
str_End_Date	string	yyyy-MM-dd 年-月-日

參數輸入範例

參數	值
nCategoryID	1104
nDepartPOIID	552459
nArrivalPOIID	553815
nTrainType	65535
str_Start_Date	2014-09-30
str_End_Date	2014-09-30

回傳格式

回傳值	說明
RouteID	班次routeID
name	班次名稱
type	火車種類
stime	起站時間
etime	終站時間
DateTypeID	日期型態代碼
price	價格
Date	行駛日期
TypeName	火車種類名稱

回傳範例
[ { "View_Lines":[ { "RouteID":64218, "name":"1802-新竹-內灣", "type":128, "stime":327, "etime":331, "DateTypeID":127, "price":15, "Date":"2014-09-30 05:27:00", "TypeName":"區間車" }, { "RouteID":64143, "name":"1702-新竹-六家", "type":128, "stime":376, "etime":379, "DateTypeID":127, "price":15, "Date":"2014-09-30 06:16:00", "TypeName":"區間車" } ] } ]

getTransitPaths
直接轉乘不設定運具

傳入參數

參數名稱	參數型態	參數說明
StartPoint	string	起點經緯度緯度X1000000,經度 X1000000,關鍵字(非必填),類型(0：道路與地址，1：POI，非必填) Ex1:"25000000,121000000" 直接用經緯度查規劃。 EX2:"25000000,121000000,中華電信" 查詢離此經緯度最近之關鍵字為中華電信之景點
EndPoint	string	終點經緯度緯度X1000000,經度 X1000000,關鍵字(非必填),類型(0：道路與地址，1：POI，非必填) Ex1:"25000000,121000000" 直接用經緯度查規劃。 EX2:"25000000,121000000,中華電信,1" 查詢離此經緯度最近之POI關鍵字為中華電信之景點 EX3:"25000000,121000000,羅斯福路100號,0" 查詢離此經緯度最近之地址關鍵字為羅斯福路100號之地址

參數輸入範例

參數	值
StartPoint	25044773,121517776
EndPoint	25028835,121522003

回傳格式
第一部分為筆數

回傳值	說明
result	筆數

第二部分為多筆資料 JSONArray格式

回傳值	說明
routes	路線 (起/終點正確並查得規劃路線資料，最多三條路線)

回傳範例
[{"result":3,"routes":[{"points":[{"id":501347,"name":"台北車站(青島)","region":3,"lat":25044773,"lon":121517776},{"id":504084,"name":"福州街口","region":3,"lat":25029249,"lon":121520545},{"id":0,"name":"終點","region":0,"lat":25028835,"lon":121522003}],"lines":[{"RouteID":275,"name":"849[烏來-台北車站]","category":1101,"period":5,"price":15,"schedule":"頭末班車:05:30-21:40 發車班距:尖峰10-15分離峰15-20分例假日10-20分"},{"RouteID":0,"name":"步行","category":0,"period":3,"price":0,"schedule":"170"}]},{"points":[{"id":501347,"name":"台北車站(青島)","region":3,"lat":25044773,"lon":121517776},{"id":500502,"name":"南昌公園","region":3,"lat":25027322,"lon":121520362},{"id":0,"name":"終點","region":0,"lat":25028835,"lon":121522003}],"lines":[{"RouteID":595,"name":"295[動物園-台北車站]","category":1101,"period":7,"price":15,"schedule":"捷運動物園站頭末班車:05:40-23:00 發車班距:固定班次"},{"RouteID":0,"name":"步行","category":0,"period":5,"price":0,"schedule":"286"}]},{"points":[{"id":0,"name":"起點","region":0,"lat":25044773,"lon":121517776},{"id":508367,"name":"捷運台北車站(出口8)","region":3,"lat":25046255,"lon":121517532},{"id":508379,"name":"捷運古亭站(出口7)","region":3,"lat":25026357,"lon":121522873},{"id":0,"name":"終點","region":0,"lat":25028835,"lon":121522003}],"lines":[{"RouteID":0,"name":"步行","category":0,"period":3,"price":0,"schedule":"156"},{"RouteID":50000,"name":"捷運淡水線[淡水-新店]","category":1102,"period":4,"price":20,"schedule":"頭末班車:06:00-24:00 發車班距:尖峰6-7分離峰8-12分例假日8-12分"},{"RouteID":0,"name":"步行","category":0,"period":5,"price":0,"schedule":"304"}]}]}]

getTransitRoutingPaths
依據轉乘工具及規劃設定，加上起點／終點資訊，取得"當前時間"可轉乘路徑規劃結果

傳入參數

參數名稱	參數型態	參數說明
nCategoryBits	int	可使用之轉乘工具市區公車：0x1 捷運：0x2 長途客運：0x4 火車：0x8 高鐵：0x16 飛機：0x32 船舶：0x64
nRoutePlan	int	路徑規劃設定，最快速：1, 最省錢：2, 最少轉乘次數：3
strStartPoint	string	起點經緯度緯度X1000000,經度 X1000000,關鍵字(非必填),類型(0：道路與地址，1：POI，非必填) Ex1:"25000000,121000000" 直接用經緯度查規劃。 EX2:"25000000,121000000,中華電信,1" 查詢離此經緯度最近之POI關鍵字為中華電信之景點 EX3:"25000000,121000000,羅斯福路100號,0" 查詢離此經緯度最近之地址關鍵字為羅斯福路100號之地址
strEndPoint	string	終點經緯度緯度X1000000,經度 X1000000,關鍵字(非必填),類型(0：道路與地址，1：POI，非必填) Ex1:"25000000,121000000" 直接用經緯度查規劃。 EX2:"25000000,121000000,中華電信,1" 查詢離此經緯度最近之POI關鍵字為中華電信之景點 EX3:"25000000,121000000,羅斯福路100號,0" 查詢離此經緯度最近之地址關鍵字為羅斯福路100號之地址

註： 1.5公里以內沒站牌就不會運算

參數輸入範例
範例 1：直接用經緯度查規劃

參數	值
nCategoryBits	2
nRoutePlan	3
strStartPoint	25026842,121520515
strEndPoint	25028835,121522003

範例 2：查詢離此經緯度最近之關鍵字之景點

參數	值
nCategoryBits	1
nRoutePlan	1
strStartPoint	25020650,121528533,羅斯福路,1
strEndPoint	25020650,121528533,羅斯福路,1

回傳格式
第一部分為筆數

回傳值	說明
result	筆數

第二部分為多筆資料 JSONArray格式
起/終點正確並查得規劃路線資料，最多三條路線

回傳值	說明
routes	路線

多筆可能起點或終點

回傳值	說明
start_points	起點
end_points	終點

回傳範例
範例 1：直接用經緯度查規劃
[{"result":3,"routes":[{"points":[{"id":0,"name":"起點","region":0,"lat":25026842,"lon":121520515},{"id":508379,"name":"捷運古亭站(出口8)","region":3,"lat":25026357,"lon":121522873},{"id":508379,"name":"捷運古亭站(出口7)","region":3,"lat":25026357,"lon":121522873},{"id":0,"name":"終點","region":0,"lat":25028835,"lon":121522003}],"lines":[{"RouteID":0,"name":"步行","category":0,"period":4,"price":0,"schedule":"258"},{"RouteID":50001,"name":"捷運淡水線[北投-台電大樓]","category":1102,"period":1,"price":-1,"schedule":"頭末班車:06:00-24:00 發車班距:尖峰6-7分離峰8-12分例假日8-12分"},{"RouteID":0,"name":"步行","category":0,"period":5,"price":0,"schedule":"304"}]}]}]

範例 2：查詢離此經緯度最近之關鍵字之POI
[{"result":2,"start_points:":[{"Name":"羅斯福路匝道北上入口","type":"道路施設/資訊","Lat":25021018,"Lon":121530921,"Region":2},{"Name":"羅斯福路匝道南下出口","type":"道路施設/資訊","Lat":25021456,"Lon":121531154,"Region":2}],"end_points:":[{"Name":"羅斯福路匝道北上入口","type":"道路施設/資訊","Lat":25021018,"Lon":121530921,"Region":2},{"Name":"羅斯福路匝道南下出口","type":"道路施設/資訊","Lat":25021456,"Lon":121531154,"Region":2}]}]

getTransitRoutingPaths_RT

依據轉乘工具及規劃設定，加上起點／終點資訊，取得"輸入時間"可轉乘路徑規劃結果

傳入參數

參數名稱	參數型態	參數說明
nCategoryBits	int	可使用之轉乘工具市區公車：0x1 捷運：0x2 長途客運：0x4 火車：0x8 高鐵：0x16 飛機：0x32 船舶：0x64
nRoutePlan	int	路徑規劃設定，最快速：1, 最省錢：2, 最少轉乘次數：3
strStartPoint	string	起點經緯度緯度X1000000,經度 X1000000,關鍵字(非必填),類型(0：道路與地址，1：POI，非必填) Ex1:"25000000,121000000" 直接用經緯度查規劃。 EX2:"25000000,121000000,中華電信,1" 查詢離此經緯度最近之POI關鍵字為中華電信之景點 EX3:"25000000,121000000,羅斯福路100號,0" 查詢離此經緯度最近之地址關鍵字為羅斯福路100號之地址
strEndPoint	string	終點經緯度緯度X1000000,經度 X1000000,關鍵字(非必填),類型(0：道路與地址，1：POI，非必填) Ex1:"25000000,121000000" 直接用經緯度查規劃。 EX2:"25000000,121000000,中華電信,1" 查詢離此經緯度最近之POI關鍵字為中華電信之景點 EX3:"25000000,121000000,羅斯福路100號,0" 查詢離此經緯度最近之地址關鍵字為羅斯福路100號之地址
RouteNum	int	轉乘規劃的結果數
RequestTime	dateTime	轉乘的時間

註： 1.5公里以內沒站牌就不會運算

參數輸入範例
範例 1：直接用經緯度查規劃

參數	值
nCategoryBits	2
nRoutePlan	3
strStartPoint	25026842,121520515
strEndPoint	25028835,121522003
RouteNum	3
RequestTime	2014-09-30T13:23:00

範例 2：查詢離此經緯度最近之關鍵字之景點

參數	值
nCategoryBits	1
nRoutePlan	1
strStartPoint	25020650,121528533,羅斯福路,1
strEndPoint	25020650,121528533,羅斯福路,1
RouteNum	3
RequestTime	2014-09-30T13:23:00

回傳格式
第一部分為筆數

回傳值	說明
result	筆數

第二部分為多筆資料 JSONArray格式
起/終點正確並查得規劃路線資料

回傳值	說明
routes	路線

多筆可能起點或終點

回傳值	說明
start_points	起點
end_points	終點

回傳範例
範例 1：直接用經緯度查規劃

[
   {
      "result":3,
      "routes":[
         {
            "points":[
               {
                  "id":0,
                  "name":"起點",
                  "region":0,
                  "lat":25026842,
                  "lon":121520515
               },
               {
                  "id":508379,
                  "name":"捷運古亭站(出入口8)",
                  "region":3,
                  "lat":25026356,
                  "lon":121522872
               },
               {
                  "id":508379,
                  "name":"捷運古亭站(出入口7)",
                  "region":3,
                  "lat":25026356,
                  "lon":121522872
               },
               {
                  "id":0,
                  "name":"終點",
                  "region":0,
                  "lat":25028835,
                  "lon":121522003
               }
            ],
            "lines":[
               {
                  "RouteID":0,
                  "name":"步行",
                  "category":0,
                  "period":4,
                  "price":0,
                  "schedule":"258"
               },
               {
                  "RouteID":50004,
                  "name":"捷運小南門線[台電大樓-西門]",
                  "category":1102,
                  "period":1,
                  "price":-1,
                  "schedule":"頭末班車:06:00-24:00 發車班距:尖峰6-7分 離峰8-12分 例假日8-12分"
               },
               {
                  "RouteID":0,
                  "name":"步行",
                  "category":0,
                  "period":5,
                  "price":0,
                  "schedule":"304"
               }
            ]
         }
      ]
   }
]

範例 2：查詢離此經緯度最近之關鍵字之POI

[
   {
      "result":2,
      "start_points:":[
         {
            "Name":"羅斯福路匝道北上入口",
            "type":"道路施設/資訊",
            "Lat":25021018,
            "Lon":121530921,
            "Region":2
         },
         {
            "Name":"羅斯福路匝道南下出口",
            "type":"道路施設/資訊",
            "Lat":25021456,
            "Lon":121531154,
            "Region":2
         },
         {
            "Name":"羅斯福路三段停車場",
            "type":"汽車停車場",
            "Lat":25022345,
            "Lon":121525584,
            "Region":3
         },
         {
            "Name":"羅斯福路三段停車場",
            "type":"汽車停車場",
            "Lat":25017056,
            "Lon":121532607,
            "Region":2
         },
         {
            "Name":"羅斯福路停車場",
            "type":"汽車停車場",
            "Lat":25025467,
            "Lon":121523887,
            "Region":2
         },
         {
            "Name":"羅斯福路派出所",
            "type":"軍警單位",
            "Lat":25011150,
            "Lon":121537997,
            "Region":2
         },
         {
            "Name":"羅斯福路六段北上入口",
            "type":"道路施設/資訊",
            "Lat":25000099,
            "Lon":121535299,
            "Region":7
         },
         {
            "Name":"協和汽車羅斯福路廠",
            "type":"汽車維修保養廠",
            "Lat":25002641,
            "Lon":121538933,
            "Region":7
         }
      ],
      "end_points:":[
         {
            "Name":"羅斯福路匝道北上入口",
            "type":"道路施設/資訊",
            "Lat":25021018,
            "Lon":121530921,
            "Region":2
         },
         {
            "Name":"羅斯福路匝道南下出口",
            "type":"道路施設/資訊",
            "Lat":25021456,
            "Lon":121531154,
            "Region":2
         },
         {
            "Name":"羅斯福路三段停車場",
            "type":"汽車停車場",
            "Lat":25022345,
            "Lon":121525584,
            "Region":3
         },
         {
            "Name":"羅斯福路三段停車場",
            "type":"汽車停車場",
            "Lat":25017056,
            "Lon":121532607,
            "Region":2
         },
         {
            "Name":"羅斯福路停車場",
            "type":"汽車停車場",
            "Lat":25025467,
            "Lon":121523887,
            "Region":2
         },
         {
            "Name":"羅斯福路派出所",
            "type":"軍警單位",
            "Lat":25011150,
            "Lon":121537997,
            "Region":2
         },
         {
            "Name":"羅斯福路六段北上入口",
            "type":"道路施設/資訊",
            "Lat":25000099,
            "Lon":121535299,
            "Region":7
         },
         {
            "Name":"協和汽車羅斯福路廠",
            "type":"汽車維修保養廠",
            "Lat":25002641,
            "Lon":121538933,
            "Region":7
         }
      ]
   }
]

getWalkPathBetween2POIs
輸入起迄點座標，會按照路網回傳步行軌跡
傳入參數
參數名稱參數型態參數說明
StartLat int 起點緯度*1000000
StartLon int 起點經度*1000000
EndLat int 終點緯度*1000000
EndLon int 終點緯度*1000000

參數輸入範例
參數值
StartLat 25039296
StartLon 121517351
EndLat 25035146
EndLon 121517122

回傳格式
回傳值說明
JSONArray 以JSONArray格式回傳多筆點位資料

回傳範例
[{"path":[{"StartLon":121517351,"StartLat":25039296},{"StartLon":121517351,"StartLat":25039296},{"StartLon":121517287,"StartLat":25039195},{"StartLon":121517246,"StartLat":25039071},{"StartLon":121517241,"StartLat":25039002},{"StartLon":121517248,"StartLat":25038935},{"StartLon":121517271,"StartLat":25038857},{"StartLon":121517318,"StartLat":25038780},{"StartLon":121517381,"StartLat":25038687},{"StartLon":121517401,"StartLat":25038594},{"StartLon":121517351,"StartLat":25038385},{"StartLon":121517285,"StartLat":25038184},{"StartLon":121517365,"StartLat":25038086},{"StartLon":121517425,"StartLat":25038072},{"StartLon":121517496,"StartLat":25037969},{"StartLon":121516731,"StartLat":25035351},{"StartLon":121516708,"StartLat":25035195},{"StartLon":121516757,"StartLat":25035001},{"StartLon":121516743,"StartLat":25034875},{"StartLon":121516743,"StartLat":25034875},{"StartLon":121517032,"StartLat":25034798},{"StartLon":121517122,"StartLat":25035146}]}]

sendToken

參數	值
nRouteID	119
GoBack	0
nDepartPOIID	502665
nArrivalPOIID	502667

回傳值	說明
id	公車/客運/船舶站點ID(相當於POIID)
name	公車/客運/船舶站點名
order	此站點在路線中的順序
Region	行政區
Lat	站點緯度
Lon	站點經度

回傳值	說明
POIID	經過站點之POIID
Schedule	經過站點的時間
name	經過站點名稱
StationSort	站點之順序ID

參數	值
StartLat	25039296
StartLon	121517351
EndLat	25035146
EndLon	121517122

回傳值	說明
JSONArray	以JSONArray格式回傳多筆點位資料

回傳值	說明
CompanyID	營運業者ID
CH	營運業者名稱

參數	值
nStopID	503014

參數名稱	參數型態	參數說明
無	無	無

回傳值	說明
DateTypeID	日期型態代碼
Schedule	發車時間，以分為單位(ex:340代表 05:40)
StationName	發車站名稱
Note	註記