데이터 찾기

시각화 자료

OpenAPI

참여 & 소통

OpenAPI 조회

설명

본 데이터는 한국도로공사에서 제공하는 고속도로 버스전용차로의 구간별 통행속도 정보를 조회할 수 있는 OpenAPI이다.
버스전용차로 운영구간의 통행 흐름을 파악하기 위한 목적으로 제공되며, 구간 식별자, 통행일자, 시작지점, 종료지점, 평균속도 등의 항목으로 구성되어 있다.
데이터는 XML 및 JSON 형식으로 제공되며, 대중교통 서비스 개선, 정체 구간 분석, 교통정보 시스템 구축 등에 활용 가능하다.
본 API는 조건에 따라 특정 일자의 구간 속도를 조회할 수 있도록 설계되었으며, 일정 주기로 데이터가 갱신된다.
이용자는 인증키를 발급받아 API 호출이 가능하고, 요청 항목 및 응답 구조는 명세 문서를 통해 확인할 수 있다.

기본정보

OpenAPI 기본정보
항목명	값

Data 설명

교통예보 Data 설명
현재 시간	제공 OpenAPI

API 샘플 코드

Python Java

요청변수

OpenAPI 요청변수
요청변수	값	조건	설명

출력결과

OpenAPI 출력결과
출력변수	값	설명

경상북도 김천시 혁신8로 77(율곡동, 한국도로공사)
컨텐츠 문의 054-811-4418
시스템 장애 문의 070-8656-8771

Request Parameter에 값을 완성해 주십시오. (붉은색은 필수항목 입니다.)
“API발급키”는 사용자에게 발급된 키로 꼭 바꾸셔야 합니다.
Request Parameter 완성 후 URL보기를 눌러 주십시오.
URL보기 후 예제 실행하기를 눌러 주십시오.


Request Parameter	값
key
type	xml json

URL 결과

예제실행 결과

콘텐츠유형코드
코드	값
00	사고
01	고장
02	장애물
03	작업
04	차량증가/정체
06	강우
09	안개
16	역주행
17	결빙
18	적설
19	강풍
20	어는비
21	노면습기
30	차로차단
31	전면차단
70	졸음쉼터
71	갓길차로
72	터널역광
73	사고잦은구간
74	휴게소혼잡정보
75	확장공사구간
76	잦은눈피해구간

Python 샘플코드

                    	
							import requests

url = "https://data.ex.co.kr/openapi/buslane/speedDirectionSection"

params = {
    "key": "test",
    "type": "json",
    "collectDate": "20180317",
    "collectHour": "10",
    "vdsId": None,
    "conzoneId": None,
    "numOfRows": "10",
    "pageNo": "1"
}

response = requests.get(url, params=params)

print("Status Code:", response.status_code)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print("Failed")
    print(response.text)

Java 샘플코드

                    	
							import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.IOException;
import java.net.HttpURLConnection;
import java.net.URL;

public class ApiExample {

    public static void main(String[] args) {

        HttpURLConnection conn = null;
        BufferedReader br = null;

        try {
            String url = "https://data.ex.co.kr/openapi/buslane/speedDirectionSection?"
                        +"key=test"
                        +"&type=json"
                        +"&collectDate=20180317"
                        +"&collectHour=10"
                        +"&vdsId=None"
                        +"&conzoneId=None"
                        +"&numOfRows=10"
                        +"&pageNo=1";

            URL apiUrl = new URL(url);

            conn = (HttpURLConnection) apiUrl.openConnection();

            conn.setRequestMethod("GET");

            int responseCode = conn.getResponseCode();
            if (responseCode == 200) {
                br = new BufferedReader(
                              new InputStreamReader(
                                     conn.getInputStream()));

                String line = "";

                while ((line = br.readLine()) != null) {
                    System.out.println(line);
                }
            } else {
                System.out.println("HTTP Status Code : " + responseCode);
            }

        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (br != null) {
                try {
                    br.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }

            if (conn != null) {
                conn.disconnect();
            }
        }
    }
}

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.IOException;
import java.net.HttpURLConnection;
import java.net.URL;

public class ApiExample {

public static void main(String[] args) {

HttpURLConnection conn = null;
        BufferedReader br = null;

try {
            String url = "https://data.ex.co.kr/openapi/buslane/speedDirectionSection?"
                        +"key=test"
                        +"&type=json"
                        +"&collectDate=20180317"
                        +"&collectHour=10"
                        +"&vdsId=None"
                        +"&conzoneId=None"
                        +"&numOfRows=10"
                        +"&pageNo=1";

URL apiUrl = new URL(url);

conn = (HttpURLConnection) apiUrl.openConnection();

conn.setRequestMethod("GET");

int responseCode = conn.getResponseCode();
            if (responseCode == 200) {
                br = new BufferedReader(
                              new InputStreamReader(
                                     conn.getInputStream()));

String line = "";

while ((line = br.readLine()) != null) {
                    System.out.println(line);
                }
            } else {
                System.out.println("HTTP Status Code : " + responseCode);
            }

} catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (br != null) {
                try {
                    br.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }

if (conn != null) {
                conn.disconnect();
            }
        }
    }
}