# Real-time Bus Arrival Information

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

### Parameter

<table><thead><tr><th align="center">Parameter</th><th width="116" 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">stationID</td><td align="center">Y</td><td align="center">Bus stop code</td><td align="center">stationID=102155</td></tr><tr><td align="center">routeIDs</td><td align="center">N</td><td align="center">Route Information Filtering (You can filter route IDs by dividing them into commas)</td><td align="center">routeIDs=1210,1187</td></tr><tr><td align="center">stationBase</td><td align="center">N</td><td align="center">Contains station-based information 0: Real-time information only; 1: With station-based information</td><td align="center">stationBase=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="177.33333333333331" align="center">NAME</th><th width="180" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td align="center">result</td><td align="center">확장노드</td><td>데이터를 포함하는 최상위노드</td></tr><tr><td align="center">base</td><td align="center">확장노드</td><td>요청 파라미터 busBase=1인 경우만 존재</td></tr><tr><td align="center">stationName</td><td align="center">double</td><td>정류장 이름</td></tr><tr><td align="center">stationID</td><td align="center">int</td><td>정류장 ID</td></tr><tr><td align="center">x</td><td align="center">double</td><td>정류장 x좌표(경위도)</td></tr><tr><td align="center">y</td><td align="center">double</td><td>정류장 y좌표(경위도)</td></tr><tr><td align="center">lane</td><td align="center">확장노드</td><td>정류장의 버스 노선 리스트</td></tr><tr><td align="center">busNo</td><td align="center">string</td><td>버스노선 번호</td></tr><tr><td align="center">type</td><td align="center">int</td><td>버스노선 종류<br>(문서하단 버스노선타입 참조)</td></tr><tr><td align="center">busID</td><td align="center">int</td><td>버스노선 ID</td></tr><tr><td align="center">busStartPoint</td><td align="center">string</td><td>버스노선 기점</td></tr><tr><td align="center">busEndPoint</td><td align="center">string</td><td>버스노선 종점</td></tr><tr><td align="center">busFirstTime</td><td align="center">string</td><td>첫차시간</td></tr><tr><td align="center">busLastTime</td><td align="center">string</td><td>막차시간</td></tr><tr><td align="center">busInterval</td><td align="center">string</td><td>운행간격(분) or 운행횟수(#1)</td></tr><tr><td align="center">busCityCode</td><td align="center">int</td><td>운수회사 승인 도시코드</td></tr><tr><td align="center">busCityName</td><td align="center">string</td><td>운수회사 승인 도시이름</td></tr><tr><td align="center">busLocalBlID</td><td align="center">string</td><td>각 지역 버스노선 ID</td></tr><tr><td align="center">localStationID</td><td align="center">string</td><td>각 지역 버스정류장 ID</td></tr><tr><td align="center">stationCityCode</td><td align="center">int</td><td>정류장의 도시코드</td></tr><tr><td align="center">arsID</td><td align="center">string</td><td>정류장 고유번호</td></tr><tr><td align="center">do</td><td align="center">string</td><td>정류장주소 도</td></tr><tr><td align="center">gu</td><td align="center">string</td><td>정류장주소 구</td></tr><tr><td align="center">dong</td><td align="center">string</td><td>정류장주소 동</td></tr><tr><td align="center">real</td><td align="center">확장노드</td><td>실시간 버스 도착정보</td></tr><tr><td align="center">routeID</td><td align="center">string</td><td>버스노선 코드</td></tr><tr><td align="center">routeNm</td><td align="center">string</td><td>버스번호</td></tr><tr><td align="center">updownFlag</td><td align="center">string</td><td>상하행 구분<br>(1:상행, 2:하행)</td></tr><tr><td align="center">localRouteId</td><td align="center">string</td><td>각 지역 버스노선 ID</td></tr><tr><td align="center">arrival1</td><td align="center">확장노드</td><td>첫번째 버스 도착정보</td></tr><tr><td align="center">busPlateNo</td><td align="center">string</td><td>첫번째 버스 번호판 정보</td></tr><tr><td align="center">leftStation</td><td align="center">int</td><td>첫번째 버스 남은 정류장 수</td></tr><tr><td align="center">arrivalSec</td><td align="center">int</td><td>첫번째 버스 도착예정시간(초)</td></tr><tr><td align="center">busStatus</td><td align="center">string</td><td>버스 운행(대기) 상태<br>(1:운행중, 2:차고지대기, 3:회차지대기, 이 외:운행종료)</td></tr><tr><td align="center">endBusYn</td><td align="center">string</td><td>막차버스 여부<br>(Y:막차버스, N:일반버스)</td></tr><tr><td align="center">lowBusYn</td><td align="center">string</td><td>저상버스 여부<br>(Y:저상버스, N:일반버스)</td></tr><tr><td align="center">fulCarAt</td><td align="center">string</td><td>만차 여부<br>(0:만차 아님, 1:만차)</td></tr><tr><td align="center">arrival2</td><td align="center">확장노드</td><td>두번째 버스 도착정보</td></tr><tr><td align="center">busPlateNo</td><td align="center">string</td><td>두번째 버스 번호판 정보</td></tr><tr><td align="center">leftStation</td><td align="center">int</td><td>두번째 버스 남은 정류장 수</td></tr><tr><td align="center">arrivalSec</td><td align="center">int</td><td>두번째 버스 도착예정시간(초)</td></tr><tr><td align="center">busStatus</td><td align="center">string</td><td>버스 운행(대기) 상태<br>(1:운행중, 2:차고지대기, 3:회차지대기, 이 외:운행종료)</td></tr><tr><td align="center">endBusYn</td><td align="center">string</td><td>막차버스 여부<br>(Y:막차버스, N:일반버스)</td></tr><tr><td align="center">lowBusYn</td><td align="center">string</td><td>저상버스 여부<br>(Y:저상버스, N:일반버스)</td></tr><tr><td align="center">fulCarAt</td><td align="center">string</td><td>만차 여부<br>(0:만차 아님, 1:만차)</td></tr></tbody></table>

### Response Sample

```json
{
	"result": {
		"real": [
			{
				"routeId": "1187",
				"updownFlag": "2",
				"localRouteId": "100100094",
				"arrival1": {
					"fulCarAt": "0",
					"busPlateNo": "서울70사7956",
					"waitStatus": "1",
					"busStatus": "1",
					"endBusYn": "N",
					"leftStation": 3,
					"lowBusYn": "N",
					"arrivalSec": 212
				},
				"routeNm": "641"
			},
			{
				"routeId": "1210",
				"updownFlag": "1",
				"arrival2": {
					"fulCarAt": "0",
					"busPlateNo": "서울70사7906",
					"waitStatus": "1",
					"busStatus": "1",
					"endBusYn": "N",
					"leftStation": 8,
					"lowBusYn": "N",
					"arrivalSec": 845
				},
				"localRouteId": "100100303",
				"arrival1": {
					"fulCarAt": "0",
					"busPlateNo": "서울75사1110",
					"waitStatus": "1",
					"busStatus": "1",
					"endBusYn": "N",
					"leftStation": 3,
					"lowBusYn": "N",
					"arrivalSec": 309
				},
				"routeNm": "6625"
			}
		]
	}
}
```


---

# 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-arrival-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.