1. 개발자센터
  2. API 활용 안내

API 활용 안내

오픈 API 활용에 필요한 정보를 확인하세요.

오픈API란?

오픈API는 일반적으로 여러 사람들이 공동적으로 사용할 필요가 있는 데이터에 대한 사용을 개방하고 사용자들이 해당 데이터에 대한 전문적인 지식이 없어도 쉽게 가공하여 사용할 수 있도록 데이터를 추상화하여 표준화한 인터페이스를 말합니다.

오픈 API 이용안내

오픈 API 활용 가이드 열기

1.서비스 확인:오픈API 제공서비스 확인 및 이용방법 확인, 2.인증키 신청:오픈API인증키 신청 및 발급, 3.API 적용:오픈API를 이용한 어플리 케이션 제작

  • 사용자가 API키 발급 요청을 하면 발급키가 자동 발급되며, 사용자 별로 API키 발급은 1개만 발급할 수 있습니다.
  • 발급받은 인증Key를 타인에게 제공, 공개하거나 공유할수 없습니다.
  • 관리자는 필요한 경우, 경우에 따라 API 사용을 제한하거나 발급키를 삭제할 수 있습니다.

오픈 API 활용 안내

복합융합(레저관광, 맞춤안전, 해상구역, 시설안전, 지명정보, 해상교통) -> 해상 맞춤 GIS 정보 표시

- 약 100여종의 해상관련 레이어 정보를 융ㆍ복합하여 해상 전문 지도 서비스를 구현할 수 있습니다.

개발 가이드

요청주소

http://www.khoa.go.kr/oceanmap/otmsWfsApi.do?ServiceKey=서비스키&Layer=레이어명&FILTER=조건&minlon=좌하단최소경도&minlat=좌하단최소위도&maxlon=우상단최대경도&maxlat=우상단최대위도&srsName=EPSG:4326

요청변수(Request Parameter)

* 표시 항목은 필수 입력 항목 입니다.

항목명(영문) 항목명(국문) 샘플데이터 비고
ServiceKey* API 인증키 YVhsxXlv5MxLgjjf07y81pVhqh8f3sUS3Py3uPBMA0w=
Layer* 레이어 TB_FACI_BEACH 해수욕장
FILTER 검색필터 <PropertyIsEqualTo>
<PropertyName>LEISURE_ID</PropertyName>
<Literal>15001600</Literal>
</PropertyIsEqualTo>
minlon 좌측하단 최소경도 127^30^30 도분초 ^구분자 사용
minlat 좌측하단 최소위도 36^30^30 도분초 ^구분자 사용
maxlon 우측상단 최대경도 128^30^30 도분초 ^구분자 사용
maxlat 우측상단 최대위도 37^30^30 도분초 ^구분자 사용
srsName 응답좌표계 EPSG:4326 기본값 EPSG:5179

응답 메시지(XML)

<?xml version="1.0" encoding="UTF-8"?>
<wfs:FeatureCollection xmlns="http://mapprime.all4land.com/"
   xmlns:wfs="http://www.opengis.net/wfs"
   xmlns:gml="http://www.opengis.net/gml"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:xlink="http://www.w3.org/1999/xlink"
   xsi:schemaLocation="http://www.opengis.net/wfs http://schemas.opengis.net/wfs/1.1.0/wfs.xsd
      http://www.opengis.net/gml http://schemas.opengis.net/gml/3.1.1/feature.xsd"
   numberOfFeatures="1" timeStamp="2017-04-25T17:15:03+09:00">
   <gml:boundedBy>
      <gml:Envelope srsName="EPSG:4326">
         <gml:lowerCorner>129.160136 35.158268</gml:lowerCorner>
         <gml:upperCorner>129.160136 35.158268</gml:upperCorner>
      </gml:Envelope>
   </gml:boundedBy>
   <gml:featureMember>
      <TB_FACI_BEACH gml:id="TB_FACI_BEACH.188">
         <gml:boundedBy>
            <gml:Envelope srsName="EPSG:4326">
               <gml:lowerCorner>129.160136 35.158268</gml:lowerCorner>
               <gml:upperCorner>129.160136 35.158268</gml:upperCorner>
            </gml:Envelope>
         </gml:boundedBy>
         <ID><![CDATA[20150189]]></ID>
         <LEISURE_ID><![CDATA[15001600]]></LEISURE_ID>
         <ATPT><![CDATA[26000]]></ATPT>
         <SIGUN><![CDATA[26000]]></SIGUN>
         <SE><![CDATA[LSR016]]></SE>
         <NM><![CDATA[해운대해수욕장]]></NM>
         <FACILITIES><![CDATA[샤워실, 탈의실, 화장실, 급수대, 매점, 파라솔]]></FACILITIES>
         <ADDR><![CDATA[부산시 해운대구 중동2로 11]]></ADDR>
         <PHOTO_NO><![CDATA[BEACH_0032.JPG]]></PHOTO_NO>
         <XCNTS><![CDATA[129.159944]]></XCNTS>
         <YDNTS><![CDATA[35.158572]]></YDNTS>
         <PPATH><![CDATA[해양레저관광/해수욕장/]]></PPATH>
         <ORIGIN><![CDATA[레져관광정보도]]></ORIGIN>
         <ORIYR><![CDATA[2014]]></ORIYR>
         <ORIORG><![CDATA[국립해양조사원]]></ORIORG>
         <AG_GEOM>
            <gml:Point srsName="EPSG:4326">
               <gml:pos>129.160136 35.158268</gml:pos>
            </gml:Point>
         </AG_GEOM>
      </TB_FACI_BEACH>
   </gml:featureMember>
									
구분명칭레이어명제공방식
레저관광해수욕장TB_FACI_BEACHWMS/WFS
레저관광캠핑장TB_FACI_CAMPSITEWMS/WFS
레저관광전시/박물관TB_FACI_EXHIBITWMS/WFS
레저관광축제TB_FACI_FESTIVALWMS/WFS
레저관광영화촬영지TB_FACI_FILMSITEWMS/WFS
레저관광전망대,조망시설TB_FACI_FISHINGOLEWMS/WFS
레저관광수산시장,회타운TB_FACI_FISHPORTWMS/WFS
레저관광낚시터,유어장TB_FACI_FSHLCWMS/WFS
레저관광수목원,식물원TB_FACI_GARDENWMS/WFS
레저관광해상교통TB_FACI_MARINTRAFFWMS/WFS
레저관광휴양림TB_FACI_RCRFCTWMS/WFS
레저관광일조낙조/경관도로TB_FACI_SCENICWMS/WFS
레저관광레저,스포츠TB_FACI_SPORTWMS/WFS
레저관광사찰,서원TB_FACI_TEMPLEWMS/WFS
레저관광테마파크TB_FACI_THEMEPARKWMS/WFS
레저관광해안산책마을TB_FACI_TRAILWMS/WFS
레저관광갯바위포인트TB_YACHT_RPNTWMS/WFS
레저관광선상낚시포인트TB_YACHT_SPOINTWMS/WFS
레저관광마리나정보TB_YACHT_MARINA_PWMS/WFS
레저관광소형선항만정보TB_SAILERWMS/WFS
지명정보해양지명TB_AREA_NAME_OCEANWMS/WFS
지명정보도서지명TB_AREA_NAME_LANDWMS/WFS
해상구역정보어장정보TL_DIST_FSHFRMWMS/WFS
해상구역정보국가어항TB_ZN_CYFSTWMS/WFS
해상구역정보연안항TB_ZN_CSHBWMS/WFS
해상구역정보환경보전해역TB_ZN_EVSRWMS/WFS
해상구역정보어업자원보호수역TB_ZN_FRRSPTWMS/WFS
해상구역정보어업자원수역TB_ZN_FRRSRWMS/WFS
해상구역정보어업금지구역TB_ZN_FRSPWMS/WFS
해상구역정보어로한계선TB_ZN_FSHLMTWMS/WFS
해상구역정보조업자제해역TB_ZN_FSHOPRWMS/WFS
해상구역정보산업폐기물투기구역TB_ZN_INDWSTEWMS/WFS
해상구역정보유조선통항금지해역TB_ZN_OKRWMS/WFS
해상구역정보지정항로TB_ZN_ROUTEWMS/WFS
해상구역정보해상훈련,사격구역TB_ZN_SEATNWMS/WFS
해상구역정보특정해역TB_ZN_SPCFSEAWMS/WFS
해상구역정보특정금지구역TB_ZN_SPCFSPWMS/WFS
해상구역정보무역항TB_ZN_TRDEPTWMS/WFS
해상구역정보교통안전특정해역TB_ZN_TRSFWMS/WFS
해상구역정보통항분리수역TB_ZN_TRSPWMS/WFS
해상구역정보영해한계선TB_ZN_TRTSEAWMS/WFS
해상구역정보광구TB_ZN_MINGWMS/WFS
해상교통안전선박사고VI_SHPACC_PWMS/WFS
해상교통안전해경사고TL_SHPACC_HK_PWMS/WFS
해상교통안전해양신판원사고TL_SHPACC_HS_PWMS/WFS
해상교통안전등대VI_LNDMRK_PWMS/WFS
해상교통안전인명사고VI_NSHPAC_PWMS/WFS
해상교통안전해안경비안전서TL_COAGUA_PWMS/WFS
해상교통안전소방서TL_FIRSTA_PWMS/WFS
해상교통안전병원TL_HOSPAL_PWMS/WFS
해상교통안전약국TL_PARMAC_PWMS/WFS
해상교통안전경찰서TL_POLSTA_PWMS/WFS
해상교통안전보건소TL_PUBHEA_PWMS/WFS
해상교통안전CCTVTL_CCTVVI_PWMS/WFS
해상교통안전간이치안출장소TL_POLTRP_PWMS/WFS
해상교통안전선거VI_DOCARE_AWMS/WFS
해상교통안전깊은수심항로부VI_DWRTPT_AWMS/WFS
해상교통안전도선항로VI_FERYRT_LWMS/WFS
해상교통안전묘박지VI_ACHBRT_PWMS/WFS
해상교통안전교통안전특정해역VI_ZN_TRSFWMS/WFS
해상교통안전양길항로부VI_TWRTPT_AWMS/WFS
해상교통안전일반항로VI_FAIRWY_AWMS/WFS
해상교통안전준설지역VI_DRGARE_AWMS/WFS
해상교통안전통항분리경계선VI_TSSBND_LWMS/WFS
해상교통안전통항분리구역VI_TSEZNE_AWMS/WFS
해상교통안전통항분리제도항로부VI_TSSLPT_AWMS/WFS
해상교통안전통항분리제도교차부VI_TSSCRS_AWMS/WFS
해상교통안전통항분리제도중앙선VI_TSELNE_LWMS/WFS
해상교통안전항로지도선VI_NAVLNE_LWMS/WFS
해상교통안전도선사승하선구역VI_PILBOP_PWMS/WFS
해상교통안전와류VI_WATTUR_LWMS/WFS
해상교통안전노출암VI_LNDARE_PWMS/WFS
해상교통안전간출암VI_UWTROC_PWMS/WFS
해상교통안전간출물골VI_TIDEWY_LWMS/WFS
맞춤안전매표소TL_TKTOFC_PWMS/WFS
맞춤안전샤워장TL_SHWROM_PWMS/WFS
맞춤안전야간불꽃놀이존TL_NIFIZO_PWMS/WFS
맞춤안전어린이물놀이시설TL_KIDZON_PWMS/WFS
맞춤안전흡연구역TL_SMOZON_PWMS/WFS
맞춤안전음수대TL_DRIFOU_PWMS/WFS
맞춤안전튜브대여소TL_TUBLND_PWMS/WFS
맞춤안전탈의실TL_DREROM_PWMS/WFS
맞춤안전레저기구탑승장TL_LEQMBD_PWMS/WFS
맞춤안전행정봉사실TL_ADSECE_PWMS/WFS
맞춤안전종합안내소TL_INFCEN_PWMS/WFS
맞춤안전안내표지판TL_INFSIG_PWMS/WFS
맞춤안전수상인명구조대TL_MALIRE_PWMS/WFS
맞춤안전인명구조장비함TL_RESCUE_PWMS/WFS
맞춤안전안전요원망루TL_WCHTWR_PWMS/WFS
맞춤안전재난경보시스템TL_WARSYS_PWMS/WFS
맞춤안전화장실TL_TOILET_PWMS/WFS
맞춤안전숙박업소TL_ACCOMM_PWMS/WFS
맞춤안전온천TL_HOTSPR_PWMS/WFS
맞춤안전주차장TL_PRKPLC_PWMS/WFS
맞춤안전관공서TL_PBLOFC_PWMS/WFS
맞춤안전레저안전선TL_LESALI_LWMS/WFS
맞춤안전수영안전선TL_SWMRES_LWMS/WFS
맞춤안전갯골VI_TIDCHA_AWMS/WFS
맞춤안전웅덩이VI_PUDDLE_AWMS/WFS
맞춤안전이안류(주요발생지점)VI_OFFCUR_AWMS/WFS
시설안전방위입표VI_BCNCAR_PWMS/WFS
시설안전측방표지입표VI_BCNLAT_PWMS/WFS
시설안전방위부표VI_BOYCAR_PWMS/WFS
시설안전안전수역부표VI_BOYSAW_PWMS/WFS
시설안전항해보조VI_BCNISD_PWMS/WFS
시설안전특수입표VI_BCNSPP_PWMS/WFS
시설안전대형개선부표VI_BOYINB_PWMS/WFS
시설안전특수부표VI_BOYSPP_PWMS/WFS
시설안전해상교통관제센터TL_VTSCEN_PWMS/WFS
시설안전항만구역VI_HRBARE_AWMS/WFS
시설안전부동교량VI_PONTON_LWMS/WFS
시설안전인공안선VI_SLCONS_LWMS/WFS
시설안전돌핀VI_MORFAC_PWMS/WFS
시설안전선석VI_BERTHS_PWMS/WFS
시설안전중장비(크레인)VI_CRANES_PWMS/WFS

오류 이벤트 처리

오픈API 요청시 요청변수(Request Parameter)를 넘겨주지 않거나, 유효하지 않는 경우에는 다음과 같은 오류 이벤트를 보여줍니다.

오류상황별 예제

오류 상황 에러 이벤트
ServiceKey가 없는 경우 ServiceKey is null
ServiceKey의 사용 기한이 만료된 경우 Use the authentication key is expired
API 호출의 하루 조회 허용 횟수가 초과한 경우The number of requested of today is [일허용수치] exceeded.
레이어가 없는 경우'TB_SAILED...' is not exist
레이어에 대한 사용 권한이 없는 경우Do not have authentification on this layer.
인증키의 사용 권한이 없는 경우
(예:민간 유형 인증키로 해양공간베이스맵 접근 시)
Do not have authentification on this ServiceKey.
조건에 해당하는 자료가 없는 경우unknown

오류 결과 화면 예제

ServiceKey가 없는 경우 { "result":"invalid ServiceKey."}