오픈API Data 상세보기
해안제방시설
XML WMS사용신청안내사항
공공데이터 제공제도
라이선스표시
- 공공데이터중 위치정보를 포함한 서비스를 사용하고자 하는 사업자는 '위치정보의 보호 및 이용 등에 관한 법률'에 따라 방송통신위원회에 '위치정보서비스 허가'를 받거나 '위치기반 서비스사업 신고'를 하여야 합니다.
- 이에 해당하는 사업자인 경우에는 첨부파일에 '위치기반서비스사업신고필증'을 첨부해 주시기 바랍니다.
- 활용신청 시 '위치기반서비스사업신고필증'이 등록되지 않으면 반려가 될 수 있으니 참고 하시기 바랍니다.
| 주요항목 | 국토지리정보원 연속수치지도 제방 정보 |
|---|
| 라이선스 |
생활안전지도는 “공공누리 4유형(출처표시,상업적이용금지, 변경금지)” 조건에 따라 이용할 수 있습니다.
|
|---|
| 분류체계 | 시설안전 | 제공기관 | 국토지리정보원 |
|---|---|---|---|
| 관리부서명 | 국토조사과 | 관리부서 전화번호 | 031-210-2713 |
| API 유형 | REST | 데이터 포맷 | XML + WMS |
| 활용 신청 | 17 | 갱신주기 | 1년 |
| 수집일 | 2024년 | 수정일 | 2024-11-22 |
| 주요항목 | 국토지리정보원 연속수치지도 제방 정보 | ||
| XML 호출 URL | safemap.go.kr/openapi2/IF_0056 (아래 예제 참고) | ||
| WMS 호출 URL | safemap.go.kr/openapi2/IF_0056_WMS (아래 예제 참고) | ||
| objt_id | name | fclty_ty | fclty_mt | fclty_cd | fclty_et | fclty_hg |
|---|---|---|---|---|---|---|
| 956132 | - | BKD001 | BKQ001 | C0052211 | 15.00000000000 | 2.0 |
| 956133 | - | BKD001 | BKQ004 | C0052211 | 78.00000000000 | 2.0 |
| 956134 | - | BKD001 | BKQ004 | C0052211 | 179.00000000000 | 2.0 |
| 956135 | - | BKD001 | BKQ001 | C0052211 | 43.00000000000 | 2.0 |
| 956136 | - | BKD001 | BKQ002 | C0052211 | 40.00000000000 | 2.0 |
| 956137 | - | BKD001 | BKQ004 | C0052211 | 116.00000000000 | 2.0 |
| 956138 | - | BKD001 | BKQ002 | C0052211 | 19.00000000000 | 2.0 |
| 956139 | - | BKD001 | BKQ001 | C0052211 | 29.00000000000 | 2.0 |
| 956140 | - | BKD001 | BKQ004 | C0052211 | 80.00000000000 | 2.0 |
| 956141 | - | BKD001 | BKQ001 | C0052211 | 28.00000000000 | 2.0 |
해안제방시설 정보조회 서비스
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|
| 인증키 | serviceKey | 필 | 인증키 (URL Encode) | 생활안전지도에서 발급받은 인증키 |
| 한 페이지 결과 수 | numOfRows | 필 | 10 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 필 | 1 | 페이지 번호 |
| 데이터 타입 | returnType | 옵 | XML | 요청자료형식(XML/JSON) Default : JSON |
공통결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목타입 |
|---|---|---|
| 결과코드 | resultCode | NUMBER |
| 결과메시지 | resultMsg | VARCHAR2 |
| 한 페이지 결과 수 | numOfRows | NUMBER |
| 페이지 번호 | pageNo | NUMBER |
| 데이터 총 개수 | totalCount | NUMBER |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목타입 | 항목설명 |
|---|---|---|---|
| 일련번호 | objt_id | INT | |
| 명칭 | name | STRING | |
| 시설유형 | fclty_ty | STRING | BKD000:미분류/BKD001:제방/BKD002:방파제/BKD003:방조제/BKD004:소파블럭 |
| 시설재질 | fclty_mt | STRING | BKQ000:미분류/BKQ001:콘크리트/BKQ002:흙/BKQ003:돌망태/BKQ004:석축/BKQ005:블록/BKQ999:기타 |
| 시설코드 | fclty_cd | STRING | C0050000 :제방(미분류)/ C0052220 :방조제(미분류)/ C0052221 :콘크리트방조제/ C0052223 :흙방조제/ C0052225 :기호방조제/ C0052230 :방파제(미분류)/ C0052231 :방파제/ C0052233 :소파블럭/ C0052234 :기호방파제 |
| 연장 | fclty_et | INT | |
| 높이 | fclty_hg | INT |
제공 데이터 예제
/* JAVA 샘플 코드 */
StringBuilder strBuilder = new StringBuilder("http://safemap.go.kr/openapi2/IF_0056"); /*URL*/
strBuilder.append("?" + URLEncoder.encode("serviceKey","UTF-8") + "=서비스키"); /*Service Key*/
strBuilder.append("&" + URLEncoder.encode("pageNo","UTF-8") + "=" + URLEncoder.encode("1", "UTF-8")); /*페이지번호*/
strBuilder.append("&" + URLEncoder.encode("numOfRows","UTF-8") + "=" + URLEncoder.encode("10", "UTF-8")); /*한 페이지 결과 수*/
strBuilder.append("&" + URLEncoder.encode("returnType","UTF-8") + "=" + URLEncoder.encode("xml", "UTF-8")); /*xml(기본값), JSON*/
URL url = new URL(strBuilder.toString());
HttpURLConnection con = (HttpURLConnection) url.openConnection();
해안제방시설
요청변수(Request Parameter)
| 항목명 | 샘플데이터 | 항목설명 |
|---|---|---|
| serviceKey | 인증키 (URL Encode) | 발급받은 인증키 |
| srs | 좌표계 | 예시 ) EPSG:4326 |
| bbox | 표시할 영역 범위 | 허용 범위 초과시 오류 |
| format | 이미지 포맷 | image/png ,image/jpeg |
| width | 가로크기 | 요청할 이미지 가로 크기(px) |
| height | 세로크기 | 요청할 이미지 세로 크기(px) |
| transparent | 배경 투명 여부 | TRUE/FALSE |
제공 데이터 예제 (url호출)
*서비스 호출
StringBuilder strBuilder = new StringBuilder("http://safemap.go.kr/openapi2/IF_0056_WMS"); /*URL*/ strBuilder.append("?" + URLEncoder.encode("serviceKey","UTF-8") + "=서비스키"); /*Service Key*/ strBuilder.append("&" + URLEncoder.encode("srs","UTF-8") + "=" + URLEncoder.encode("EPSG:4326", "UTF-8")); /*좌표계 */ strBuilder.append("&" + URLEncoder.encode("bbox","UTF-8") + "=" + URLEncoder.encode("126.84814453125,35.137879119634185,126.859130859375,35.146862906756304", "UTF-8")); /*표시할 영역 범위*/ strBuilder.append("&" + URLEncoder.encode("format","UTF-8") + "=" + URLEncoder.encode("image/png", "UTF-8")); /*format*/ strBuilder.append("&" + URLEncoder.encode("width","UTF-8") + "=" + URLEncoder.encode("256", "UTF-8")); /*요청할 이미지 가로 크기(px)*/ strBuilder.append("&" + URLEncoder.encode("height","UTF-8") + "=" + URLEncoder.encode("256", "UTF-8")); /*요청할 이미지 세로 크기(px)*/ strBuilder.append("&" + URLEncoder.encode("transparent","UTF-8") + "=" + URLEncoder.encode("TRUE", "UTF-8")); /*배경 투명 여부*/ URL url = new URL(strBuilder.toString()); HttpURLConnection con = (HttpURLConnection) url.openConnection();
StringBuilder strBuilder = new StringBuilder("http://safemap.go.kr/openapi2/IF_0056_WMS"); /*URL*/ strBuilder.append("?" + URLEncoder.encode("serviceKey","UTF-8") + "=서비스키"); /*Service Key*/ strBuilder.append("&" + URLEncoder.encode("srs","UTF-8") + "=" + URLEncoder.encode("EPSG:4326", "UTF-8")); /*좌표계 */ strBuilder.append("&" + URLEncoder.encode("bbox","UTF-8") + "=" + URLEncoder.encode("126.84814453125,35.137879119634185,126.859130859375,35.146862906756304", "UTF-8")); /*표시할 영역 범위*/ strBuilder.append("&" + URLEncoder.encode("format","UTF-8") + "=" + URLEncoder.encode("image/png", "UTF-8")); /*format*/ strBuilder.append("&" + URLEncoder.encode("width","UTF-8") + "=" + URLEncoder.encode("256", "UTF-8")); /*요청할 이미지 가로 크기(px)*/ strBuilder.append("&" + URLEncoder.encode("height","UTF-8") + "=" + URLEncoder.encode("256", "UTF-8")); /*요청할 이미지 세로 크기(px)*/ strBuilder.append("&" + URLEncoder.encode("transparent","UTF-8") + "=" + URLEncoder.encode("TRUE", "UTF-8")); /*배경 투명 여부*/ URL url = new URL(strBuilder.toString()); HttpURLConnection con = (HttpURLConnection) url.openConnection();
제공 데이터 예제 (OpenLayers)
*서비스 호출
param = { name:"해안제방시설", serverUrl:'www.safemap.go.kr/openApi2/IF_0056_WMS?serviceKey=[serviceKey]', layername:"A2SM_BEACHDIKEFCLTY", styles:"A2SM_BeachDikeFclty", }; var wmsLayer = new OpenLayers.Layer.WMS ( param.serverUrl, { layers: pram.layername, styles: pram.styles, format:"image/png", srs:"EPSG:3857", transparent: TRUE }, { isBaseLayer: false } ); wmsLayer.getFullRequestString = function(newParams, altUrl) { var url = OpenLayers.Layer.Grid.prototype.getFullRequestString.apply( this, arguments ); url = url.replace(/([?&])([^=]+)/g, function(match, sep, key){ if (key === "serviceKey") { return sep + key; } return sep + key.toLowerCase(); }); return url; };
*서비스 범례 호출(XML)
layer=레이어명&style=스타일명 (스타일명이 없는 서비스의 경우 layer 만 입력) 예) http://www.safemap.go.kr/openapi2/lgdInfo?serviceKey=인증키&intId=IF_0056
param = { name:"해안제방시설", serverUrl:'www.safemap.go.kr/openApi2/IF_0056_WMS?serviceKey=[serviceKey]', layername:"A2SM_BEACHDIKEFCLTY", styles:"A2SM_BeachDikeFclty", }; var wmsLayer = new OpenLayers.Layer.WMS ( param.serverUrl, { layers: pram.layername, styles: pram.styles, format:"image/png", srs:"EPSG:3857", transparent: TRUE }, { isBaseLayer: false } ); wmsLayer.getFullRequestString = function(newParams, altUrl) { var url = OpenLayers.Layer.Grid.prototype.getFullRequestString.apply( this, arguments ); url = url.replace(/([?&])([^=]+)/g, function(match, sep, key){ if (key === "serviceKey") { return sep + key; } return sep + key.toLowerCase(); }); return url; };
*서비스 범례 호출(XML)
layer=레이어명&style=스타일명 (스타일명이 없는 서비스의 경우 layer 만 입력) 예) http://www.safemap.go.kr/openapi2/lgdInfo?serviceKey=인증키&intId=IF_0056