개발가이드
ODsay 대중교통 API 를 이용해 멋진 대중교통 애플리케이션을 만들어 보세요.

버스노선 조회

버스노선 리스트를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/searchBusLane json

• 파라미터

번호 파라미터 필수값 설명 예시
1 busNo Y 조회할 버스노선번호 busNo=150
2 CID N 도시코드 CID=1000
3 stationListYn N 주요정류장 표현 옵션(default:no) stationListYn=no
4 displayCnt N 리턴 결과 개수 displayCnt=10
5 startNO N 결과 개수 중 시작번호 startNO=1

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장 노드 Y 1 데이터를 포함하는 최상위 노드
1-1 totalCount int Y 1 데이터를 포함하는 최 상위 노드
1-2 totalCityList 확장 노드 Y 1 도시 리스트
1-2-1 includeCity 확장 노드 Y 1...n 도시 리스트
1-2-1-1 CID int Y 1 도시코드
1-2-1-2 cityName string Y 1 도시명
1-3 lane 확장 노드 Y 1...n 버스노선 정보 리스트
1-3-1 busNo string Y 1 버스번호
1-3-2 busID int Y 1 버스노선ID
1-3-3 localBusID string Y 1 각 지역버스노선 ID
수도권 : busCityCode가 1000 인 경우
서울, 그 외에는 경기 실시간 사용
울산시 : 노선하나에 상행노선ID, 하행노선ID 모두제공
Ex) 상행ID/하행ID 형태.
1-3-4 type int Y 1 버스노선 종류
문서하단 버스노선타입 참조
1-3-5 busCityName string Y 1 운수회사 승인 도시이름
1-3-6 busCityCode int Y 1 운수회사 승인 도시코드
1-3-7 busStartPoint string Y 1 버스노선 기점
1-3-8 busEndPoint string Y 1 버스노선 종점
1-3-9 busFirstTime string Y 1 첫차시간
1-3-10 busLastTime string Y 1 막차시간
1-3-11 busInterval string Y 1 운행간격(분) or 운행횟수(#1)
1-3-12 mainBusStop string N 1 주요 버스정류장
1-3-13 bus_Ep_FirstTime string Y 1 종점기준 첫차
1-3-14 bus_Ep_LastTime string Y 1 종점기준 막차
1-3-15 bus_Interval_Week string Y 1 평일 배차간격
1-3-16 bus_Interval_Sat string Y 1 토요일 배차간격
1-3-17 bus_Interval_Sun string Y 1 일요일(공휴일) 배차간격
1-3-18 busCompanyNameKor string Y 1 운수회사명
1-3-19 busCompanyID string Y 1 운수회사ID

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

버스노선 상세정보 조회

특정 버스노선의 운행경로에 대한 정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/busLaneDetail json

• 파라미터

번호 파라미터 필수값 설명 예시
1 busID Y 운행경로를 조회할 버스노선코드 busID=12018

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장 노드 Y 1 데이터를 포함하는 최상위노드
1-1 busID int Y 1 버스노선코드
1-2 busNo string Y 1 버스번호
1-3 type int Y 1 버스노선 종류
문서하단 버스노선타입 참조.
1-4 busCityName string Y 1 운수회사 승인 도시이름
1-5 busCityCode int Y 1 운수회사 승인 도시코드
1-6 busStartPoint string Y 1 버스노선 기점
1-7 busEndPoint string Y 1 버스노선 종점
1-8 busFirstTime string Y 1 첫차시간
1-9 busLastTime string Y 1 막차시간
1-10 busInterval string Y 1 운행간격(분) or 운행횟수(#1)
1-11 busTotalDistance int Y 1 버스노선 전체 운행거리
1-12 bus_Ep_FirstTime string Y 1 종점기준 첫차
1-13 bus_Ep_LastTime string Y 1 종점기준 막차
1-14 bus_Interval_Week string Y 1 평일 배차간격
1-15 bus_Interval_Sat string Y 1 토요일 배차간격
1-16 bus_Interval_Sun string Y 1 일요일(공휴일) 배차간격
1-17 bus_Interval_Rushhour string Y 1 출퇴근시간 배차간격
1-18 busLocalBlID string Y 1 각 지역 버스노선 ID
1-19 station 확장노드 Y 1...n 정류장 리스트
1-19-1 idx int Y 1 정류장순번
1-19-2 stationID int Y 1 정류장 ID
1-19-3 stationName string Y 1 정류장 이름
1-19-4 stationDistance long Y 1 정류장간 누적거리
(현재정류장에서 다음정류장까지)
1-19-5 stationDirection int Y 1 상하행 구분코드
(0:없음,1:하행,2:상행)
1-19-6 arsID string Y 1 정류장 고유번호
(0:없음)
1-19-7 x double Y 1 정류장 x좌표(경위도)
1-19-8 y double Y 1 정류장 y좌표(경위도)
1-19-9 localStationID string Y 1 정류장 LocalID

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

버스정류장 세부 정보 조회

특정 버스정류장의 정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/busStationInfo json

• 파라미터

번호 파라미터 필수값 설명 예시
1 stationID Y 정류장 정보를 조회할 정류장코드 stationID=107475

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 stationName double Y 1 정류장 이름
1-2 stationID int Y 1 정류장 ID
1-3 x double Y 1 정류장 x좌표(경위도)
1-4 y double Y 1 정류장 y좌표(경위도)
1-5 lane 확장노드 Y 1...n 정류장의 버스 노선 리스트
1-5-1 busNo string Y 1 버스노선 번호
1-5-2 type int Y 1 버스노선 종류
(문서하단 버스노선타입 참조)
1-5-3 busID int Y 1 버스노선 ID
1-5-4 busStartPoint string Y 1 버스노선 기점
1-5-5 busEndPoint string Y 1 버스노선 종점
1-5-6 busFirstTime string Y 1 첫차시간
1-5-7 busLastTime string Y 1 막차시간
1-5-8 busInterval string Y 1 운행간격(분) or 운행횟수(#1)
1-5-9 busCityCode int Y 1 운수회사 승인 도시코드
1-5-10 busCityName string Y 1 운수회사 승인 도시이름
1-5-11 busLocalBlID string Y 1 각 지역 버스노선 ID
1-6 localStationID string Y 1 각 지역 버스정류장 ID
1-7 arsID string Y 1 정류장 고유번호
1-8 do string Y 1 정류장주소 도
1-9 gu string Y 1 정류장주소 구
1-10 dong string Y 1 정류장주소 동

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

열차/KTX 운행정보 검색

열차·KTX 운행정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/trainServiceTime json

• 파라미터

번호 파라미터 필수값 설명 예시
1 startStationID Y 역 ID startStationID=3300128
2 endStationID Y 역 ID endStationID=3300108

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 count int Y 1 검색결과 개수
1-2 startStationID int Y 1 출발역ID
1-3 startStationName string Y 1 출발역명
1-4 endStationID int Y 1 도착역ID
1-5 endStationName string Y 1 도착역명
1-6 station 확장노드 Y 1...n 상위노드
1-6-1 railName string Y 1 노선명(경부선, 호남선 등)
1-6-2 trainClass string Y 1 열차종류(KTX, 무궁화, 새마을, 누리로, 통근)
1-6-3 trainNo int Y 1 열차번호
1-6-4 departureTime string Y 1 출발시간
1-6-5 arrivalTime string Y 1 도착시간
1-6-6 wasteTime string Y 1 소요시간
1-6-7 runDay string Y 1 운행일
ex) 토 / 금토일 / 토일 /
화수목금토일 / 월화수목토일/
금 / 금토 / 금일 / 월 / 매일/
월화수목금토
1-6-8 generalFare 확장노드 Y 1 일반 요금
1-6-8-1 weekday string N 1 평일
1-6-8-2 weekend string N 1 주말
1-6-8-3 holiday string N 1 공휴일
1-6-9 specialFare 확장노드 Y 1 특실 요금
1-6-9-1 weekday string N 1 평일
1-6-9-2 weekend string N 1 주말
1-6-9-3 holiday string N 1 공휴일
1-6-10 standingFare 확장노드 Y 1 입석/자유석 요금
1-6-10-1 weekday string N 1 평일
1-6-10-2 weekend string N 1 주말
1-6-10-3 holiday string N 1 공휴일
1-6-11 fare string Y 1 요금
1-6-11-1 general string N 1 일반요금
1-6-11-2 special string N 1 특실요금
1-6-11-3 standing string N 1 입석/자유석 요금

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

고속버스 운행정보 검색

고속버스 운행정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/expressServiceTime json

• 파라미터

번호 파라미터 필수값 설명 예시
1 startStationID Y 터미널 ID startStationID=4000057
2 endStationID Y 터미널 ID endStationID=4000030

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 count int Y 1 검색결과 개수
1-2 startStationID int Y 1 출발역ID
1-3 endStationID int Y 1 도착역ID
1-4 station 확장노드 Y 1...n 상위노드
1-4-1 startTerminal string Y 1 출발 터미널명
1-4-2 destTerminal string Y 1 도착 터미널명
1-4-3 wasteTime string Y 1 소요시간
1-4-4 normalFare string Y 1 일반버스 요금
1-4-5 specialFare string Y 1 우등버스 요금
1-4-6 nightFare string Y 1 심야버스 요금
1-4-7 nightSpecialFare string Y 1 심야 우등버스 요금
1-4-8 schedule string Y 1 운행시간표
1-4-9 nightSchedule string Y 1 심야 운행시간표

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

시외버스 운행정보 검색

시외버스 운행정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/intercityServiceTime json

• 파라미터

번호 파라미터 필수값 설명 예시
1 startStationID Y 터미널 ID startStationID=4000022
2 endStationID Y 터미널 ID endStationID=4000255

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 count int Y 1 검색결과 개수
1-2 startStationID int Y 1 출발역ID
1-3 endStationID int Y 1 도착역ID
1-4 station 확장노드 Y 1...n 상위노드
1-4-1 startTerminal string Y 1 출발 터미널명
1-4-2 destTerminal string Y 1 도착 터미널명
1-4-3 firstTime string Y 1 첫차시간
1-4-4 lastTime string Y 1 막차시간
1-4-5 interval string Y 1 운행횟수/운행간격(두값중 하나만 존재)
ex) 10/0:00 : 일 10회 운행
0/1:30 : 1:30분 간격
1-4-6 wasteTime string Y 1 소요시간
1-4-7 normalFare string Y 1 일반버스 요금
1-4-8 nightFare string Y 1 심야버스 요금
1-4-9 schedule string Y 1 운행시간표
1-4-10 nightSchedule string Y 1 심야 운행시간표

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

항공 운행정보 검색

항공 운행정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/airServiceTime json

• 파라미터

번호 파라미터 필수값 설명 예시
1 startStationID Y 출발 공항 ID startStationID=3500001
2 endStationID Y 도착 공항 ID endStationID=3500003
3 selectTime N 출발시간(정해진 시간이후의 정보만 표출) 기본값은 6이다.
6~21까지 입력가능.
selectTime=6

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 count int Y 1 검색결과 개수
1-2 startStationID int Y 1 출발 공항 ID
1-3 startStationName string Y 1 출발 공항명
1-4 endStationID int Y 1 도착 공항 ID
1-5 endStationName string Y 1 도착 공항명
1-6 station 확장 노드 Y 1...n 상위노드
1-6-1 airline string Y 1 항공사
1-6-2 departureTime string Y 1 출발시각
1-6-3 arrivalTime string Y 1 도착시각
1-6-4 flight string Y 1 편명
1-6-5 runDay string Y 1 운항일

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

운수회사별 버스노선 조회

운수회사별 버스노선를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/searchByCompany json

• 파라미터

번호 파라미터 필수값 설명 예시
1 companyID Y 조회할 운수회사 ID companyID=792
2 busNo N 조회할 버스노선번호 busNo=100

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 lane 확장노드 Y 1...n 버스노선 정보 리스트
1-1-1 busNo string Y 1 버스번호
1-1-2 busID int Y 1 버스노선 ID
1-1-3 localBusID string Y 1 각 지역버스노선 ID
(수도권 : busCityCode : 1000 -> 서울
그 외에는 경기 실시간 사용)
1-1-4 type int Y 1 버스노선 종류
문서하단 버스노선타입 참조
1-1-5 busCityName string Y 1 운수회사 승인 도시이름
1-1-6 busCityCode int Y 1 운수회사 승인 도시코드
1-1-7 busStartPoint string Y 1 버스노선 기점
1-1-8 busEndPoint string Y 1 버스노선 종점
1-1-9 busFirstTime string Y 1 첫차시간
1-1-10 busLastTime string Y 1 막차시간
1-1-11 busInterval string Y 1 운행간격(분) or 운행횟수(#1)

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

지하철역 세부 정보 조회

지하철역 세부 정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/subwayStationInfo json

• 파라미터

번호 파라미터 필수값 설명 예시
1 stationID Y 지하철 역 정보를 조회 할 역코드 stationID=130

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 stationName string Y 1 지하철역 명
1-2 stationID int Y 1 지하철역 ID
1-3 type int Y 1 노선종류
문서하단 지하철노선타입 참조
1-4 laneName string Y 1 노선명
1-5 laneCity string Y 1 노선지역명
1-6 x double Y 1 x좌표(경위도)
1-7 y double Y 1 y좌표(경위도)
1-8 exOBJ 확장노드 N 0...1 환승역 리스트
1-8-1 station string N 0...n 환승역
1-8-1-1 stationName string N 1 환승역 명
1-8-1-2 stationID int N 1 환승역ID
1-8-1-3 type int N 1 노선종류
* 지하철노선
1-8-1-4 laneName string N 1 노선명
1-8-1-5 laneCity string N 1 노선지역명
1-9 prevOBJ 확장 노드 N 0...1 이전역 리스트
1-9-1 station 확장 노드 N 1...n 이전역
1-9-1-1 stationName string N 1 역 명
1-9-1-2 stationID int N 1 역 ID
1-9-1-3 type int Y 1 노선종류
* 지하철노선
1-9-1-4 laneName string N 1 노선명
1-9-1-5 laneCity string N 1 노선지역명
1-9-1-6 x double N 1 x좌표(경위도)
1-9-1-7 y double N 1 y좌표(경위도)
1-10 nextOBJ 확장 노드 N 0...1 다음역 리스트
1-10-1 station 확장 노드 N 0…n 다음역
1-10-1-1 stationName string N 1 역 명
1-10-1-2 stationID int N 1 역ID
1-10-1-3 type int N 1 노선종류
* 지하철노선
1-10-1-4 laneName string N 1 노선명
1-10-1-5 laneCity string N 1 노선지역명
1-10-1-6 x double N 1 x좌표(경위도)
1-10-1-7 y double N 1 y좌표(경위도)
1-11 defaultInfo 확장 노드 Y 1 기본 역 정보
1-11-1 address string Y 1 역 주소
1-11-2 new_address string Y 1 도로명 주소
1-11-3 tel string Y 1 역 전화번호
1-12 useInfo 확장 노드 Y 1 이용정보
1-12-1 platform int Y 1 플랫폼
(0:기타, 1:중앙, 2:양쪽, 3:복선(국 철), 4:일방향)
1-12-2 meetingPlace int Y 1 만남의 장소
(0:없음, 1:있음)
1-12-3 restroom int Y 1 화장실
(0:없음, 1:안쪽, 2:바깥, 3:환승역연 결, 4:안쪽,바깥쪽)
1-12-4 offDoor int Y 1 내리는 문 위치
(0:왼쪽, 1:오른쪽, 2:양쪽)
1-12-5 crossOver int Y 1 반대편 횡단
(0:기타, 1:연결안됨, 2:연결됨, 3:환승역연결)
1-12-6 publicPlace int Y 1 현장 사무소
(0:없음, 1:있음)
1-12-7 handicapCount int Y 1 장애인편의시설
(0:없음, 1:있음)
1-12-8 parkingCount int Y 1 환승주차장
(0:없음, 1:있음)
1-12-9 bicycleCount int Y 1 자전거보관소
(0:없음, 1:있음)
1-12-10 civilCount int Y 1 민원안내 (0:없음, 1:있음)
1-13 exitInfo 확장노드 Y 1 출구정보
1-13-1 gate 확장 노드 Y 1...n 출구
1-13-1-1 gateNo string Y 1 출구번호
1-13-1-2 gateLink string Y 1 주요명칭
1-13-1-3 BUSSTOP 확장노드 N 1...n 출구별 버스정류장 정보
1-13-1-3-1 StopName string Y 1 버스정류장명칭
1-13-1-3-2 StopID string Y 1 버스정류장ID
1-13-1-3-3 Bus 확장노드 Y 1...n 버스노선정보 그룹노드
1-13-1-3-3-1 BusNo string Y 1 버스노선 번호
1-13-1-3-3-2 Type string Y 1 버스노선 타입
1-13-1-3-3-3 BlID string Y 1 버스노선 ID
1-13-1-3-3-4 BusCityName string Y 1 운수회사 승인 도시 이름
1-14 CityCode string Y 1 도시코드

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

지하철역 전체 시간표 조회

지하철역 전체 시간표를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/subwayTimeTable json

• 파라미터

번호 파라미터 필수값 설명 예시
1 stationID Y 지하철역 시간표 정보를 조회 할 역코드 stationID=130
2 wayCode N 지하철역 방면 코드
(1:상행, 2:하행)
wayCode=1

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 stationName string Y 1 지하철역 명
1-2 stationID int Y 1 지하철역 ID
1-3 type int Y 1 노선종류
문서하단 지하철노선타입 참조
1-4 laneName string Y 1 노선명
1-5 laneCity string Y 1 노선지역명
1-6 upWay string Y 1 상행방향
1-7 downWay string Y 1 하행방향
1-8 OrdList 확장 노드 Y 1 평일 시간 리스트
1-8-1 up 확장노드 N 0...1 상행선 시간 리스트
1-8-1-1 time 확장 노드 Y 1 시간별 시간 data 리스트
1-8-1-1-1 Idx int Y 1 시간
(5~25시 까지 , 25는 1시)
1-8-1-1-2 list string Y 1 시간 data
1-8-2 down 확장 노드 N 0...1 하행선 시간 리스트
1-8-2-1 time 확장 노드 Y 1 시간별 시간 data 리스트
1-8-2-1-1 Idx int Y 1 시간
(5~25시 까지 , 25는 1시)
1-8-2-1-2 list string Y 1 시간 data
1-9 SatList 확장 노드 Y 1 토요일 시간 리스트
1-9-1 up 확장 노드 N 0...1 상행선 시간 리스트
1-9-1-1 time 확장 노드 Y 1 시간별 시간 data 리스트
1-9-1-1-1 Idx int Y 1 시간
(5~25시 까지 , 25는 1시)
1-9-1-1-2 list string Y 1 시간 data
1-9-2 down 확장노드 N 0...1 하행선 시간 리스트
1-9-2-1 time 확장노드 Y 1 시간별 시간 data 리스트
1-9-2-1-1 Idx int Y 1 시간
(5~25시 까지 , 25는 1시)
1-9-2-1-2 list string Y 1 시간 data
1-10 SunList 확장노드 Y 1 일요일 시간 리스트
1-10-1 up 확장노드 N 0...1 상행선 시간 리스트
1-10-1-1 time 확장노드 Y 1 시간별 시간 data 리스트
1-10-1-1-1 Idx int Y 1 시간
(5~25시 까지 , 25는 1시)
1-10-1-1-2 list string Y 1 시간 data
1-10-2 down 확장노드 N 0...1 하행선 시간 리스트
1-10-2-1 time 확장노드 Y 1 시간별 시간 data 리스트
1-10-2-1-1 Idx int Y 1 시간
(5~25시 까지 , 25는 1시)
1-10-2-1-2 list string Y 1 시간 data

콘솔에서 예시 확인하기»

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

노선 그래픽 데이터 검색

구간에 대한 노선 경로 정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/loadLane json

• 파라미터

번호 파라미터 필수값 설명 예시
1 mapObject Y 경로를 조회할 코드
경로검색시 나오는 mapOBJ값 형식
BaseX:BaseY@ID:Class:StartIdx:EndIdx@...@ID:Class:StartIdx:EndIdx

BaseX:BaseY : 데이터 기준점이 값이 빼진 값으로 좌표가 리턴됨
ID : (버스노선ID 또는 지하철노선ID)
Class : 1(버스), 2(지하철)
StartIdx : 출발인덱스
EndIdx : 도착인덱스

전체노선 호출시 StartIdx, EndIdx 는 -1
예) 126:37@3:2:310:329 (수도권 지하철 3호선 310에서 319까지 구간)
126:37@2:2:-1:-1 (수도권 지하철 2호선 전체)
mapObject=0:0@12018:1:-1:-1

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 lane 확장노드 Y 1...n 요청된 lane 리스트
1-1-1 class double Y 1 1(버스노선), 2(지하철노선)
1-1-2 type int Y 1 노선종류
문서하단 버스노선, 지하철노선 타입 참조
1-1-3 section 확장노드 Y n section 리스트
1-1-3-1 graphPos 확장 노드 Y 1...n 좌표 리스트
1-1-3-1-1 x double Y 1 x좌표(경위도)
1-1-3-1-2 y double Y 1 y좌표(경위도)
1-2 boundary 확장 노드 Y 1 좌표의 rectangle
Load된 노선들에 대한 경계값
1-2-1 left double Y 1 Left 좌표
1-2-2 top double Y 1 Top 좌표
1-2-3 right double Y 1 Right 좌표
1-2-4 bottom double Y 1 Bottom 좌표

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

대중교통 정류장 검색

대중교통 정류장 세부정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/searchStation json

• 파라미터

번호 파라미터 필수값 설명 예시
1 stationName Y 정류장을 검색 할 이름(2자 이상) stationName=11
2 CID N 도시코드 CID=1000
3 stationClass N 정류장 종류(여러 개 선택 가능)
1:2 (default)
1 : 버스정류장
2 : 지하철역
3 : 기차역
4 : 고속버스터미널
5 : 공항
6 : 시외버스터미널
7 : 항만
stationClass=1:2
4 displayCnt N 리턴 결과 개수
(displayCnt와 startNO중 한 값이라도 없으면 모든 결과 표현)
displayCnt=10
5 startNO N 결과 개수 중 시작번호
(displayCnt와 startNO 중 한 값이라도 없으면 모든 결과 표현)
startNO=1
6 myLocation N 현위치 좌표 myLocation=127.0363583:37.5113295

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 totalCount int Y 1 검색 결과 개수
1-2 totalCityList 확장 노드 Y 1 도시 리스트
1-2-1 includeCity string Y 1...n 도시 리스트
1-2-1-1 CID int Y 1 도시코드
1-2-1-2 cityName string Y 1 도시명
1-3 station 확장 노드 Y 1...n 정류장 리스트
1-3-1 stationClass int Y 1 정류장 종류
1 : 버스정류장
2 : 지하철역
3 : 기차역
4 : 고속버스터미널
5 : 공항
6 : 시외버스터미널
7 : 항만
1-3-2 stationName string Y 1 정류장 이름
1-3-3 stationID int Y 1 정류장ID
1-3-4 localStationID string N 1 각 지역버스정류장 ID
- 수도권(서울,경기,인천의 경우) ARSID / 경기 지자체시스템ID /인천시 ID 구조
Ex) 89123/120000445/ICB165000355
- 경산시, 대구시의 경우 경산시 정류장ID/대구시 정류장ID 형태로 제공 됨
- 나머지 지역은 정류장 ID 단일로 제공
1-3-5 type int N 1 노선종류
문서하단 지하철 노선타입 참조
(stationClass 2 인 경우만)
1-3-6 laneName string N 1 노선명
(stationClass 2 인 경우만)
1-3-7 laneCity string N 1 노선명
(stationClass 2 인 경우만)
1-3-8 stationType int N 1 시외버스정류장 종류
(1:시외버스터미널, 2:시외버스정류소)
(stationClass 6 인 경우만)
1-3-9 x double Y 1 정류장 x좌표(경위도)
1-3-10 y double Y 1 정류장 y좌표(경위도)
1-3-11 CID int Y 1 정류장 도시코드
1-3-12 cityName string Y 1 정류장 도시이름
1-3-13 arsID string Y 1 정류장 고유번호(5자리)
ex)xx-xxx
1-3-14 do string Y 1 정류장주소 도
1-3-15 gu string Y 1 정류장주소 구
1-3-16 dong string Y 1 정류장주소 동
1-3-17 businfo 확장 노드 Y 1...n 버스 리스트
1-3-17-1 busNo string N 1 버스번호
1-3-17-2 busClass string N 1 버스타입
1-3-17-3 busLocalBlID string N 1 각 지역 버스노선 ID

콘솔에서 예시 확인하기»

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

반경내 대중교통 POI 검색

지정된 포인트와 반경을 가지고 대중교통 POI정보를 검색합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/pointSearch json

• 파라미터

번호 파라미터 필수값 설명 예시
1 x Y x좌표(경위도) x=126.933361407195
2 y Y y좌표(경위도) y=37.3643392278118
3 radius N 반경(m) (default:250) radius=250
4 stationClass N 정류장 종류(여러 개 선택 가능)
1:2 (default)
1 : 버스정류장
2 : 지하철역
3 : 기차역
4 : 고속버스터미널
5 : 공항
6 : 시외버스터미널
7 : 항만
stationClass=1:2

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 count int Y 1 대중교통 POI 개수
1-2 station 확장 노드 Y 1...n 대중교통 POI 리스트
1-2-1 stationClass int Y 1 대중교통 POI 종류
1 : 버스정류장
2 : 지하철역
3 : 기차역
4 : 고속버스터미널
5 : 공항
6 : 시외버스터미널
7 : 항만
1-2-2 stationName string Y 1 대중교통 POI 이름
1-2-3 stationID int Y 1 대중교통 POI ID
1-2-4 type int N 1 노선종류
문서하단 지하철노선타입 참조
(stationClass 2 인 경우만)
1-2-5 laneName string N 1 노선명
(stationClass 2 인 경우만)
1-2-6 laneCity string N 1 노선지역명
(stationClass 2 인 경우만)
1-2-7 stationType int N 1 시외버스정류장 종류
(1:시외버스터미널, 2:시외버스정류소)
(stationClass 6 인 경우만)
1-2-8 x double Y 1 x좌표(경위도)
1-2-9 y double Y 1 y좌표(경위도)
1-2-10 nonstopStation int Y 1 미정차정류장
(0:정차, 1:미정차)

콘솔에서 예시 확인하기»

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

지도 위 대중교통 POI 검색

지정된 영역내 대중교통 POI정보를 검색합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/boundarySearch json

• 파라미터

번호 파라미터 필수값 설명 예시
1 param Y 영역 좌표 (left:top:right:bottom)
(경위도)
Param=127.045478316811:37.68882830829:127.055063420699:37.6370465749586
2 Eparam N 제외시킬 영역좌표(left:top:right:bottom)
(경위도)
0:0:0:0(default)
Param=127.045478316811:37.68882830829:127.055063420699:37.6370465749586
3 stationClass N 정류장 종류(여러 개 선택 가능)
1:2 (default)
1 : 버스정류장
2 : 지하철역
3 : 기차역
4 : 고속버스터미널
5 : 공항
6 : 시외버스터미널
7 : 항만
stationClass=1:2

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 count int Y 1 대중교통 POI 개수
1-2 station 확장 노드 Y 1...n 대중교통 POI 리스트
1-2-1 stationClass int Y 1 대중교통 POI 종류
1 : 버스정류장
2 : 지하철역
3 : 기차역
4 : 고속버스터미널
5 : 공항
6 : 시외버스터미널
7 : 항만
1-2-2 stationName string Y 1 대중교통 POI 이름
1-2-3 stationID int Y 1 대중교통 POI ID
1-2-4 type int N 1 노선종류
문서하단 지하철노선타입 참조
(stationClass 2 인 경우만)
1-2-5 laneName string N 1 노선명
(stationClass 2 인 경우만)
1-2-6 laneCity string N 1 노선지역명
(stationClass 2 인 경우만)
1-2-7 stationType int N 1 시외버스정류장 종류
(1:시외버스터미널, 2:시외버스정류소)
(stationClass 6 인 경우만)
1-2-8 x double Y 1 x좌표(경위도)
1-2-9 y double Y 1 y좌표(경위도)

콘솔에서 예시 확인하기»

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

지하철 경로검색 조회(지하철 노선도)

지하철역 전체 시간표 정보를 리턴합니다.(급행시각포함)

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/subwayPath json

• 파라미터

번호 파라미터 필수값 설명 예시
1 CID Y 도시코드 CID=1000
2 SID Y 출발역 코드 SID=201
3 EID Y 도착역 코드 EID=222
4 Sopt N 경로검색 조건(default=1)
(1:최단거리, 2:최소환승)
Sopt=1

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 globalStartName string Y 1 출발역 명
1-2 globalEndName string Y 1 도착역 명
1-3 globalTravelTime int Y 1 전체 운행소요시간(분)
1-4 globalDistance int Y 1 전체 운행거리(Km)
1-5 globalStationCount int Y 1 전체 정차역 수
1-6 fare int Y 1 카드요금(성인기준)
1-7 cashFare int Y 1 현금요금(성인기준)
1-8 driveInfoSet 확장노드 Y 1 현금요금(성인기준)
1-8-1 driveInfo 확장노드 Y 1...n 확장노드
1-8-1-1 laneID string Y 1 승차역 ID
1-8-1-2 laneName string Y 1 승차역 호선명
1-8-1-3 startName string Y 1 승차 역명
1-8-1-4 stationCount int Y 1 이동 역 수
1-8-1-5 wayCode int Y 1 방면코드 (1:상행, 2:하행)
1-8-1-6 wayName string Y 1 방면 명
1-9 exChangeInfoSet 확장노드 N 1 환승 정보(환승경로 있을경우 제공)
1-9-1 exChangeInfo 확장노드 Y 1...n 환승역정보 확장노드
1-9-1-1 laneName string Y 1 승차노선 명
1-9-1-2 startName string Y 1 승차역 명
1-9-1-3 exName string Y 1 환승역 명
1-9-1-4 exSID int Y 1 환승역 ID
1-9-1-5 fastTrain int Y 1 빠른 환승 객차 번호
1-9-1-6 fastDoor int Y 1 빠른 환승 객차 문 번호
1-9-1-7 exWalkTime int Y 1 환승소요시간 (초)
1-10 stationSet 확장노드 Y 1 이동역 정보 그룹
1-10-1 stations 확장노드 Y 2...n 이동역 정보 확장노드
1-10-1-1 startID int Y 1 출발역 ID
1-10-1-2 startName string Y 1 출발역명
1-10-1-3 endSID int Y 1 도착역 ID
1-10-1-4 endName string Y 1 도착역명
1-10-1-5 travelTime int Y 1 누적 운행시간(분)

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

대중교통 길찾기

대중교통 길찾기 정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/searchPubTransPath json

• 파라미터

번호 파라미터 필수값 설명 예시
1 SX Y 출발지 X좌표 (경도좌표) SX=126.926493082645
2 SY Y 출발지 Y좌표 (위도좌표) SY=37.6134436427887
3 EX Y 도착지 X좌표 (경도좌표) EX=127.126936754911
4 EY Y 도착지 Y좌표 (위도좌표) EY=37.5004198786564
5 OPT N 경로검색결과 정렬방식
0: 최단거리, 1 타입별정렬
ex) 지하철, 버스, 버스+지하철, 지하철+버스, 버스+지하철+버스
OPT = 0
6 SearchType N 도시간 이동/도시내 이동을 선택한다. 도시내 이동/도시간 이동을 구분검색한다.
0 입력시 도시내검색
(도시내검색에서 도시간검색결과 있을경우 활용)
7 SearchPathType N 도시 내 경로수단을 지정한다. 0: 모두(default)
1: 지하철
2: 버스

• 출력 데이터 (도시내 길찾기)

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 searchType int Y 1 결과 구분 (도시내 or 도시간 직통 or 도시간 환승)
0-도시내, 1-도시간 직통, 2-도시간 환승
1-2 outTrafficCheck int Y 1 도시간 "직통" 탐색 결과 유무(환승 X)
0-False, 1-True
1-3 busCount int Y 1 버스 결과 개수
1-4 subwayCount int Y 1 지하철 결과 개수
1-5 subwayBusCount int Y 1 “버스+지하철” 결과 개수
1-6 pointDistance double Y 1 출발지(SX, SY)와 도착지(EX, EY)의 직선 거리 (미터)
1-7 startRadius int Y 1 출발지 반경
1-8 endRadius int Y 1 도착지 반경
1-9 path 확장노드 Y 1...n 결과 리스트 확장 노드
1-9-1 pathType int Y 1 결과 종류
1-지하철, 2-버스, 3-버스+지하철
1-9-2 Info 확장노드 Y 1 요약 정보 확장 노드
1-9-2-1 trafficDistance double Y 1 도보를 제외한 총 이동 거리
1-9-2-2 totalWalk int Y 1 총 도보 이동 거리
1-9-2-3 totalTime int Y 1 총 소요시간
1-9-2-4 payment int Y 1 총 요금
1-9-2-5 busTransitCount int Y 1 버스 환승 카운트
1-9-2-6 subwayTransitCount int Y 1 지하철 환승 카운트
1-9-2-7 mapObj string Y 1 보간점 API를 호출하기 위한 파라미터 값
1-9-2-8 firstStartStation string Y 1 최초 출발역/정류장
1-9-2-9 lastEndStation string Y 1 최종 도착역/정류장
1-9-2-10 toatlStationCount int Y 1 총 정류장 합
1-9-2-11 busStationCount int Y 1 버스 정류장 합
1-9-2-12 subwayStationCount int Y 1 지하철 정류장 합
1-9-2-13 totalDistance double Y 1 총 거리
1-9-3 subPath 확장노드 Y 1...n 이동 교통 수단 정보 확장 노드
1-9-3-1 trafficType int Y 1 이동 수단 종류 (도보, 버스, 지하철)
1-지하철, 2-버스, 3-도보
1-9-3-2 distance double Y 1 이동 거리
1-9-3-3 sectionTime string Y 1 이동 소요 시간
1-9-3-4 stationCount string Y/N 1 이동 정거장 수(지하철, 버스 경우만 필수)
1-9-3-5 lane 확장노드 Y 1...n 교통 수단 정보 확장 노드
1-9-3-5-1 name string Y/N 1 지하철 노선명 (지하철인 경우에만 필수)
1-9-3-5-2 busNo string Y/N 1 버스 번호 (버스인 경우에만 필수)
1-9-3-5-3 type int Y/N 1 버스 타입 (버스인 경우에만 필수,최하단 참조)
1-9-3-5-4 busID int Y/N 1 버스 코드 (버스인 경우에만 필수)
1-9-3-5-5 subwayCode int Y/N 1 지하철 노선 번호 (지하철인 경우에만 필수)
1-9-3-6 startName string Y 1 승차 정류장/역명
1-9-3-7 startX double Y 1 승차 정류장/역 X 좌표
1-9-3-8 startY double Y 1 승차 정류장/역 Y 좌표
1-9-3-9 endName string Y 1 하차 정류장/역명
1-9-3-10 endX double Y 1 하차 정류장/역 X 좌표
1-9-3-11 endY double Y 1 하차 정류장/역 Y 좌표
1-9-3-12 way string Y/N 1 방면 정보 (지하철인 경우에만 필수)
1-9-3-13 wayCode int Y/N 1 방면 정보 코드(지하철의 첫번째 경로에만 필수)
1 : 상행, 2: 하행
1-9-3-14 door string Y/N 1 지하철 빠른 환승 위치 (지하철인 경우에만 필수)
1-9-3-15 startID int Y 1 출발 정류장/역 코드
1-9-3-16 endID int Y 1 도착 정류장/역 코드
1-9-3-17 startExitNo string N 1 지하철 들어가는 출구 번호
(지하철인 경우에만 사용되지만 해당 태그가 없을 수도 있다.)
1-9-3-18 startExitX double N 1 지하철 들어가는 출구 X좌표(지하철인 경우에 만 사용되지만 해당 태그가 없을 수도 있다.)
1-9-3-19 startExitY double N 1 지하철 들어가는 출구 Y좌표(지하철인 경우에 만 사용되지만 해당 태그가 없을 수도 있다.)
1-9-3-20 endExitNo string N 1 지하철 나가는 출구 번호(지하철인 경우에만 사용되지만 해당 태그가 없을 수도 있다.)
1-9-3-21 endExitX double N 1 지하철 나가는 출구 X좌표(지하철인 경우에만 사용되지만 해당 태그가 없을 수도 있다.)
1-9-3-22 endExitY double N 1 지하철 나가는 출구 Y좌표(지하철인 경우에만 사용되지만 해당 태그가 없을 수도 있다.)
1-9-3-23 passStopList 확장노드 Y 1 경로 상세구간 정보 확장 노드
1-9-3-23-1 stations 확장노드 Y 1...n 정류장 정보 그룹노드
1-9-3-23-1-1 index string Y 1 정류장 순번
1-9-3-23-1-2 stationID int Y 1 정류장 ID
1-9-3-23-1-3 stationName string Y 1 정류장 명칭
1-9-3-23-1-4 x string Y 1 정류장 X좌표
1-9-3-23-1-5 y string Y 1 정류장 Y좌표

• 출력 데이터(도시간 길찾기-직통)

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 searchType int Y 1 결과 구분 (도시내 or 도시간 직통 or 도시간 환승)
0-도시내, 1-도시간 직통
1-2 localSearch int Y 1 도시내 탐색 결과 확인
1이라면 도시내 검색 결과 있음
0- False, 1-true
1-3 startCID int Y 1 출발지 도시 코드
1-4 endCID int Y 1 도착지 도시 코드
1-5 startCityName string Y 1 출발지 도시 이름
1-6 endCityName string Y 1 출발지 도시 이름
1-7 pointDistance double Y 1 출발지(SX, SY)와 도착지(EX, EY)의 직선 거리 (미터)
1-8 totalCount int Y 1 총 결과 개수
1-9 trainRequest 확장노드 Y 1 기차 탐색 결과 상위 노드
1-9-1 count int Y 1 기차 탐색 결과 개수
1-9-2 OBJ 확장노드 N 0...n 기차 탐색 결과 리스트
1-9-2-1 startSTN string Y 1 출발역명
1-9-2-2 startID int Y 1 출발역 코드
1-9-2-3 SX double Y 1 출발역 X 좌표
1-9-2-4 SY double Y 1 출발역 Y 좌표
1-9-2-5 endSTN string Y 1 도착역명
1-9-2-6 endID int Y 1 도착역 코드
1-9-2-7 EX double Y 1 도착역 X 좌표
1-9-2-8 EY double Y 1 도착역 Y 좌표
1-9-2-9 Time int Y 1 이동 소요 시간
1-9-2-10 Payment int Y 1 요금
1-9-2-11 trainType int Y 1 기차 종류 코드
1-9-2-12 mapOBJ string Y/N 1 경로그래프 정보를 호출하기 위한 파라미터 값
1-10 exBusRequest 확장 노드 Y 1 고속버스 탐색 결과 상위 노드
1-10-1 Count int Y 1 고속버스 탐색 결과 개수
1-10-2 OBJ 확장 노드 N 0...n 고속버스 탐색 결과 리스트
1-10-2-1 startSTN string Y 1 출발 터미널 명
1-10-2-2 startID int Y 1 출발 터미널 코드
1-10-2-3 SX double Y 1 출발 터미널 X 좌표
1-10-2-4 SY double Y 1 출발 터미널 Y 좌표
1-10-2-5 endSTN string Y 1 도착 터미널 명
1-10-2-6 endID int Y 1 도착 터미널 코드
1-10-2-7 EX double Y 1 도착 터미널 X 좌표
1-10-2-8 EY double Y 1 도착 터미널 Y 좌표
1-10-2-9 time int Y 1 이동 소요 시간
1-10-2-10 Payment int Y 1 요금
1-10-2-11 mapOBJ string Y/N 1 경로그래프 정보를 호출하기 위한 파라미터 값
1-11 outBusRequest 확장 노드 Y 1 시외버스 탐색 결과 상위 노드
1-11-1 count int Y 1 시외버스 탐색 결과 개수
1-11-2 OBJ 확장 노드 N 0...n 시외버스 탐색 결과 리스트
1-11-2-1 startSTN string Y 1 출발 터미널 명
1-11-2-2 startID int Y 1 출발 터미널 코드
1-11-2-3 SX double Y 1 출발 터미널 X 좌표
1-11-2-4 SY double Y 1 출발 터미널 Y 좌표
1-11-2-5 endSTN string Y 1 도착 터미널 명
1-11-2-6 endID int Y 1 도착 터미널 코드
1-11-2-7 EX double Y 1 도착 터미널 X 좌표
1-11-2-8 EY double Y 1 도착 터미널 Y 좌표
1-11-2-9 time int Y 1 이동 소요 시간
1-11-2-10 payment int Y 1 요금
1-11-2-11 mapOBJ string Y/N 1 경로그래프 정보를 호출하기 위한 파라미터 값
1-12 airRequest 확장노드 Y 1 항공 탐색 결과 상위 노드
1-12-1 count int Y 1 항공 탐색 결과 개수
1-12-2 OBJ 확장노드 N 0...n 항공 탐색 결과 리스트
1-12-2-3 startSTN string Y 1 출발 공항 명
1-12-2-4 startID string Y 1 출발 공항 코드
1-12-2-5 SX double Y 1 출발 공항 X 좌표
1-12-2-6 SY double Y 1 출발 공항 Y 좌표
1-12-2-7 endSTN string Y 1 도착 공항 명
1-12-2-8 endID string Y 1 도착 공항 코드
1-12-2-9 EX double Y 1 도착 공항 X 좌표
1-12-2-10 EY double Y 1 도착 공항 Y 좌표
1-12-2-11 time int Y 1 이동 소요 시간
1-12-2-12 payment int Y 1 요금
1-12-2-13 mapOBJ string Y/N 1 경로그래프 정보를 호출하기 위한 파라미터 값

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락
3 출발지 정류장이 없습니다.
4 도착지 정류장이 없습니다.
5 출, 도착지 정류장이 없습니다.
6 서비스 지역이 아닙니다.
-98 출, 도착지가 700m이내입니다.
-99 검색결과가 없습니다.

지하철역 환승 정보 조회

지하철역 환승 정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST http://api.odsay.com/api/subwayTransitInfo json

• 파라미터

번호 파라미터 필수값 설명 예시
1 stationID Y 지하철 환승 정보를 조회 할 역코드 stationID=133

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 count int Y 1 환승 개수
1-2 transitTotalInfo 확장노드 Y 1...n 환승 정보 리스트
1-2-1 takeStationID int Y 1 타고온 역 ID
1-2-2 takeLaneName string Y 1 타고온 노선명
1-2-3 takeLaneID int Y 1 타고온 노선 ID
1-2-4 takeLaneDirection string Y 1 타고온 노선 방면
1-2-5 exStationID int Y 1 환승 할 역 ID
1-2-6 exLaneName string Y 1 환승 할 노선명
1-2-7 exLaneID int Y 1 환승 할 노선 ID
1-2-8 exLaneDirection string Y 1 환승 할 노선 방면
1-2-9 fastTrainInfo string Y 1 환승 정보
1-2-10 FastTrain int Y 1 빠른환승 열차번호
1-2-11 FastFastDoor int Y 1 빠른환승 문 번호
1-2-12 FastTrainNum int Y 1 전체 열차 칸 수

콘솔에서 예시 확인하기»

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

고속버스 터미널 검색

고속버스 터미널 정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/expressBusTerminals json

• 파라미터

번호 파라미터 필수값 설명 예시
1 CID N 도시코드 CID=1000
2 terminalName N 터미널명 terminalName=서울
※ CID와 terminalName 두 파라미터중 하나는 반드시 넣으셔야 합니다.

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최상위 노드
1-1 stationID int Y 1 출발 터미널 ID
1-2 stationName string Y 1 출발 터미널명
1-3 x double Y 1 출발 터미널 X좌표
1-4 y double Y 1 출발 터미널 Y좌표
1-5 haveDestinationTerminals boolean Y 1 도착지 터미널 존재 여부(true: 존재, false: 미존재)
1-6 destinationTerminals 확장노드 N 0...n 도착지 터미널 상위 노드
1-6-1 stationID int Y 1 도착 터미널 ID
1-6-2 stationName string Y 1 도착 터미널명
1-6-3 x double Y 1 도착 터미널 X좌표
1-6-4 y double Y 1 도착 터미널 Y좌표

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류

시외버스 터미널 검색

시외버스 터미널 정보를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST https://api.odsay.com/api/intercityBusTerminals json

• 파라미터

번호 파라미터 필수값 설명 예시
1 CID N 도시코드 CID=1000
2 terminalName N 터미널명 terminalName=서울
※ CID와 terminalName 두 파라미터중 하나는 반드시 넣으셔야 합니다.

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최상위 노드
1-1 stationID int Y 1 출발 터미널 ID
1-2 stationName string Y 1 출발 터미널명
1-3 x double Y 1 출발 터미널 X좌표
1-4 y double Y 1 출발 터미널 Y좌표
1-5 haveDestinationTerminals boolean Y 1 도착지 터미널 존재 여부(true: 존재, false: 미존재)
1-6 destinationTerminals 확장노드 N 0...n 도착지 터미널 상위 노드
1-6-1 stationID int Y 1 도착 터미널 ID
1-6-2 stationName string Y 1 도착 터미널명
1-6-3 x double Y 1 도착 터미널 X좌표
1-6-4 y double Y 1 도착 터미널 Y좌표

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류

도시코드 조회

도시코드(CID)를 리턴합니다.

매서드 요청 URL 출력 포맷
GET/POST http://api.odsay.com/api/searchCID json

• 파라미터

번호 파라미터 필수값 설명 예시
1 cityName N 조회할 도시이름(한글)
검색하는 글자를 포함하는 결과를 호출한다.
빈값 입력시 모든 도시코드를 호출한다.

ex) '양주' 검색 결과값 : 양주,남양주
cityName=서울

• 출력 데이터

번호 요소 데이터 타입 필수값 출력개수 설명
1 result 확장노드 Y 1 데이터를 포함하는 최 상위 노드
1-1 CID 확장노드 Y 1 각 도시
1-1-1 cityRegion String Y 1 도시의 행정구
1-1-2 cityName String Y 1 도시의 이름
1-1-3 cityCode String Y 1 도시의 코드

콘솔에서 예시 확인하기 »

• 에러 코드

코드 메시지
500 서버 내부 오류
-8 필수 입력값 형식 및 범위 오류
-9 필수 입력값 누락

코드정의

코드 정의표 입니다.

• 지하철 빠른 환승정리

type 종류
0-0 모든 객차 모든 문
-1 - -1 정산 후 승차(공항철도)
-2 - -2 데이터 수집 중

• 도시간경로 시외교통정보 타입

type 종류
3 기차
4 고속버스
5 항공
6 시외버스

• 열차 타입

type 종류
1 KTX
2 새마을
3 무궁화
4 누리호
5 통근
6 ITX-새마을
7 ITX-청춘

• 버스노선 타입

type 노선명 type 노선명
1 일반 12 지선
2 좌석 13 순환
3 마을버스 14 광역
4 직행좌석 15 급행
5 공항버스 20 농어촌버스
6 간선급행 21 제주도 시외형버스
10 외곽 22 경기도 시외형버스
11 간선 26 급행간선

• 지하철 노선 타입

type 노선명 type 노선명
1 수도권 1호선 109 신분당선
2 수도권 2호선 110 의정부경전철
3 수도권 3호선 111 수인선
4 수도권 4호선 21 인천 1호선
5 수도권 5호선 31 대전 1호선
6 수도권 6호선 41 대구 1호선
7 수도권 7호선 42 대구 2호선
8 수도권 8호선 43 대구 3호선
9 수도권 9호선 51 광주 1호선
100 분당선 71 부산 1호선
101 공항철도 72 부산 2호선
104 경의중앙선 73 부산 3호선
107 에버라인 74 부산 4호선
108 경춘선 79 부산-김해경전철
102 자기부상철도

• 도시코드(CID)

CityCode 도시명 CityCode 도시명 CityCode 도시명
1000 서울 1010 성남 1020 고양
1030 안양 1040 안산 1050 부천
1060 과천 1070 하남 1080 구리
1090 의정부 1100 수원 1110 광주
1120 남양주 1130 용인 1140 시흥
1150 파주 1160 광명 1170 김포
1180 가평군 1190 양평군 1200 연천군
1210 오산 1220 평택 1230 화성
1240 동두천 1250 양주 1260 포천
1270 안성 1280 군포 1290 의왕
1300 이천 1310 여주 2000 인천
3000 대전 3010 계룡 3020 공주
3030 논산 3040 보령 3050 서산
3060 아산 3070 천안 3080 금산군
3090 당진군 3100 부여군 3110 서천군
3120 연기군 3130 예산군 3140 청양군
3150 태안군 3160 홍성군 3300 세종시
4000 대구 4010 경산 4020 경주
4030 구미 4040 김천 4050 문경
4060 상주 4070 안동 4080 영주
4090 영천 4100 포항 4110 고령군
4120 군위군 4130 봉화군 4140 성주군
4150 영덕군 4160 영양군 4170 예천군
4180 울릉군 4190 울진군 4200 의성군
4210 청도군 4220 청송군 4230 칠곡군
5000 광주 5010 광양 5020 나주
5030 목포 5040 순천 5050 여수
5060 강진군 5070 고흥군 5080 곡성군
5090 구례군 5100 담양군 5110 무안군
5120 보성군 5130 신안군 5140 영광군
5150 영암군 5160 완도군 5170 장성군
5180 장흥군 5190 진도군 5200 함평군
5210 해남군 5220 화순군 6000 울산
7000 부산 7010 거제 7020 김해
7030 마산 7040 밀양 7050 사천
7060 양산 7070 진주 7080 진해
7090 창원 7100 통영 7110 거창군
7120 고성군 7130 남해군 7140 산청군
7150 의령군 7160 창녕군 7170 하동군
7180 함안군 7190 함양군 7200 합천군
8000 제주 8010 서귀포 8020 남제주군
8030 북제주군 9000 전주 9010 군산
9020 김제 9030 남원 9040 익산
9050 정읍 9060 고창군 9070 무주군
9080 무안군 9090 순창군 9100 완주군
9110 임실군 9120 장수군 9130 진안군
10000 속초 10010 원주 10020 강릉
10030 동해 10040 태백 10050 삼척
10060 평창군 10070 홍천군 10080 횡성군
10090 영월군 10100 정선군 10110 철원군
10120 화천군 10130 양구군 10140 인제군
10150 고성군 10160 양양군 10170 춘천
11000 청주 11010 충주 11020 제천
11030 보은군 11040 옥천군 11050 영동군
11060 진천군 11070 괴산군 11080 음성군
11090 단양군 11100 증평군 11110 청원군