# Real-time Bus Location Information

| Method |                   Request URI                  | Response type |
| :----: | :--------------------------------------------: | :-----------: |
|   GET  | <https://api.fatos.biz/pubtrans/realtimeRoute> |   json, xml   |

### Parameter

<table><thead><tr><th align="center">Parameter</th><th width="120" align="center">Required</th><th align="center">Description</th><th align="center">Sample</th></tr></thead><tbody><tr><td align="center">key</td><td align="center">Y</td><td align="center">Your API Key.</td><td align="center">key=xxxxxxxxxxx</td></tr><tr><td align="center">lang</td><td align="center">N</td><td align="center"><p></p><p>Select Result Language </p><p>(Korean: 0, English: 1, Japanese: 2, Chinese (simplified): 3, Chinese (traditional): 4, Vietnamese: 5)</p><ul><li>For Vietnamese, only in the metropolitan area</li></ul><p>default = 0</p></td><td align="center">lang=1</td></tr><tr><td align="center">output</td><td align="center">N</td><td align="center"><p>Output format (json, xml) </p><p>default = json</p></td><td align="center">output=json</td></tr><tr><td align="center">busID</td><td align="center">Y</td><td align="center">Bus route code</td><td align="center">busID=1812</td></tr><tr><td align="center">busBase</td><td align="center">N</td><td align="center">Include bus route-based information 0: Real-time information only; 1: Include route-based information</td><td align="center">busBase=0</td></tr><tr><td align="center">lowBus</td><td align="center">N</td><td align="center">Low-floor bus filtering 0: All buses, 1: Low-floor buses only</td><td align="center">lowBus=0</td></tr></tbody></table>

### Response

<table><thead><tr><th width="206">NAME</th><th width="188.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>result</td><td>확장노드</td><td>데이터를 포함하는 최상위노드</td></tr><tr><td>base</td><td>확장노드</td><td>요청 파라미터 busBase=1인 경우만 존재</td></tr><tr><td>busID</td><td>int</td><td>버스노선 코드</td></tr><tr><td>busNo</td><td>string</td><td>버스번호</td></tr><tr><td>type</td><td>int</td><td>버스노선 종류<br>(문서하단 버스노선타입 참조)</td></tr><tr><td>busCityName</td><td>string</td><td>운수회사 승인 도시이름</td></tr><tr><td>busCityCode</td><td>int</td><td>운수회사 승인 도시코드</td></tr><tr><td>busStartPoint</td><td>string</td><td>버스노선 기점</td></tr><tr><td>busEndPoint</td><td>string</td><td>버스노선 종점</td></tr><tr><td>busFirstTime</td><td>string</td><td>첫차시간</td></tr><tr><td>busLastTime</td><td>string</td><td>막차시간</td></tr><tr><td>busInterval</td><td>string</td><td>운행간격(분) or 운행횟수(#1)</td></tr><tr><td>busTotalDistance</td><td>int</td><td>버스노선 전체 운행거리</td></tr><tr><td>bus_Ep_FirstTime</td><td>string</td><td>종점기준 첫차</td></tr><tr><td>bus_Ep_LastTime</td><td>string</td><td>종점기준 막차</td></tr><tr><td>bus_Interval_Week</td><td>string</td><td>평일 배차간격</td></tr><tr><td>bus_Interval_Sat</td><td>string</td><td>토요일 배차간격</td></tr><tr><td>bus_Interval_Sun</td><td>string</td><td>일요일(공휴일) 배차간격</td></tr><tr><td>bus_Interval_Rushhour</td><td>string</td><td>출퇴근시간 배차간격</td></tr><tr><td>busLocalBlID</td><td>string</td><td>각 지역 버스노선 ID</td></tr><tr><td>station</td><td>확장노드</td><td>정류장 리스트</td></tr><tr><td>idx</td><td>int</td><td>정류장순번</td></tr><tr><td>stationID</td><td>int</td><td>정류장 ID</td></tr><tr><td>stationName</td><td>string</td><td>정류장 이름</td></tr><tr><td>stationDistance</td><td>long</td><td>정류장간 누적거리<br>(현재 정류장에서 다음 정류장까지)</td></tr><tr><td>stationDirection</td><td>int</td><td>상하행 구분코드<br>(0:없음, 1:하행, 2:상행)</td></tr><tr><td>arsID</td><td>string</td><td>정류장 고유번호<br>(0:없음)</td></tr><tr><td>x</td><td>double</td><td>정류장 x좌표(경위도)</td></tr><tr><td>y</td><td>double</td><td>정류장 y좌표(경위도)</td></tr><tr><td>localStationID</td><td>string</td><td>정류장 LocalID</td></tr><tr><td>stationCityCode</td><td>int</td><td>정류장 도시코드</td></tr><tr><td>nonstopStation</td><td>int</td><td>미정차정류장<br>(0:정차, 1:미정차)</td></tr><tr><td>real</td><td>확장노드</td><td>실시간 버스 위치정보</td></tr><tr><td>busId</td><td>string</td><td>버스노선 코드</td></tr><tr><td>routeId</td><td>string</td><td>각 지역 버스노선 ID</td></tr><tr><td>busPlateNo</td><td>string</td><td>버스 번호판 정보</td></tr><tr><td>fromStationId</td><td>string</td><td>버스 기준 방금 출발한 정류장 ID</td></tr><tr><td>fromStationSeq</td><td>string</td><td>전체 통과 정류장 리스트중 방금 출발한 정류장 인덱스</td></tr><tr><td>toStationId</td><td>string</td><td>버스 기준 향하는 정류장 ID</td></tr><tr><td>toStationSeq</td><td>string</td><td>전체 통과 정류장 리스트중 향하는 정류장 인덱스</td></tr><tr><td>busPosition</td><td>string</td><td>두 정류장 사이의 버스 위치<br>(1:이전 정류장 도착, 2:두 정류장 중간)</td></tr><tr><td>endBusYn</td><td>string</td><td>막차버스 여부<br>(Y:막차버스, N:일반버스)</td></tr><tr><td>lowBusYn</td><td>string</td><td>저상버스 여부<br>(Y:저상버스, N:일반버스)</td></tr><tr><td>seoulProvdTm</td><td>string</td><td>실시간정보 제공시간<br>ex) 2021-04-07 16:24:24</td></tr></tbody></table>

### Response Sample

```json
{
	"result": {
		"real": [
			{
				"busId": "1812",
				"busPlateNo": "서울70사7763",
				"routeId": "100100448",
				"seoulProvdTm": "2023-02-06 11:06:20",
				"fromStationId": "89375",
				"fromStationSeq": "4",
				"endBusYn": "N",
				"lowBusYn": "N",
				"toStationSeq": "5",
				"busPosition": "2",
				"toStationId": "211982"
			},
			{
				"busId": "1812",
				"busPlateNo": "서울75사2946",
				"routeId": "100100448",
				"seoulProvdTm": "2023-02-06 11:06:12",
				"fromStationId": "102748",
				"fromStationSeq": "20",
				"endBusYn": "N",
				"lowBusYn": "Y",
				"toStationSeq": "21",
				"busPosition": "2",
				"toStationId": "102809"
			},
			{
				"busId": "1812",
				"busPlateNo": "서울70사7799",
				"routeId": "100100448",
				"seoulProvdTm": "2023-02-06 11:06:21",
				"fromStationId": "103943",
				"fromStationSeq": "32",
				"endBusYn": "N",
				"lowBusYn": "Y",
				"toStationSeq": "33",
				"busPosition": "2",
				"toStationId": "126840"
			},
			{
				"busId": "1812",
				"busPlateNo": "서울74사7214",
				"routeId": "100100448",
				"seoulProvdTm": "2023-02-06 11:06:13",
				"fromStationId": "104797",
				"fromStationSeq": "41",
				"endBusYn": "N",
				"lowBusYn": "Y",
				"toStationSeq": "42",
				"busPosition": "2",
				"toStationId": "104815"
			},
			{
				"busId": "1812",
				"busPlateNo": "서울70사7762",
				"routeId": "100100448",
				"seoulProvdTm": "2023-02-06 11:06:24",
				"fromStationId": "126838",
				"fromStationSeq": "48",
				"endBusYn": "N",
				"lowBusYn": "Y",
				"toStationSeq": "49",
				"busPosition": "2",
				"toStationId": "206217"
			},
			{
				"busId": "1812",
				"busPlateNo": "서울74사7207",
				"routeId": "100100448",
				"seoulProvdTm": "2023-02-06 11:06:24",
				"fromStationId": "102760",
				"fromStationSeq": "61",
				"endBusYn": "N",
				"lowBusYn": "Y",
				"toStationSeq": "62",
				"busPosition": "2",
				"toStationId": "102726"
			},
			{
				"busId": "1812",
				"busPlateNo": "서울70사7792",
				"routeId": "100100448",
				"seoulProvdTm": "2023-02-06 11:06:22",
				"fromStationId": "195073",
				"fromStationSeq": "72",
				"endBusYn": "N",
				"lowBusYn": "Y",
				"toStationSeq": "73",
				"busPosition": "1",
				"toStationId": "195070"
			}
		]
	}
}
```