# 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"
			}
		]
	}
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fatos-doc.fatos.biz/fatos-api/search/public-transport/real-time-bus-location-information.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.