해양수산부 무인도서 종합정보제공

무인도서 OpenAPI

- 해양수산부에서 무인도서와 그 주변해역을 보전 및 관리하기 위해 구축한 무인도서 정보를 다른 정보시스템에서 연계·활용할 수 있도록 Open-API 서비스를 제공합니다.
- 무인도서 API는 무인도서 정보를 요청 형식에 따라 XML과 JSON 형식으로 제공받을 수 있도록 구현되어 있으며, 파일 데이터는 무인도서 통계 서비스에서 엑셀파일로 다운로드 받으실 수 있습니다.

요청 메시지 명세

- 요청 URL : http://uii.mof.go.kr/UII/api/openApi.do

API 호출 정보를 제공합니다
항목명(영문)	항목명(국문)	조건	설명	샘플데이터
serviceKey	인증키	필수	발급받은 인증키	Oo8YvUp5giSVM4Ws
format	데이터형식	필수	xml 또는 json	json
keyword	검색어	옵션	도서 명	오리바위,황도
numOfRows	페이지당 출력될 건수	옵션	기본값 : 10
pageNo	출력될 페이지 번호	옵션	기본값 : 1
sgg	시군구코드	옵션	법정동 시군구코드 5자리 * 행정표준코드 관리시스템 참고	26140
type	관리유형	옵션	무인도서 관리유형 절대보전 1000 준보전 0100 이용가능 0010 개발가능 0001 이용가능/개발가능 0011 준보전/개발가능 0101 미지정 0000	0001

응답 메시지 명세

출력결과 제공
출력명		출력 설명	샘플데이터
header	resultCode	응답코드	200
	resultMsg	응답 메시지	정상
	totalCnt	전체 데이터 개수	2918
contents	manageNo	관리번호	영해기점-05
	uiiNm	무인도서명	1.5미이터암
	sidoNm	시도명	부산광역시
	sigunguNm	시군구명	해운대구
	emdNm	읍면동명	송정동
	liNm	리명
	lnm	지번	945
	lnmAdiDc	지번 부가설명
	landPosesnSe	토지 소유 구분	국유지
	landOwnrList	토지 소유자	해양수산부
	ladAllAr	토지 전체 면적	50
	golndAr	국유지 면적	50
	publndAr	공유지 면적
	pvtlndAr	사유지 면적
	xtnAddtDc	면적 부가 설명
	lndcgr	지목	잡종지
	mngTyCd	무인도서 관리유형 코드	1000
	mngTy	무인도서 관리유형	절대보전
	cfrSareaMngCd	주변해역 관리유형 코드	1000
	cfrSareaMngTy	주변해역 관리유형	절대보전
	landDstc	육지와의 거리	0
	landDstcDc	육지와의 거리 부가설명
	prposSeList	용도 구분	도시지역미지정
	pnttrtseaUiiCn	영해기점 무인도서 유무	영해기점
	lat	위도	35.169228
	lot	경도	129.21747
	dsgnAncmntYmd	지정고시일(법정고시일)	2023-09-18

응답코드 제공
구분	응답코드	설명
SUCCESS	200	정상
ERROR	110	등록되지 않은 인증키입니다.
	120	사용 중지된 인증키 입니다.
	210	필수 파라미터가 누락되었습니다.
	220	파라미터 값이 유효하지 않습니다.
	230	제공되지 않는 데이터형식 입니다.
	900	알 수 없는 에러가 발생하였습니다.

샘플코드

API 샘플코드 정보를 제공합니다

/** java 샘플 코드 */ BufferedReader in = null; try { // 호출할url URL obj = new URL("http://uii.mof.go.kr/UII/api/openApi.do?serviceKey=인증키&format=데이터형식"); HttpURLConnection con = (HttpURLConnection)obj.openConnection(); con.setRequestMethod("GET"); in = new BufferedReader(new InputStreamReader(con.getInputStream(), "UTF-8")); String line; while((line = in.readLine()) != null) { // response를 차례대로 출력 System.out.println(line); } } catch(Exception e) { e.printStackTrace(); } finally { if(in != null) try { in.close(); } catch(Exception e){ e.printStackTrace(); } }
`/** javascript 샘플 코드 */ var xhttp = new XMLHttpRequest(); xhttp.onreadystatechange = function() { if (this.readyState == 4 && this.status == 200) { var response = xhttp.responseText; console.log(response); //response를 출력 } }; xhttp.open("GET", "http://uii.mof.go.kr/UII/api/openApi.do?serviceKey=인증키&format=데이터형식", true); xhttp.send();`

									
									/** java 샘플 코드 */
									BufferedReader in = null; 
									try { 
										// 호출할url
										URL obj = new URL("http://uii.mof.go.kr/UII/api/openApi.do?serviceKey=인증키&format=데이터형식"); 
										HttpURLConnection con = (HttpURLConnection)obj.openConnection();
										con.setRequestMethod("GET"); 
										in = new BufferedReader(new InputStreamReader(con.getInputStream(), "UTF-8")); 
										String line; 
										while((line = in.readLine()) != null) { 
											// response를 차례대로 출력
											System.out.println(line); 
										} 
									} catch(Exception e) {
										 e.printStackTrace(); 
									} finally { 
										if(in != null) 
										try { 
											in.close(); 
										} 	
										catch(Exception e){
											e.printStackTrace(); 
										} 
									}

									
									/** javascript 샘플 코드 */
									var xhttp = new XMLHttpRequest();
									xhttp.onreadystatechange = function() {
										if (this.readyState == 4 && this.status == 200) {
											var response = xhttp.responseText;
											console.log(response); //response를 출력
										}
									};
									xhttp.open("GET", "http://uii.mof.go.kr/UII/api/openApi.do?serviceKey=인증키&format=데이터형식", true);
									
									xhttp.send();