기준 2021_기본교통정보+교환+기술기준+제정_고시문3
2022.08.01 17:16
국토교통부 고시 제2021-1061호
「국가통합교통체계효율화법」제82조에 따라 기본교통정보 교환
기술기준Ⅲ을 제정하여 다음과 같이 고시합니다.
2021년 9월 1일
국토교통부 장관
「기본교통정보 교환 기술기준Ⅲ」 제정
1. 제정이유
지능형교통체계(ITS) 등을 통해 수집한 교통정보를 인터넷을 통해
이용자에게 제공하기 위한 교통정보 공개플랫폼(Open API) 데이터
전송기준을 마련하고자 함
2. 주요내용
가. 본 기본교통정보교환 기술기준Ⅲ을 제정하는 목적 및 적용하는
정보전달 매체 등의 범위를 명시 [ 제1호, 제2호 ]
나. 본 기본교통정보교환 기술기준Ⅲ을 통해 제공할 수 있는 교통정보
종류와 정보 연계체계 정의 [ 제3호, 제4호 ]
다. 교통정보센터에서 교통정보를 인터넷 기반 공개플랫폼(Open-
API)을 통해 他정보센터, 이용자에게 제공하기 위한 데이터
메시지 형식 정의 [제5호]
국토교통부고시 제2021 - 1061호
기본교통정보 교환 기술기준Ⅲ
「국가통합교통체계효율화법」제82조제1항에 따라 “기본교통정보교환
기술기준Ⅲ”을 다음과 같이 제정·고시한다.
부 칙
이 고시는 발령한 날부터 시행한다.
제정 2021. 9. 1. 국토교통부고시 제2021-1061호
기본교통정보교환 기술기준 Ⅲ
국 토 교 통 부
목 차
1. 목적 ············································································································· 1
2. 적용범위 ····································································································· 1
3. 기본정보 구성 ··························································································· 2
4. 정보 연계체계 ··························································································· 2
5. Open-API 연계정보 ················································································· 3
5.1. 교통소통정보 ······················································································· 3
5.2. 돌발상황정보 ······················································································· 6
5.3. CCTV 화상자료 ·················································································· 9
5.4. 교통예측정보 ····················································································· 12
5.5. 차량검지정보 ····················································································· 14
5.6. 도로전광표지(VMS) 정보 ······························································· 16
5.7. 주의운전구간 정보 ··········································································· 18
5.8. 가변형 속도제한표지 정보 ····························································· 21
6. 재검토 기한 ····························································································· 23
부록. 서비스 및 사용자 인증방식 ··························································· 24
- 1 -
1. 목적
ㅇ 고속국도․국도․지방도․시/군도 등 교통시설에 대한 지능형교
통체계 구축․운영 등으로 수집·가공한 교통정보를 인터넷을 통
해 이용자에게 제공하기 위한 표준(이하 “기술기준”이라함)을 정
의함으로써 교통정보의 활용 편의성 제고를 목적으로 한다.
2. 적용범위
ㅇ 본 기술기준은 국가통합교통체계효율화법에 따라 수행하는 ‘교통
체계지능화사업’에서 인터넷을 통하여 교통정보를 공개하는 경우
적용한다.
- “인터넷을 통하여 교통정보를 공개하는 경우”라 함은 유․무선 인
터넷이 가능한 컴퓨터(개인용, 산업용 컴퓨터), 스마트 폰, 태블
릿 PC 등 에서 일정한 형식에 따라 요청한 자료를 제공하는 것
을 말한다.
- 다만, 아래의 경우에는 이 기술기준을 적용하지 아니한다.
① 지능형교통체계관리청이 전용 인터넷 홈페이지(모바일 웹,
WAP 등)를 개발하여 교통정보를 일반에 제공하는 경우
② “기본교통정보교환 기술기준”에 따라 지능형교통체계관리청
상호간 교통정보를 연계하는 경우
- 2 -
3. 기본정보 구성
ㅇ 본 기술기준은 인터넷을 통하여 공개하는 교통정보로서 다음 8
개의 정보를 포함한다.
- 교통소통정보, 돌발상황정보, CCTV 화상자료, 교통예측정보,
차량검지정보, 도로전광표지(VMS) 정보, 주의운전구간 정보,
가변속도표지 정보
4. 정보 연계체계
ㅇ 교통정보의 연계체계는 다음과 같다.
[그림] 정보연계 체계
- 3 -
정보명 교통소통정보 제공
정보 세항목
응답 코드, 응답 메시지, 총 갯수, 도로명, 도로 방향 유형, 일
련 번호, 링크 ID, 시작 노드 ID, 종료 노드 ID, 통행 속도, 통
행 시간, 생성 일시
설명 고속도로 및 국도별 소통정보
출력변수 값 설명
resultCode string 응답 코드
resultMsg string 응답 메시지
totalCount string 총 갯수
roadName string 도로명
정보명 교통소통정보 요청
정보 세항목
공개키, 도로 유형, 노선 번호, 도로 방향, 최소 경도 영역, 최대
경도 영역, 최소 위도 영역, 최대 위도 영역, 출력 결과 형식
설명 교통소통정보 요청을 위해 설정해야할 변수
요청변수 값 설명
apiKey string 공개키
type string 도로 유형(all: 전체 / ex: 고속도로 / its: 국도)
routeNo string 노선 번호
drcType string
도로 방향(all: 전체 / up: 상행 / down: 하행 /
start: 시점 / end: 종점)
minX double
최소 경도 영역(도로 정보(all) 혹은 도로
방향(all)의 경우, 사용 가능)
maxX double
최대 경도 영역(도로 정보(all) 혹은 도로
방향(all)의 경우, 사용 가능)
minY double 최소 위도 영역(도로 정보(all)의 경우, 사용 가능)
maxY double 최대 위도 영역(도로 정보(all)의 경우, 사용 가능)
getType string 출력 결과 형식(xml, json / 기본: xml)
5. Open-API 연계정보
5.1. 교통소통정보
5.1.1. 교통소통정보 요청
◦ 교통소통정보를 요청하기 위한 세부 항목은 다음과 같다.
5.1.2. 교통소통정보 제공
◦ 제공되는 교통소통정보의 세부내용은 다음과 같다.
- 4 -
roadDrcType string 도로 방향 유형
linkNo string 일련 번호
linkId string 링크 ID
startNodeId string 시작 노드 ID
endNodeId string 종료 노드 ID
speed string 통행 속도(km/h)
travelTime string 통행 시간(초)
createdDate string 생성 일시(YYYYMMDDHH24MISS)
xml인 경우
<?xml version='1.0' encoding='UTF-8'?> <response>
<header>
<resultCode>0</resultCode>
<resultMsg>SUCCESS</resultMsg>
</header>
<body>
<totalCount>8810</totalCount>
<items>
<item>
<roadName>남문로</roadName>
<drcType/>
<linkNo/>
<linkId>1750000100</linkId>
<startNodeId>3340015000</startNodeId>
<endNodeId>1750000100</endNodeId>
<speed>73</speed>
<travelTime>12.01</travelTime>
<createdDate>20201130144001</createdDate>
</item>
</items>
</body>
</response>
json인 경우
{
"response": {
"header": {
"resultcode": 0,
"resultmsg": "SUCCESS"
},
"body": {
"totalcount": 8810,
"items": {
"item": {
"roadname": "남문로",
"drctype": {},
◦ 교통소통정보 제공 예시는 다음과 같다.
- 5 -
"linkno": {},
"linkid": 1750000100,
"startnodeid": 3340015000,
"endnodeid": 1750000100,
"speed": 73,
"traveltime": 12.01,
"createddate": 20201130144001
}
}
}
}
}
- 6 -
정보명 돌발상황정보 요청
정보 세항목
공개키, 도로 유형, 이벤트 유형, 최소 경도 영역, 최대 경도 영
역, 최소 위도 영역, 최대 위도 영역, 출력 결과 형식
설명 돌발상황정보 요청을 위해 설정해야할 변수
요청변수 값 설명
apiKey string 공개키
type string
도로 유형(all: 전체 / ex: 고속도로 / its: 국도 /
loc: 지방도 / sgg: 시군도 / etc: 기타)
eventType string
이벤트 유형
(all: 전체 / cor: 공사 / acc: 교통사고 / wea:
기상 / ete: 기타돌발 / dis: 재난 / etc: 기타)
minX double
최소 경도 영역(도로 정보(all) 혹은 도로
방향(all)의 경우, 사용 가능)
maxX double
최대 경도 영역(도로 정보(all) 혹은 도로
방향(all)의 경우, 사용 가능)
minY double 최소 위도 영역(도로 정보(all)의 경우, 사용 가능)
maxY double 최대 위도 영역(도로 정보(all)의 경우, 사용 가능)
getType string 출력 결과 형식(xml, json / 기본: xml)
정보명 돌발상황정보 제공
정보 세항목
응답 코드, 응답 메시지, 총 갯수, 도로 유형, 이벤트유형, 이벤
트세부유형, 발생 일시, 경도 좌표, 위도 좌표, 링크 ID, 도로
명, 도로 번호, 도로 방향 유형, 차단 통제 유형, 차단 차로, 돌
발 내용, 종료 일시
설명 고속도로 및 국도의 돌발상황정보
출력변수 값 설명
resultCode string 응답 코드
resultMsg string 응답 메시지
totalCount string 총 갯수
type string 도로 유형(고속도로 / 국도 / 지방도 / 시군도 /
5.2. 돌발상황정보
5.2.1. 돌발상황정보 요청
◦ 돌발상황정보를 요청하기 위한 세부 항목은 다음과 같다.
5.2.2. 돌발상황정보 제공
◦ 제공되는 돌발상황정보의 세부내용은 다음과 같다.
- 7 -
기타)
eventType string
이벤트유형(교통사고 / 공사 / 기상 / 재난 /
기타돌발 / 기타)
eventDetailType string 이벤트세부유형
startDate string 발생 일시(YYYYMMDDHH24MISS)
coordX string 경도 좌표
coordY string 위도 좌표
linkId string 링크 ID
roadName string 도로명
roadNo string 도로 번호
roadDrcType string 도로 방향 유형
lanesBlockType string 차단 통제 유형
lanesBlocked string 차단 차로
message string 돌발 내용
endDate string 종료 일시(YYYYMMDDHH24MISS)
xml인 경우
<?xml version='1.0' encoding='UTF-8'?> <response>
<header>
<resultCode>0</resultCode>
<resultMsg>SUCCESS</resultMsg>
</header>
<body>
<totalCount>24</totalCount>
<items>
<item>
<type>고속도로</type>
<eventType>작업</eventType>
<eventDetailType>작업</eventDetailType>
<startDate>20201127075753</startDate>
<coordX>127.5166</coordX>
<coordY>34.9011</coordY>
<roadName>남해선(영암-순천)</roadName>
<roadNo>101</roadNo>
<roadDrcType>하행</roadDrcType>
<lanesBlockType/>
<lanesBlocked>2차로 차단</lanesBlocked>
<message>(2차로)노면보수작업중</message>
<endDate/>
</item>
</items>
</body>
</response>
◦ 돌발상황정보 제공 예시는 다음과 같다.
- 8 -
json인 경우
{
"response": {
"header": {
"resultcode": 0,
"resultmsg": "SUCCESS"
},
"body": {
"totalcount": 24,
"items": {
"item": {
"type": "고속도로",
"eventtype": "작업",
"eventdetailtype": "작업",
"startdate": 20201127075753,
"coordx": 127.5166,
"coordy": 34.9011,
"roadname": "남해선(영암-순천)",
"roadno": 101,
"roaddrctype": "하행",
"lanesblocktype": {},
"lanesblocked": "2차로 차단",
"message": "(2차로)노면보수작업중",
"enddate": {}
}
}
}
}
}
- 9 -
정보명 CCTV 화상자료 제공
정보 세항목
좌표타입, CCTV 개수, 도로 구간 ID, 파일 생성 시간, CCTV
유형, CCTV 영상 주소, CCTV 해상도, 경도 좌표, 위도 좌표,
CCTV 형식, CCTV 설치 장소명
설명 고속도로 및 국도의 CCTV 화상자료
출력변수 값 설명
coordtype string 좌표타입
datacount int CCTV 개수
roadsectionid string 도로 구간 ID
filecreatetime string 파일 생성 시간(YYYYMMDDHH24MISS)
cctvtype string CCTV 유형(1: 실시간 스트리밍(HLS) / 2: 동영상
파일 / 3: 정지 영상)
cctvurl string CCTV 영상 주소
cctvresolution string CCTV 해상도
coordx string 경도 좌표
5.3. CCTV 화상자료
5.3.1. CCTV 화상자료 요청
◦ CCTV 화상자료를 요청하기 위한 세부 항목은 다음과 같다.
정보명 CCTV 화상자료 요청
정보 세항목
공개키, 도로 유형, CCTV 유형, 최소 경도 영역, 최대 경도 영
역, 최소 위도 영역, 최대 위도 영역, 출력 결과 형식
설명 CCTV 화상자료 요청을 위해 설정해야할 변수
요청변수 값 설명
apiKey string 공개키
type string 도로 유형(ex: 고속도로 / its: 국도)
cctvType string CCTV 유형(1: 실시간 스트리밍(HLS) / 2: 동영상
파일 / 3: 정지 영상)
minX double 최소 경도 영역
maxX double 최대 경도 영역
minY double 최소 위도 영역
maxY double 최대 위도 영역
getType string 출력 결과 형식(xml, json / 기본: xml)
5.3.2. CCTV 화상자료 제공
◦ 제공되는 CCTV 화상자료의 세부내용은 다음과 같다.
- 10 -
coordy string 위도 좌표
cctvformat string CCTV 형식
cctvname string CCTV 설치 장소명
xml인 경우
<?xml version='1.0' encoding='UTF-8'?>
<response>
<coordtype>1</coordtype>
<datacount>20</datacount>
<data>
<roadsectionid/>
<filecreatetime/>
<cctvtype>1</cctvtype>
<cctvurl>http://cctvsec.ktict.co.kr/2/+MAKvmhuhLCng+SmwOzwVRr9ADys3kFBmCW4OGY0
XH42/fg2Xx+LaT31c9P6p8B6zeDT2IiT0gnAOHLJlPChPw==</cctvurl>
<cctvresolution/>
<coordy>37.42889</coordy>
<cctvformat>HLS</cctvformat>
<cctvname>[수도권제1순환선] 성남;</cctvname>
<coordx>127.12361;</coordx>
</data>
<data>
<roadsectionid/>
<filecreatetime/>
<cctvtype>1</cctvtype>
<cctvurl>http://cctvsec.ktict.co.kr/2/+MAKvmhuhLCng+SmwOzwVRr9ADys3kFBmCW4OGY0
XH42/fg2Xx+LaT31c9P6p8B6zeDT2IiT0gnAOHLJlPChPw==</cctvurl>
<cctvresolution/>
<coordy>37.42889</coordy>
<cctvformat>HLS</cctvformat>
<cctvname>[수도권제1순환선] 성남;</cctvname>
<coordx>127.12361;</coordx>
</data>
</response>
json인 경우
{
"response": {
"coordtype": 1,
"datacount": 20,
"data": {
"roadsectionid": {},
"filecreatetime": {},
"cctvtype": 1,
"cctvurl":
◦ CCTV 화상자료 제공 예시는 다음과 같다.
- 11 -
"http://cctvsec.ktict.co.kr/2/+MAKvmhuhLCng+SmwOzwVRr9ADys3kFBmCW4O
GY0XH42/fg2Xx+LaT31c9P6p8B6zeDT2IiT0gnAOHLJlPChPw==",
"cctvresolution": {},
"coordy": 37.42889,
"cctvformat": "HLS",
"cctvname": {
"value": "[수도권제1순환선] 성남;/cctvname",
"coordx": {
"value": "127.12361;/coordx",
"data": {
"roadsectionid": {},
"filecreatetime": {},
"cctvtype": 1,
"cctvurl":
"http://cctvsec.ktict.co.kr/2/+MAKvmhuhLCng+SmwOzwVRr9ADys
3kFBmCW4OGY0XH42/fg2Xx+LaT31c9P6p8B6zeDT2IiT0gnAOHLJlP
ChPw==",
"cctvresolution": {},
"coordy": 37.42889,
"cctvformat": "HLS",
"cctvname": {
"value": "[수도권제1순환선] 성남;/cctvname",
"coordx": "127.12361;/coordx"
}
}
}
}
}
}
}
- 12 -
정보명 교통예측정보 요청
정보 세항목
공개키, 본선 도로 구간 ID, 노선 번호, 예측 날짜, 예측 시간,
출력 결과 형식
설명 교통예측정보 요청을 위해 설정해야할 변수
요청변수 값 설명
apiKey string 공개키
sectionId string 본선 도로 구간 ID
routeNo string 노선 번호
fCastDate string 예측 날짜
fCastHour string 예측 시간
getType string 출력 결과 형식(xml, json / 기본: xml)
정보명 교통예측정보 제공
정보 세항목
예측 날짜, 예측 시간, 링크 ID, 본선 도로 구간 ID, 구간 구분,
우회 도로 ID, 링크 길이, 예측 속도
설명 우회도로 교통예측정보
출력변수 값 설명
fcastDate string 예측 날짜
fcastHour string 예측 시간(24시간기준)
linkId string 링크 ID
sectionId string 본선 도로 구간 ID
sectionType string 구간 구분 (M:메인도로, D:우회도로)
detourId string 우회 도로 ID
length string 링크 길이
speed string 예측 속도(km/h)
5.4. 교통예측정보
5.4.1. 교통예측정보 요청
◦ 교통예측정보를 요청하기 위한 세부 항목은 다음과 같다.
5.4.2. 교통예측정보 제공
◦ 제공되는 교통예측정보의 세부내용은 다음과 같다.
- 13 -
xml인 경우
<?xml version='1.0' encoding='UTF-8'?> <response>
<header>
<resultCode>0</resultCode>
<resultMsg>SUCCESS</resultMsg>
</header>
<body>
<totalCount>24</totalCount>
<items>
<item>
<fcastDate/>
<fcastHour/>
<linkId>2030003902</linkId>
<sectionId>10</sectionId>
<sectionType>D</sectionType>
<detourId>10</detourId>
<length/>
<speed/>
</item>
</items>
</body>
</response>
json인 경우
{
"response": {
"header": {
"resultcode": 0,
"resultmsg": "SUCCESS"
},
"body": {
"totalcount": 24,
"items": {
"item": {
"fcastdate": {},
"fcasthour": {},
"linkid": 2030003902,
"sectionid": 10,
"sectiontype": "D",
"detourid": 10,
"length": {},
"speed": {}
}
}
}
}
}
◦ 교통예측정보 제공 예시는 다음과 같다.
- 14 -
정보명 차량검지정보 요청
정보 세항목 공개키, 출력 결과 형식
설명 차량검지정보 요청을 위해 설정해야할 변수
요청변수 값 설명
apiKey string 공개키
getType string 출력 결과 형식(xml, json / 기본: xml)
xml인 경우
<?xml version='1.0' encoding='UTF-8'?> <response>
<header>
<resultCode>0</resultCode>
<resultMsg>SUCCESS</resultMsg>
</header>
<body>
<totalCount>24</totalCount>
<items>
<item>
<vdsId>0010VDE00100</vdsId>
5.5. 차량검지정보
5.5.1. 차량검지정보 요청
◦ 차량검지정보를 요청하기 위한 세부 항목은 다음과 같다.
5.5.2. 차량검지정보 제공
◦ 제공되는 차량검지정보의 세부내용은 다음과 같다.
정보명 차량검지정보 제공
정보 세항목 VDS ID, 차로 번호, 입력 일시, 속도, 교통량, 점유율
설명 최근 1분 이내에 수집된 차로별 차량검지정보 제공
출력변수 값 설명
vdsId string VDS ID
laneNo string 차로 번호
colctedDate string 입력 일시(YYYYMMDDHH24MISS)
speed string 속도(km/h)
volume string 교통량
occupancy string 점유율
◦ 차량검지정보 제공 예시는 다음과 같다.
- 15 -
<linkIds>1400006000,1400007000,1400008700</linkIds>
<laneNo>20210104175700</laneNo>
<speed>78.55</speed>
<volume>29</volume>
<occupancy>1.76</occupancy>
</item>
</items>
</body>
</response>
json인 경우
{
"response": {
"header": {
"resultcode": 0,
"resultmsg": "SUCCESS"
},
"body": {
"totalcount": 24,
"items": {
"item": {
"vdsid": "0010VDE00100",
"linkids": "1400006000,1400007000,1400008700",
"laneno": 20210104175700,
"speed": 78.55,
"volume": 29,
"occupancy": 1.76
}
}
}
}
}
- 16 -
정보명 도로전광표지(VMS) 정보 요청
정보 세항목 공개키, 출력 결과 형식
설명 도로전광표지(VMS) 정보 요청을 위해 설정해야할 변수
요청변수 값 설명
apiKey string 공개키
getType string 출력 결과 형식(xml, json / 기본: xml)
정보명 도로전광표지(VMS) 정보 제공
정보 세항목
응답 코드, 응답 메시지, 총 갯수, VMS ID, DISPLAY 표출 순
서, 표출 정보 메시지, 수신 일시, 경도 좌표, 위도 좌표, 도로
등급, 도로명, 노선 번호, 도로 방향 유형
설명
도로전광표지(VMS) 좌표 및 표출 데이터 등 도로전광표지
(VMS) 관련 정보 제공
출력변수 값 설명
resultCode string 응답 코드
resultMsg string 응답 메시지
totalCount string 총 갯수
vmsId string VMS ID
messageNo string DISPLAY 표출 순서
message string 표출 정보 메시지
createdDate string 수신 일시(YYYYMMDDHH24MISS)
coordX string 경도 좌표
coordY string 위도 좌표
roadGrad string 도로 등급
roadName string 도로명
routeNo string 노선 번호
roadDrcType string 도로 방향 유형
5.6. 도로전광표지(VMS) 정보
5.6.1. 도로전광표지(VMS) 정보 요청
◦ 도로전광표지(VMS) 정보를 요청하기 위한 세부 항목은 다음과 같다.
5.6.2. 도로전광표지(VMS) 정보 제공
◦ 제공되는 도로전광표지(VMS) 정보의 세부내용은 다음과 같다.
- 17 -
xml인 경우
<?xml version='1.0' encoding='UTF-8'?> <response>
<header>
<resultCode>0</resultCode>
<resultMsg>SUCCESS</resultMsg>
</header>
<body>
<totalCount>24</totalCount>
<items>
<item>
<vmsId>12001VME00101</vmsId>
<messageNo>1</messageNo>
<message>건설현장의 사고를 예방하기 위한|대국민 이차사고 신고제 운영|</message>
<createdDate>20201130144253</createdDate>
</item>
</items>
</body>
</response>
json인 경우
{
"response": {
"header": {
"resultcode": 0,
"resultmsg": "SUCCESS"
},
"body": {
"totalcount": 24,
"items": {
"item": {
"vmsid": "12001VME00101",
"messageno": 1,
"message": "건설현장의 사고를 예방하기 위한|대국민 이차사고 신고제 운영|",
"createddate": 20201130144253
}
}
}
}
}
◦ 도로전광표지(VMS) 정보 제공 예시는 다음과 같다.
- 18 -
정보명 주의운전구간 정보 요청
정보 세항목
공개키, 최소 경도 영역, 최대 경도 영역, 최소 위도 영역, 최
대 위도 영역, 출력 결과 형식
설명 주의운전구간 정보 요청을 위해 설정해야할 변수
요청변수 값 설명
apiKey string 공개키
minX double 최소 경도 영역
maxX double 최대 경도 영역
minY double 최소 위도 영역
maxY double 최대 위도 영역
getType string 출력 결과 형식(xml, json / 기본: xml)
정보명 주의운전구간 정보 제공
정보 세항목
제공문안, 이벤트에 대한 제공 순번, 콘텐츠 유형, 생성문안 우
선순위, 이벤트시작위치(노선명), 이벤트시작위치(노선), 이벤트
시작위치(노선방향코드), 이벤트시작위치(표준노드링크), 이벤트
시작위치(경도), 이벤트시작위치(위도), 메시지수신위치(노선명),
메시지수신위치(노선), 메시지수신위치(차량 진행 방향명), 메시
지수신위치(표준노드링크), 메시지수신위치(경도), 메시지수신위
치(위도), 이벤트ID
설명 고속도로의 주의운전구간 정보
출력변수 값 설명
message string 제공문안
stepType string 이벤트에 대한 제공 순번
outbrkType string 콘텐츠 유형
priority string 생성문안 우선순위
routeName string 이벤트시작위치(노선명)
routeNo string 이벤트시작위치(노선)
5.7. 주의운전구간 정보
5.7.1. 주의운전구간 정보 요청
◦ 주의운전구간 정보를 요청하기 위한 세부 항목은 다음과 같다.
5.7.2. 주의운전구간 정보 제공
◦ 제공되는 주의운전구간 정보의 세부내용은 다음과 같다.
- 19 -
roadDrcType string 이벤트시작위치(노선 방향 코드)
startStdLinkId string 이벤트시작위치(표준 노드링크)
startX string 이벤트시작위치(경도)
startY string 이벤트시작위치(위도)
revRouteName string 메시지수신위치(노선명)
revRouteNo string 메시지수신위치(노선)
revRoadDrcType string 메시지수신위치(차량 진행 방향명)
revStdLinkId string 메시지수신위치(표준노드링크)
revX string 메시지수신위치(경도)
revY string 메시지수신위치(위도)
occrrncId string 이벤트ID
xml인 경우
<?xml version='1.0' encoding='UTF-8'?> <response>
<header>
<resultCode>0</resultCode>
<resultMsg>SUCCESS</resultMsg>
</header>
<body>
<totalCount>24</totalCount>
<items>
<item>
<message>전방 2 3 차로차단 추돌 주의</message>
<stepType>0</stepType>
<outbrkType>차로차단</outbrkType>
<priority>1</priority>
<routeName/>
<routeNo>0251</routeNo>
<roadDrcType>하행</roadDrcType>
<startStdLinkId>3260041601</startStdLinkId>
<startX>127.2864</startX>
<startY>35.0467</startY>
<revRouteName>호남선</revRouteName>
<revRouteNo>0251</revRouteNo>
<revRoadDrcType>하행</revRoadDrcType>
<revStdLinkId>3260049900</revStdLinkId>
<revX>127.2694</revX>
<revY>35.0691</revY>
<occrrncId>20201127073022000004</occrrncId>
</item>
</items>
</body>
</response>
◦ 주의운전구간 정보 제공 예시는 다음과 같다.
- 20 -
json인 경우
{
"response": {
"header": {
"resultcode": 0,
"resultmsg": "SUCCESS"
},
"body": {
"totalcount": 24,
"items": {
"item": {
"message": "전방 2 3 차로차단 추돌 주의",
"steptype": 0,
"outbrktype": "차로차단",
"priority": 1,
"routename": {},
"routeno": 169,
"roaddrctype": "하행",
"startstdlinkid": 3260041601,
"startx": 127.2864,
"starty": 35.0467,
"revroutename": "호남선",
"revrouteno": 169,
"revroaddrctype": "하행",
"revstdlinkid": 3260049900,
"revx": 127.2694,
"revy": 35.0691,
"occrrncid": 20201127073022000000
}
}
}
}
}
- 21 -
정보명 가변형 속도제한표지 정보 요청
정보 세항목 공개키, 출력결과형식
설명 가변형 속도제한표지 정보 요청을 위해 설정해야할 변수
요청변수 값 설명
apiKey string 공개키
getType string 출력 결과 형식(xml, json / 기본: xml)
정보명 가변형 속도제한표지 정보 제공
정보 세항목
VSL ID, 고속도로/국도 구분 코드, 생성 일시, 연계 일시, 제
한 속도, 기본 제한 속도, 도로 번호, 링크 ID, 경도 좌표, 위도
좌표, 등록 일시
설명 고속도로 및 국도의 가변속도표지 정보
출력변수 값 설명
vslId string VSL ID
sectionCode string 고속도로/국도 구분 코드 (1: 고속도로 / 2: 국도)
createdDate string 생성 일시(YYYYMMDDHH24MISS)
cntcedDate string 연계 일시
limitSpeed string 제한 속도(km/h)
dftLmtSpeed string 기본 제한 속도(km/h)
roadNo string 도로 번호
linkId string 링크 ID
coordX string 경도 좌표
coordY string 위도 좌표
registedDate string 등록 일시(YYYYMMDDHH24MISS)
xml인 경우
<?xml version='1.0' encoding='UTF-8'?> <response>
<header>
5.8. 가변형 속도제한표지 정보
5.8.1. 가변형 속도제한표지 정보 요청
◦ 가변형 속도제한표지 정보를 요청하기 위한 세부 항목은 다음과 같다.
5.8.2. 가변형 속도제한표지 정보 제공
◦ 제공되는 가변형 속도제한표지 정보의 세부내용은 다음과 같다.
◦ 가변형 속도제한표지 정보 제공 예시는 다음과 같다.
- 22 -
<resultCode>0</resultCode>
<resultMsg>SUCCESS</resultMsg>
</header>
<body>
<totalCount>24</totalCount>
<items>
<item>
<vslId>0010VLS00200</vslId>
<sectionCode>1</sectionCode>
<createdDate>20201216185059</createdDate>
<limitSpeed>100</limitSpeed>
<defLmtSpeed>100</defLmtSpeed>
<roadNo>1000</roadNo>
<linkId>2040000100</linkId>
<coordX>37.53549</coordX>
<coordY>127.18711</coordY>
<registedDate>20201216185018</registedDate>
</item>
</items>
</body>
</response>
json인 경우
{
"response": {
"header": {
"resultcode": 0,
"resultmsg": "SUCCESS"
},
"body": {
"totalcount": 24,
"items": {
"item": {
"vslid": "0010VLS00200",
"sectioncode": 1,
"createddate": 20201216185059,
"limitspeed": 100,
"deflmtspeed": 100,
"roadno": 1000,
"linkid": 2040000100,
"coordx": 37.53549,
"coordy": 127.18711,
"registeddate": 20201216185018
}
}
}
}
}
- 23 -
6. 재검토 기한
◦ 국토교통부장관은 「훈령·예규 등의 발령 및 관리에 관한 규정」에
따라 이 고시에 대하여 2021년 9월 1일 기준으로 매 3년이 되는 시
점(매 3년째의 8월 31일까지를 말한다)마다 그 타당성을 검토하여 개
선 등의 조치를 해야 한다.
부 칙(2021. 9. 1. 제정)
이 고시는 발령한 날부터 시행한다.
- 24 -
부록. 서비스 및 사용자 인증방식
□ 서비스 방식
ㅇ REST(REpresentational State Transfer) 방식: REST는 월드
와이드 웹과 같은 분산 하이퍼미디어 시스템을 위한 소프트웨어
아키텍처의 한 형식으로, HTTP와 XML을 이용하여 데이터를
주고받는 웹 서비스
ㅇ JSON(JavaScript Object Notation) 방식: 송신과 수신 쪽에서
새 데이터 요소를 패키지화하고 해제하는 추가 작업이 적고, 일
반적으로 JSON 표현의 구조와 데이터를 처리하는 코드의 구조
사이에서는 매핑이 더 쉽기 때문에 보다 수월한 송수신 서비스
□ 사용자 인증 방식
ㅇ 사용자 인증은 정보를 제공하는 센터에서 결정하며, 인증시
Token 인증 등의 방식을 사용할 수 있다.
