-  -

Open API 활용가이드

공공데이터 개방•공유•활용 체계 개발

Open API 활용가이드

1. 서비스 명세	3

1.1 공공데이터 OpenAPI 조회 서비스	3

가. API 서비스 개요	3

나. 상세기능 목록	4

다. 상세기능내역	4

1) [사망교통사고정보 Rest 조회] 상세기능명세	4

2) [사망교통사고정보 WMS 조회] 상세기능명세	22

2. OpenAPI 에러 코드정리	24

3. 사망교통사고정보 코드표	25

1. 서비스 명세

1.1 공공데이터 OpenAPI 조회 서비스

가. API 서비스 개요

API 서비스 정보	API명(영문)	AccidentDeath
	API명(국문)	사망교통사고정보 조회 서비스
	API 설명	① 발생연도, 시도코드, 시군구코드를 이용하여 발생월일시, 주야구분코드, 사고요일코드, 사망자수, 부상자수 등의 ② 년도별 사망교통사고정보를 제공하는 ③사망교통사고정보 조회서비스
API 서비스 보안적용 기술 수준	서비스 인증/권한	[O] ServiceKey [ ] 인증서 (GPKI/NPKI) [ ] Basic (ID/PW) [ ] 없음
	메시지 레벨 암호화	[ ] 전자서명 [ ] 암호화 [O] 없음
	전송 레벨 암호화	[ ] SSL [O] 없음
	인터페이스 표준	[ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal Wrapped) [O] REST (GET) [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타
	교환 데이터 표준 (중복선택가능)	[O] XML [O] JSON [ ] MIME [ ] MTOM
API 서비스 배포정보	서비스 URL	http://apis.data.go.kr/B552061/AccidentDeath
	서비스 명세 URL (WSDL 또는 WADL)	N/A
	서비스 버전	1.1
	서비스 시작일	2015-12-29	서비스 배포일	2015-12-29
	서비스 이력	2015-12-29 : 서비스 시작 2019-01-02 : 항목 변경 후 서비스 재시작 2020-07-14 : 항목 변경
	메시지 교환유형	[O] Request-Response [ ] Publish-Subscribe [ ] Fire-and-Forgot [ ] Notification
	서비스 제공자	박해수 / 도로교통공단 데이터융합처 / 033-749-5266 / phsoo@koroad.or.kr
	데이터 갱신주기	연 1회

나. 상세기능 목록

번호	API명(국문)	상세기능명(영문)	상세기능명(국문)
1	사망교통사고정보 조회 서비스	getRestTrafficAccidentDeath	사망교통사고정보 Rest 조회
2	사망교통사고정보 조회 서비스	getWMSTrafficAccidentDeath	사망교통사고정보 WMS 조회

다. 상세기능내역

1) [사망교통사고정보 Rest 조회] 상세기능명세

a) 상세기능정보

상세기능 번호	1	상세기능 유형	조회 (목록)
상세기능명(국문)	사망교통사고정보 Rest 조회
상세기능 설명	① 년도별, 시도코드, 시군구코드를 이용해 ② 발생년도, 발생월일시, 발생분, 주야구분코드, 사고요일코드, 사망자수, 부상자수, 중상자수, 경상자수, 부상신고자수, 발생지시도코드, 발생지시군구코드, 사고유형코드, 도로형태 코드, 발생위치 등 ③ 사망교통사고정보를 조회하는 기능
Call Back URL	http://apis.data.go.kr/B552061/AccidentDeath/getRestTrafficAccidentDeath
최대 메시지 사이즈	[16000] byte
평균 응답 시간	[1293] ms	초당 최대 트랙잭션	[166] tps

b) 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
ServiceKey	인증키	100	1	인증키 (URL Encode)	공공데이터포털에서 발급받은 인증키
searchYear	연도코드	7	1	2019	조회하고자 하는 연도값 입력
siDo	시도코드	4	1	1100	법정동 시도 코드
guGun	시군구코드	4	1	1117	법정동 시군구 코드
type	데이터유형	4	0	xml	결과형식(xml/json)
numOfRows	검색건수	4	1	10	검색건수
pageNo	페이지 번호	4	1	1	페이지 번호

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

c) 응답 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
resultCode	결과 코드	4	1	0000	API호출 결과 코드
resultMsg	결과 메시지	100	1	Success	API호출 결과 메시지
acc_year	사고년도	4	1	2019	사고년도
occrrnc_dt	발생월일시	10	1	2019011622	발생월일시
dght_cd	주야구분코드	1	1	2	주야구분코드
occrrnc_day_cd	발생요일코드	1	1	4	발생요일코드
dth_dnv_cnt	사망자수	3	1	0	사망자수
injpsn_cnt	부상자수	3	1	1	부상자수
se_dnv_cnt	중상자수	3	1	1	중상자수
sl_dnv_cnt	경상자수	3	1	0	경상자수
wnd_dnv_cnt	부상신고자수	3	1	0	부상신고자수
occrrnc_lc_sido_cd	발생위치시도코드	4	1	1100	발생위치시도코드
occrrnc_lc_sgg_cd	발생위치시군구코드	10	1	1117	발생위치시군구코드
acc_ty_lclas_cd	사고유형대분류코드	10	1	02	사고유형대분류코드
acc_ty_mlsfc_cd	사고유형중분류코드	10	1	23	사고유형중분류코드
acc_ty_cd	사고유형코드	2	1	23	사고유형코드
aslt_vtr_cd	가해자법규위반코드	3	1	01	가해자법규위반코드
road_frm_lclas_cd	도로형태대분류코드	10	1	01	도로형태대분류코드
road_frm_cd	도로형태코드	2	1	04	도로형태코드
wrngdo_isrty_vhcty_lclas_cd	가해당사자종별코드	10	1	01	가해당사자종별코드
dmge_isrty_vhcty_lclas_cd	피해당사자종별코드	10	1	01	피해당사자종별코드
occrrnc_lc_x_crd	발생위치X좌표	8	1	943817	발생위치X좌표 (EPSG 5179)
occrrnc_lc_y_crd	발생위치Y좌표	8	1	1945678	발생위치Y좌표 (EPSG 5179)
lo_crd	경도좌표	16	1	128.45275545	발생경도좌표 (EPSG 4326)
la_crd	위도좌표	15	1	35.94815032	발생위도좌표 (EPSG 4326)
totalCount	총건수	5	1	19	검색결과 총건수
numOfRows	검색건수	4	1	10	검색건수
pageNo	페이지 번호	4	1	1	페이지 번호

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

d) 요청/응답 메시지 예제

요청메시지

http://apis.data.go.kr/B552061/AccidentDeath/getRestTrafficAccidentDeath?ServiceKey=인증키&searchYear=2019&siDo=1100&guGun=1116&numOfRows=20&pageNo=1

응답메시지

<response>

<header>

<resultCode>00</resultCode>

<resultMsg>NORMAL_CODE</resultMsg>

</header>

<body>

<items>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019011622</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>4</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>01</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>11</acc_ty_mlsfc_cd>

<acc_ty_cd>01</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>01</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>12</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>961407  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1945530 </occrrnc_lc_y_crd>

<lo_crd>127.06333169</lo_crd>

<la_crd>37.50823969</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019012213</occrrnc_dt>

<dght_cd>1</dght_cd>

<occrrnc_day_cd>3</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>2</injpsn_cnt>

<se_dnv_cnt>1</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>02</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>24</acc_ty_mlsfc_cd>

<acc_ty_cd>25</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>05</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>03</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>959104  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1945529 </occrrnc_lc_y_crd>

<lo_crd>127.03727474</lo_crd>

<la_crd>37.50813147</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019021200</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>3</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>02</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>24</acc_ty_mlsfc_cd>

<acc_ty_cd>25</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>01</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>05</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>958931  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1942954 </occrrnc_lc_y_crd>

<lo_crd>127.03546115</lo_crd>

<la_crd>37.48491435</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019021218</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>3</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>02</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>22</acc_ty_mlsfc_cd>

<acc_ty_cd>22</acc_ty_cd>

<aslt_vtr_cd>99 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>01</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>01</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>960592  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1947218 </occrrnc_lc_y_crd>

<lo_crd>127.05401993</lo_crd>

<la_crd>37.5234198</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019021304</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>4</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>01</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>12</acc_ty_mlsfc_cd>

<acc_ty_cd>02</acc_ty_cd>

<aslt_vtr_cd>01 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>01</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>12</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>959294  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1944810 </occrrnc_lc_y_crd>

<lo_crd>127.03946428</lo_crd>

<la_crd>37.50165926</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019032103</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>5</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>3</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>2</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>02</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>24</acc_ty_mlsfc_cd>

<acc_ty_cd>25</acc_ty_cd>

<aslt_vtr_cd>01 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>03</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>02</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>960453  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1947768 </occrrnc_lc_y_crd>

<lo_crd>127.05241729</lo_crd>

<la_crd>37.5283712</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019032715</occrrnc_dt>

<dght_cd>1</dght_cd>

<occrrnc_day_cd>4</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>01</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>15</acc_ty_mlsfc_cd>

<acc_ty_cd>05</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>02</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>12</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>958006  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1947460 </occrrnc_lc_y_crd>

<lo_crd>127.02474124</lo_crd>

<la_crd>37.52548689</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019060123</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>7</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>01</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>15</acc_ty_mlsfc_cd>

<acc_ty_cd>05</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>01</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>12</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>959677  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1948034 </occrrnc_lc_y_crd>

<lo_crd>127.04362037</lo_crd>

<la_crd>37.53073513</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019080712</occrrnc_dt>

<dght_cd>1</dght_cd>

<occrrnc_day_cd>4</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>01</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>14</acc_ty_mlsfc_cd>

<acc_ty_cd>04</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>05</road_frm_lclas_cd>

<road_frm_cd>98</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>10</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>12</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>958055  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1945129 </occrrnc_lc_y_crd>

<lo_crd>127.02542886</lo_crd>

<la_crd>37.50447454</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019100300</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>5</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>01</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>15</acc_ty_mlsfc_cd>

<acc_ty_cd>05</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>01</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>12</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>959880  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1944149 </occrrnc_lc_y_crd>

<lo_crd>127.04612998</lo_crd>

<la_crd>37.49572708</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019102117</occrrnc_dt>

<dght_cd>1</dght_cd>

<occrrnc_day_cd>2</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>03</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>31</acc_ty_mlsfc_cd>

<acc_ty_cd>32</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>05</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>##</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>962470  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1944382 </occrrnc_lc_y_crd>

<lo_crd>127.07541751</lo_crd>

<la_crd>37.49793614</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019110122</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>6</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>2</injpsn_cnt>

<se_dnv_cnt>1</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>02</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>23</acc_ty_mlsfc_cd>

<acc_ty_cd>23</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>01</road_frm_lclas_cd>

<road_frm_cd>05</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>05</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>01</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>962801  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1944513 </occrrnc_lc_y_crd>

<lo_crd>127.07915545</lo_crd>

<la_crd>37.4991303</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019112100</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>5</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>2</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>1</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>02</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>21</acc_ty_mlsfc_cd>

<acc_ty_cd>21</acc_ty_cd>

<aslt_vtr_cd>03 </aslt_vtr_cd>

<road_frm_lclas_cd>02</road_frm_lclas_cd>

<road_frm_cd>08</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>05</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>01</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>959598  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1944871 </occrrnc_lc_y_crd>

<lo_crd>127.0429036</lo_crd>

<la_crd>37.50222065</la_crd>

</item>

<item>

<acc_year>2019</acc_year>

<occrrnc_dt>2019123105</occrrnc_dt>

<dght_cd>2</dght_cd>

<occrrnc_day_cd>3</occrrnc_day_cd>

<dth_dnv_cnt>1</dth_dnv_cnt>

<injpsn_cnt>1</injpsn_cnt>

<se_dnv_cnt>0</se_dnv_cnt>

<sl_dnv_cnt>0</sl_dnv_cnt>

<wnd_dnv_cnt>0</wnd_dnv_cnt>

<occrrnc_lc_sido_cd>1100</occrrnc_lc_sido_cd>

<occrrnc_lc_sgg_cd>1116</occrrnc_lc_sgg_cd>

<acc_ty_lclas_cd>01</acc_ty_lclas_cd>

<acc_ty_mlsfc_cd>12</acc_ty_mlsfc_cd>

<acc_ty_cd>02</acc_ty_cd>

<aslt_vtr_cd>05 </aslt_vtr_cd>

<road_frm_lclas_cd>02</road_frm_lclas_cd>

<road_frm_cd>08</road_frm_cd>

<wrngdo_isrty_vhcty_lclas_cd>03</wrngdo_isrty_vhcty_lclas_cd>

<dmge_isrty_vhcty_lclas_cd>12</dmge_isrty_vhcty_lclas_cd>

<occrrnc_lc_x_crd>964440  </occrrnc_lc_x_crd>

<occrrnc_lc_y_crd>1943029 </occrrnc_lc_y_crd>

<lo_crd>127.09776931</lo_crd>

<la_crd>37.48581893</la_crd>

</item>

</items>

<totalCount>14</totalCount>

<numOfRows>14</numOfRows>

<pageNo>1</pageNo>

</body>

</response>

2) [사망교통사고정보 WMS 조회] 상세기능명세

a) 상세기능정보

상세기능 번호	2	상세기능 유형	조회(이미지)
상세기능명(국문)	사망교통사고정보 WMS 조회
상세기능 설명	① 년도별 시도코드, 시군구코드를 이용해 ② 사망교통사고정보를 조회하여 PNG형태의 이미지를 조회하는 기능
Call Back URL	http://apis.data.go.kr/B552061/AccidentDeath/getWMSTrafficAccidentDeath
최대 메시지 사이즈	[16000] byte
평균 응답 시간	[6534] ms	초당 최대 트랙잭션	[26] tps

b) 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	항목구분	샘플데이터	항목설명
ServiceKey	인증키	100	1	인증키 (URL Encode)	공공데이터포털에서 발급받은 인증키
layers	레이어	11	1	accdeath	레이어를 결정 accdeath 고정값 사용
format	포맷	9	1	image/png	이미지 포맷을 결정 image/png 고정값 사용
transparent	투영성	4	1	true	이미지의 투영성을 결정 TRUE 고정값 사용
service	서비스형태	3	1	WMS	서비스 형태를 결정 WMS 고정값 사용
version	버전	5	1	1.1.1	서비스 버전을 결정 1.1.1 고정값 사용
request	요청	6	1	GetMap	요청 형태를 결정 GetMap 고정값 사용
srs	좌표계	11	1	EPSG:4326	좌표계를 결정 EPSG:4326 고정값 사용
bbox	바운더리박스	21	1	126.0,33.0,132.0,38.5	바운더리박스로 대각선의 좌표를 결정 기본값(전국) : 126.0,33.0,132.0,38.5
width	가로	3	1	512	결과 이미지의 가로 크기를 결정, 기본값 : 512
height	세로	3	1	469	결과 이미지의 세로 크기를 결정, 기본값 : 469
searchYear	연도코드	7	1	2019	검색을 원하는 사망교통사고ID
siDo	시도코드	4	1	1100	법정동 시도 코드
guGun	시군구코드	4	1	1117	법정동 시군구 코드

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

c) 응답 메시지 명세

이미지 파일로 출력되기 때문에 응답 메시지 명세 없음

d) 요청/응답 메시지 예제

요청메시지

http://apis.data.go.kr/B552061/AccidentDeath/getWMSTrafficAccidentDeath?ServiceKey=인증키 &layers=accdeath&format=image/png&transparent=true&service=WMS&version=1.1.1&request=GetMap&bbox=126.0,33.0,132.0,38.5&width=512&height=469&srs=EPSG:4326&searchYear=2019&siDo=&guGun=

응답메시지

에러코드	에러메시지	설명
1	APPLICATION_ERROR	어플리케이션 에러
10	INVALID_REQUEST_PARAMETER_ERROR	잘못된 요청 파라메터 에러
12	NO_OPENAPI_SERVICE_ERROR	해당 오픈API서비스가 없거나 폐기됨
20	SERVICE_ACCESS_DENIED_ERROR	서비스 접근거부
22	LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR	서비스 요청제한횟수 초과에러
30	SERVICE_KEY_IS_NOT_REGISTERED_ERROR	등록되지 않은 인증키
31	DEADLINE_HAS_EXPIRED_ERROR	기한만료된 인증키
32	UNREGISTERED_IP_ERROR	등록되지 않은 IP
99	UNKNOWN_ERROR	기타에러

2. OpenAPI 에러 코드정리

3. 사망교통사고정보 코드표

3.1 SearchYear 요청값

API 종류	년도	searchYear 입력값
사망교통사고	2022년도	2022
	2021년도	2021
	2020년도	2020
	2019년도	2019
	2018년도	2018
	2017년도	2017
	2016년도	2016
	2015년도	2015
	2014년도	2014
	2013년도	2013
	2012년도	2012

3.2 siDo 요청값

종류	Sido 입력값
서울특별시	1100
부산광역시	1200
대전광역시	2500
대구광역시	2200
광주광역시	2400
인천광역시	2300
울산광역시	2600
세종특별자치시	2700
경기도	1300
강원특별자치도	1400
충청남도	1600
충청북도	1500
전라남도	1800
전라북도	1700
경상남도	2000
경상북도	1900
제주특별자치도	2100

3.3 guGun 요청값

시도	구군명칭	gugun 입력값
서울특별시	강남구	1116
	강동구	1117
	강북구	1124
	강서구	1111
	관악구	1115
	광진구	1123
	구로구	1112
	금천구	1125
	노원구	1122
	도봉구	1107
	동대문구	1105
	동작구	1114
	마포구	1110
	서대문구	1109
	서초구	1119
	성동구	1104
	성북구	1106
	송파구	1118
	양천구	1120
	영등포구	1113
	용산구	1103
	은평구	1108
	종로구	1101
	중구	1102
	중랑구	1121
부산광역시	강서구	1212
	금정구	1211
	기장군	1216
	남구	1207
	동구	1203
	동래구	1206
	북구	1208
	사상구	1215
	사하구	1210
	서구	1202
	수영구	1214
	연제구	1213
	영도구	1204
	중구	1201
	진구	1205
	해운대구	1209
대구광역시	남구	2204
	달서구	2207
	달성군	2208
	동구	2202
	북구	2205
	서구	2203
	수성구	2206
	중구	2201
인천광역시	강화군	2309
	계양구	2308
	미추홀구	2303
	남동구	2305
	동구	2302
	부평구	2304
	서구	2306
	연수구	2307
	옹진군	2310
	중구	2301
광주광역시	광산구	2404
	남구	2405
	동구	2401
	북구	2403
	서구	2402
대전광역시	대덕구	2505
	동구	2501
	서구	2503
	유성구	2504
	중구	2502
울산광역시	남구	2602
	동구	2603
	북구	2604
	울주군	2605
	중구	2601
세종특별자치시	세종특별자치시	2701
경기도	가평군	1322
	고양시	1318
	과천시	1332
	광명시	1309
	광주시	1319
	구리시	1310
	군포시	1333
	김포시	1327
	남양주시	1334
	동두천시	1330
	부천시	1306
	성남시	1303
	수원시	1302
	시흥시	1316
	안산시	1307
	안성시	1326
	안양시	1305
	양주시	1311
	양평군	1323
	여주시	1313
	연천군	1320
	오산시	1335
	용인시	1325
	의왕시	1336
	의정부시	1304
	이천시	1324
	파주시	1317
	평택시	1308
	포천시	1321
	하남시	1337
	화성시	1315
강원특별자치도	강릉시	1404
	고성군	1422
	동해시	1403
	삼척시	1407
	속초시	1405
	양구군	1420
	양양군	1423
	영월군	1415
	원주시	1402
	인제군	1421
	정선군	1417
	철원군	1418
	춘천시	1401
	태백시	1406
	평창군	1416
	홍천군	1412
	화천군	1419
	횡성군	1413
충청북도	괴산군	1516
	단양군	1520
	보은군	1512
	영동군	1514
	옥천군	1513
	음성군	1517
	제천시	1503
	증평군	1521
	진천군	1515
	청원군	1511
	청주시	1501
	충주시	1502
충청남도	계룡시	1624
	공주시	1605
	금산군	1611
	논산시	1615
	당진시	1623
	보령시	1604
	부여군	1616
	서산시	1606
	서천군	1617
	아산시	1603
	연기군	1613
	예산군	1621
	천안시	1602
	청양군	1619
	태안군	1612
	홍성군	1620
전라북도	고창군	1719
	군산시	1702
	김제시	1706
	남원시	1705
	무주군	1713
	부안군	1720
	순창군	1717
	완주군	1711
	익산시	1723
	임실군	1715
	장수군	1714
	전주시	1701
	정읍시	1704
	진안군	1712
전라남도	강진군	1822
	고흥군	1818
	곡성군	1813
	광양시	1808
	구례군	1814
	나주시	1806
	담양군	1812
	목포시	1802
	무안군	1825
	보성군	1819
	순천시	1804
	신안군	1832
	여수시	1803
	영광군	1828
	영암군	1824
	완도군	1830
	장성군	1829
	장흥군	1821
	진도군	1831
	함평군	1827
	해남군	1823
	화순군	1820
경상북도	경산시	1935
	경주시	1903
	고령군	1923
	구미시	1906
	군위군	1912
	김천시	1904
	문경시	1909
	봉화군	1932
	상주시	1910
	성주군	1924
	안동시	1905
	영덕군	1917
	영양군	1916
	영주시	1907
	영천시	1908
	예천군	1930
	울릉군	1934
	울진군	1933
	의성군	1913
	청도군	1922
	청송군	1915
	칠곡군	1925
	포항시	1902
경상남도	거제시	2010
	거창군	2028
	고성군	2022
	김해시	2008
	남해군	2024
	마산시	2001
	밀양시	2009
	사천시	2023
	산청군	2026
	양산시	2016
	의령군	2012
	진주시	2003
	진해시	2005
	창녕군	2014
	창원시	2004
	창원시(통합)	2030
	통영시	2006
	하동군	2025
	함안군	2013
	함양군	2027
	합천군	2029
제주특별자치도	서귀포시	2102
	제주시	2101

3.4 요일코드

요일코드	요일
OCCRRNC_DAY_CD	OCCRRNC_DAY_NM
1	일
2	월
3	화
4	수
5	목
6	금
7	토

3.5 주야코드

주야코드	주야
DGHT_CD	DGHT_NM
1	주간
2	야간

3.6 사고유형코드

사고유형코드_ 대분류	사고유형 코드_중분류	사고유형코드	사고유형_ 대분류	사고유형_중분류	사고유형
ACC_TY_LCLAS_CD	ACC_TY_MLSFC_CD	ACC_TY_CD	ACC_TY_LCLAS_NM	ACC_TY_MLSFC_NM	ACC_TY_NM
01	11	01	차대사람	횡단중	횡단중
01	12	02	차대사람	차도통행중	차도통행중
01	13	03	차대사람	길가장자리구역 통행중	길가장자리구역통행중
01	14	04	차대사람	보도통행중	보도통행중
01	15	05	차대사람	기타	기타
02	21	21	차대차	정면충돌	정면충돌
02	22	22	차대차	측면충돌	측면충돌
02	23	23	차대차	추돌	추돌
02	23	Z1	차대차	추돌	진행중 추돌
02	23	Z2	차대차	추돌	주정차중 충돌
02	24	25	차대차	기타	기타
02	26	26	차대차	후진중충돌	후진중충돌
03	31	32	차량단독	공작물충돌	공작물충돌
03	32	34	차량단독	도로이탈	도로이탈 추락
03	32	35	차량단독	도로이탈	도로이탈 기타
03	33	33	차량단독	주/정차차량 충돌	주/정차차량 충돌
03	34	31	차량단독	전도전복	전도전복
03	35	37	차량단독	기타	기타
03	36	36	차량단독	운전자부재	운전자부재
03	38	38	차량단독	전도	전도
03	39	39	차량단독	전복	전복
04	41	41	철길건널목	철길건널목	철길건널목
04	Z2	Z4	철길건널목	차단기돌파	차단기돌파
04	Z3	Z5	철길건널목	경보기무시	경보기 무시
04	Z4	Z6	철길건널목	직전진행	직전진행
04	Z5	Z7	철길건널목	기타	기타
99	Z6	Z8	기타	기타	기타
##	##	##	없음	없음	없음

3.7 차종코드

가해·피해당사자차종별코드	가해·피해당사자차종별
wrngdo_istry_vhcty_lclas_cd, dmge_istry_vhcty_lclas_cd	wrngdo_istry_vhcty_lclas_nm, dmge_istry_vhcty_lclas_nm
01	승용차
02	승합차
03	화물차
04	특수차
05	이륜차
06	사륜오토바이(ATV)
07	원동기장치자전거
08	자전거
09	개인형이동수단(PM)
10	건설기계
11	농기계
12	보행자
98	기타
99	불명
Z1	열차
ZL	기타
##	없음

3.8 도로형태코드

도로형태코드_대분류코드	도로형태코드	도로형태_대분류	도로형태
ROAD_FRM_LCLAS_CD	ROAD_FRM_CD	ROAD_FRM_LCLAS_NM	ROAD_FRM_NM
01	01	단일로	터널안
01	02	단일로	교량위
01	03	단일로	고가도로위
01	04	단일로	지하차도(도로)내
01	05	단일로	기타단일로
01	Z1	단일로	횡단보도상
01	Z2	단일로	횡단보도부근
02	06	교차로	교차로내
02	07	교차로	교차로횡단보도내
02	08	교차로	교차로부근
04	10	철길건널목	철길건널목
05	98	기타	기타
99	99	불명	불명
Z3	Z3	기타/불명	기타/불명
##	##	없음	없음

3.9 법규위반코드

※ 과속 항목은 2021년 통계부터는 별도 집계되어 법규위반 항목에서는 제외

가해자법규위반코드	가해자법규위반
ASLT_VTR_CD	ASLT_VTR_NM
01	과속
02	중앙선 침범
03	신호위반
04	안전거리 미확보
05	안전운전 의무 불이행
06	교차로 통행방법 위반
07	보행자 보호의무 위반
99	기타