# Public Transit Route Search | Method | Request URI | Response Type | | :----: | :--------------------------------------------------: | :-----------: | | GET | | json, xml | ### Parameter | Parameter | Required | Description | Sample | | :------------: | :------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------: | | key | Y | Your API Key | key=xxxxxxxxxxx | | lang | N |

Select Result Language

(Korean: 0, English: 1, Japanese: 2, Chinese (simplified): 3, Chinese (traditional): 4, Vietnamese: 5)

default = 0

| lang=0 | | output | N |

Output format (json, xml)

default = json

| output=json | | SX | Y | Origin longitude | SX=126.896038 | | SY | Y | Origin latitude | SY=37.482901 | | EX | Y | Destination longitude | EX=127.8906596 | | EY | Y | Destination latitude | EY=37.4866369 | | OPT | N |

Path search result sorting method

0: Recommended path

1: sorted by type

ex) subway, bus, bus+ subway, subway+ bus, bus+ subway+ bus

| OPT=0 | | SearchType | N | Select Intercity/In-City Movement. | A search is performed for intra-city movement/intercity movement. Search in city when entering 0 (Use if there is an urban search result in an urban search) | | SearchPathType | N | Specify the route means within the city. |

0: All (default)

1: Subway

2: Buses

| ### Response | Name | Type | Description | | :----------------------: | :----: | :-----------------------------------------------------------------------------------------------------------------------------------------: | | result | node | Top node | | searchType | int |

Result classification (via city or city direct or intercity transfer)

0-In-City,

1-City Direct,

2-City Transfer

| | outTrafficCheck | int |

Intercity "direct" navigation results (Transfer X)

0-False,

1-True

| | busCount | int | Number of bus results | | subwayCount | int | Number of subway results | | subwayBusCount | int | Number of "Bus + Subway" results | | pointDistance | double | Straight distance (meters) between origin (SX, SY) and destination (EX, EY) | | startRadius | int | the radius of the starting point | | endRadius | int | a radius of destination | | path | node | Result List Extension Node | | pathType | int |

Result Type

1-subway,

2-bus,

3-bus+subway

| | info | node | Summary Information Extension Node | | trafficDistance | double | Total distance traveled except on foot | | totalWalk | int | Total walking distance | | totalTime | int | Total time required | | payment | int | a total charge | | busTransitCount | int | Bus transfer count | | subwayTransitCount | int | a subway transfer count | | mapObj | string | Parameter values for invoking the interpolation point API | | firstStartStation | string | an initial departure/stop | | lastEndStation | string | a final station/stop | | totalStationCount | int | Total stops count | | busStationCount | int | Total bus stops | | subwayStationCount | int | the sum of the subway stops | | totalDistance | double | a total distance | | subPath | node | Transportation Information Extension Node | | trafficType | int |

Types of transportation (walk, bus, subway)

1-subway,

2-bus,

3-walk

| | distance | double | travel distance | | sectionTime | int | Time to travel | | stationCount | int | Number of stops moving to and from (required for subways and buses only) | | lane | node | Transportation Information Extension Node | | name | string | Name of subway line (required only for subways) | | busNo | string | Bus number (required only for buses) | | type | int | Bus type (required only for buses, see bottom) | | busID | int | Bus code (required only for buses) | | busLocalBlID | string | Bus route ID for each region (required only for BIS-provided areas) | | busCityCode | int | Transportation company approved city code (required only for buses) | | busProviderCode | int | BIS code (required only for BIS delivery areas) | | subwayCode | int | Subway line number (required only for subways) | | subwayCityCode | int | Subway city code (required only for subways) | | startName | string | a stop/station name | | startX | double | Ride stop/station X coordinates | | startY | double | Ride stop/station Y coordinates | | endName | string | a stop/station name | | endX | double | Drop-off stop/station X coordinates | | endY | double | Drop-off stop/reverse Y coordinates | | way | string | Directional information (required only for subways) | | wayCode | int |

Directional information code (required only for the first route of the subway)

1 up,

2 down

| | door | string | Rapid subway transfer location (required only for subways) | | startID | int | Departure stop/station code | | startStationCityCode | int | Departure stop city code (required only for buses) | | startStationProviderCode | int | Departure stop BIS code (required only for BIS-provided areas) | | startLocalStationID | string | Departure stop ID for each region (required only for BIS-provided areas) | | startArsID | string | Unique number of each local departure stop (required only for BIS-provided areas) | | endID | int | Arrival stop/station code | | endStationCityCode | int | Arrival stop city code (required only for buses) | | endStationProviderCode | int | Arrival stop BIS code (required only for BIS-provided areas) | | endLocalStationID | string | Arrival stop ID for each region (required only for BIS-provided areas) | | endArsID | string | Unique number of each local arrival stop (required only for BIS-provided areas) | | startExitNo | string | subway exit number (Used only for subways, but may not have that tag.) | | startExitX | double | Exit X coordinates for subway entry (only used for subways but may not have the corresponding tag) | | startExitY | double | Exit Y coordinates for subway (only used for subway but may not have the corresponding tag) | | endExitNo | string | Exit number of the subway (only used for subways but may not have the corresponding tag) | | endExitX | double | Exit X coordinates of subway exit (only used for subway but may not have the corresponding tag) | | endExitY | double | Exit Y coordinates of subway exit (only used for subway but may not have the corresponding tag) | | passStopList | node | Route Detail Section Information Extension Node (available in Korean only) | | stations | node | Stop Information Group Node | | index | int | the order of stops | | stationID | int | station ID | | stationName | string | stationName | | stationCityCode | int | Stop city code (required only for buses) | | stationProviderCode | int | BIS code (required only for BIS delivery areas) | | localStationID | string | Local stop ID (required only for BIS-provided areas) | | arsID | string | Unique number of each local stop (required only for BIS-provided areas) | | x | string | Station X coordinates | | y | string | Station Y coordinates | | isNonStop | string | Unstalled stop Y/N (required only for buses) | ### Response Sample ```json { "result": { "searchType": 0, "outTrafficCheck": 0, "busCount": 7, "subwayCount": 1, "subwayBusCount": 5, "pointDistance": 24046, "startRadius": 700, "endRadius": 700, "path": [ { "pathType": 3, "info": { "trafficDistance": 29882, "totalWalk": 1316, "totalTime": 89, "payment": 1650, "busTransitCount": 1, "subwayTransitCount": 1, "mapObj": "1123:1:43:52@11:2:137:116", "firstStartStation": "구로디지털단지역", "lastEndStation": "방학", "totalStationCount": 31, "busStationCount": 9, "subwayStationCount": 22, "totalDistance": 31198, "totalWalkTime": -1 }, "subPath": [ { "trafficType": 3, "distance": 592, "sectionTime": 9 }, { "trafficType": 2, "distance": 4082, "sectionTime": 17, "stationCount": 9, "lane": [ { "busNo": "5531", "type": 12, "busID": 1123, "busLocalBlID": "100100265", "busCityCode": 1000, "busProviderCode": 4 } ], "startName": "구로디지털단지역", "startX": 126.90256, "startY": 37.484078, "endName": "대방역", "endX": 126.92635, "endY": 37.512554, "startID": 126473, "startStationCityCode": 1000, "startStationProviderCode": 4, "startLocalStationID": "120000001", "startArsID": "21-001", "endID": 103278, "endStationCityCode": 1000, "endStationProviderCode": 4, "endLocalStationID": "119000022", "endArsID": "20-108", "passStopList": { "stations": [ { "index": 0, "stationID": 126473, "stationName": "구로디지털단지역", "stationCityCode": 1000, "stationProviderCode": 4, "localStationID": "120000001", "arsID": "21-001", "x": "126.90256", "y": "37.484078", "isNonStop": "N" }, { "index": 1, "stationID": 126478, "stationName": "동작상떼빌아파트", "stationCityCode": 1000, "stationProviderCode": 4, "localStationID": "119000001", "arsID": "20-001", "x": "126.904537", "y": "37.486503", "isNonStop": "N" } ] } } ] } ] } } ``` --- # 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/routing/public-transit-route-search.md?ask= ``` 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.