오픈API 상세

XML JSON

국립해양생물자원관_바다거북 이동경로

국립해양생물자원관이 운영하는 해양생명 공간정보시스템(OpenGIS)은 바다거북 개체의 이동경로를 시계열로 추적할 수 있는 공공데이터 API 서비스를 제공합니다. 이 서비스는 바다거북 개체에 부착된 송신기 고유번호(PTT ID)를 기반으로, 해당 개체의 메타정보를 조회할 수 있는 API와 함께, 수신기번호와 검색 시작일·종료일을 지정하여 바다거북의 이동 경로를 구성하는 관측일시, 위도, 경도 등 위치 정보를 조회할 수 있도록 구성되어 있습니다. 사용자는 이를 활용해 특정 개체의 이동 패턴을 분석하거나 해양보호생물의 생태 및 경로 모니터링, 시각화 기반 연구 등에 활용할 수 있으며, GIS 시스템과 연동하여 지도 기반의 분석도 가능해 해양환경 정책, 보전관리 등 다양한 분야에 실용적으로 기여할 수 있습니다.
다른 사용자들이 활용한 데이터
국립해양생물자원관_바다거북 이동경로로 오픈 API 정보 표로 분류체계, 제공기관 등 정보를 나타냄
분류체계 해양수산 - 해양수산·어촌 제공기관 국립해양생물자원관
관리부서명 다양성정책실 관리부서 전화번호
API 유형 REST 데이터포맷 JSON+XML
활용신청 158 키워드 공간정보,바다거북,이동경로,추적기관,방류지역,방류일,거북 성별,거북 몸무게
등록일 2021-11-15 수정일 2025-06-23
비용부과유무 무료 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
심의유형 개발단계 : 자동승인 / 운영단계 : 심의승인
공간범위 시간범위
이용허락범위
참고문서 국립해양생물자원관_해양생명자원통합시스템(MBRIS)_바다거북이동경로_OpenAPI_기술문서_20211123.docx

상세기능

바다거북 수신기 번호를 이용해 수신기번호, 추적시간, 추적위도, 추적경도를 조회하는 기능입니다. 추적이 종료된 수신기에 대해서만 조회합니다.

  • 활용승인 절차 개발단계 : 자동승인 / 운영단계 : 심의승인
  • 신청가능 트래픽 개발계정 : 10,000 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
  • 요청주소 http://apis.data.go.kr/B553482/SeaTurtleRouteService/getSeaTurtleRoute
  • 서비스URL http://apis.data.go.kr/B553482/SeaTurtleRouteService

요청변수(Request Parameter)

요청변수(Request Parameter)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
인증키 serviceKey 100 필수 인증키 (URL Encode) 공공데이터포털에서 발급받은 인증키
한 페이지 결과 수 numOfRows 4 옵션 20 한 페이지 결과 수 (값이 없을 경우 기본값 10, 최대 값 30, 그 이상 입력시에도 30으로 함)
페이지 번호 pageNo 4 옵션 2 페이지 번호 (값이 없을 경우 기본값 을 1 로 함)
수신기번호 pttId 10 필수 60811 데이터 상세 정보 조회를 위한 키값(예시 목록 조회 기능에서 확인 가능)
검색 시작일 obsStart 8 옵션 20180830 검색 시작일
검색 종료일 obsEnd 8 옵션 20180830 검색 종료일
응답 형태 resultType 5 옵션 xml 응답 형태

출력결과(Response Element)

출력결과(Response Element)

항목명(국문) 항목명(영문) 항목크기 항목구분 샘플데이터 항목설명
결과코드 resultCode 2 필수 00 결과코드
결과메시지 resultMsg 50 필수 NORMAL SERVICE 결과메시지
한 페이지 결과 수 numOfRows 4 옵션 20 요청한 한 페이지당 표출 데이터 수
페이지 번호 pageNo 4 옵션 2 페이지번호
페이지 총 개수 pageCount 4 옵션 6 페이지 총 갯수
데이터 총 개수 totalCount 4 옵션 115 데이터 총 개수
일련번호 gid 10 옵션 1282 공간정보 번호
수신기번호 pttId 10 옵션 60811 메타정보 조회를 바다거북 수신기 번호
관측시간 obsrTm 30 옵션 2018-09-19 09:32:00 관측시간
관측위치 위도 obsrLat 30 옵션 38.23095 관측위치 위도
관측위치 경도 obsrLon 30 옵션 130.28784 관측위치 경도

샘플코드

샘플코드는 PC에서 확인해주세요.

다른 사용자들이 활용한 데이터
이 데이터와 유사한 데이터