Guide | TMAP 대중교통 API

API URL

							https://apis.openapi.sk.com/transit/routes/sub

Basic Information

Name	Description
Protocol /HTTP Method	Post Method
Pre-Conditions	1) The Accept value of RequestHeader supports the following values. application / json : Data response in json format. (Default) application / xml : Data response in xml format.
OAuth	NO

Request

Parameters

Name	Data Type	Mandatory	Example	Default	Description
startX	String	Y	126.9264931	내용이 없습니다.	출발지 좌표(경도) WGS84
startY	String	Y	37.61344364	내용이 없습니다.	출발지 좌표(위도) WGS84
endX	String	Y	127.1269368	내용이 없습니다.	도착지 좌표(경도) WGS84
endY	String	Y	37.50041988	내용이 없습니다.	도착지 좌표(위도) WGS84
format	String	N	내용이 없습니다.	json	출력포맷(json, xml)
count	int	N	내용이 없습니다.	10	최대 응답 결과 개수 1 ~ 10 기본값 10
searchDttm	String	N	202301011200	내용이 없습니다.	타임머신 기능 검색 날짜 yyyymmddhhmi 타임머신 요청 시간 범위 년 (4자리) = 1900 ~ 9999 월 (2자리) = 01 ~ 12 일 (2자리) = 01 ~ 31 시 (2자리) = 00 ~ 23 분 (2자리) = 00 ~ 59

Request Sample - Code type : application/json

									
{
	"startX": "127.02550910860451",
	"startY": "37.63788539420793",
	"endX": "127.030406594109",
	"endY": "37.609094989686",
	"count" : 1,
	"format":"json"
}

Response

Parameters

Name	Data Type	Mandatory	Example	Description
metaData	node	내용이 없습니다.	내용이 없습니다.	내용이 없습니다.
Plan	node	내용이 없습니다.	내용이 없습니다.	내용이 없습니다.
itineraries	node	내용이 없습니다.	내용이 없습니다.	데이터 상세정보 최상위 노드
pathType	int	내용이 없습니다.	내용이 없습니다.	경로 탐색 결과 종류 1-지하철, 2-버스, 3-버스+지하철 4-고속/시외버스, 5-기차, 6-항공, 7-해운
totalTime	int	내용이 없습니다.	내용이 없습니다.	총 소요시간(sec)
transferCount	int	내용이 없습니다.	내용이 없습니다.	환승횟수
totalWalkDistance	int	내용이 없습니다.	내용이 없습니다.	총 보행자 이동 거리(m)
totalDistance	int	내용이 없습니다.	내용이 없습니다.	총 이동거리(m)
totalWalkTime	int	내용이 없습니다.	내용이 없습니다.	총 보행자 소요시간(sec)
fare	node	내용이 없습니다.	내용이 없습니다.	금액 최상위 노드
regular	node	내용이 없습니다.	내용이 없습니다.	금액 상위 노드
currency	node	내용이 없습니다.	내용이 없습니다.	금액 상위 노드
symbol	string	내용이 없습니다.	내용이 없습니다.	금액 상징(￦)
currency	string	내용이 없습니다.	내용이 없습니다.	금액 단위(원)
currencyCode	string	내용이 없습니다.	내용이 없습니다.	금액 단위 코드(KRW)
totalFare	number	내용이 없습니다.	내용이 없습니다.	대중교통요금
requestParameters	node	내용이 없습니다.	내용이 없습니다.	내용이 없습니다.
reqDttm	string	내용이 없습니다.	내용이 없습니다.	요청 시각 yyyymmddhhmiss
startX	string	내용이 없습니다.	내용이 없습니다.	출발지 좌표(경도) WGS84
startY	string	내용이 없습니다.	내용이 없습니다.	출발지 좌표(위도) WGS84
endX	string	내용이 없습니다.	내용이 없습니다.	도착지 좌표(경도) WGS84
endY	string	내용이 없습니다.	내용이 없습니다.	도착지 좌표(위도) WGS84

Response Sample - Code type : application/json

									
{
    "metaData": {
        "requestParameters": {
            "endY": "37.609095",
            "endX": "127.030407",
            "startY": "37.637885",
            "startX": "127.025509",
            "reqDttm": "20230320165954"
        },
        "plan": {
            "itineraries": [
                {
                    "fare": {
                        "regular": {
                            "totalFare": 1200,
                            "currency": {
                                "symbol": "₩",
                                "currency": "원",
                                "currencyCode": "KRW"
                            }
                        }
                    },
				"pathType": 2,
                    "totalTime": 1100,
                    "totalWalkTime": 282,
                    "transferCount": 1,
                    "totalDistance": 4343,
                    "totalWalkDistance": 282
                }
            ]
        }
    }
}

Error code index

Error Code	Message	HTTP Status Code	Description
11	출발지/도착지 간 거리가 가까움	200	출발지/도착지 간 거리가 가까워서서 탐색된 경로 없음
12	출발지 정류장 매핑 실패	200	출발지에서 검색된 정류장 없어서 탐색된 경로 없음
13	도착지 정류장 매핑 실패	200	도착지에서 검색된 정류장 없어서 탐색된 경로 없음
14	기타	200	출발지/도착지 간 탐색된 대중교통경로가 없음
21	필수 입력 값 형식 및 범위 오류	400	내용이 없습니다.
22	필수 입력 값 누락 오류	400	내용이 없습니다.
23	서비스 지역 아님	400	내용이 없습니다.
24	타임머신 시각 오류	400	타임머신 시각 입력 오류
31	일정 시간 응답이 없는 경우	500	내용이 없습니다.
32	기타 오류	500	내용이 없습니다.

TMAP 대중교통 API

DOCS

대중교통 요약정보 API