다운로드

우리의 바다 천리안으로 보다

OPEN API

개요

1.1. 목적

본 개발가이드는 현 시스템이 제공하고 있는 해양위성정보를 OPEN API를 통해 손쉽게 사용할 수 있도록 하는데 목적이 있습니다.

1.2. API 호출 절차

  • 1) 사용자가 API키 발급 요청을 하면 API키 조회 화면에서 발급된 키를 확인할 수 있습니다.
  • 2) 취득한 인증키를 이용하여 본 시스템에서 제공하는 모든 해양위성정보 OPEN API 서비스 호출합니다.
  • 3) 관리자는 필요한 경우, 경우에 따라 API 사용을 제한하거나 인증키를 삭제합니다.

1.3. 사용 제한

  • - 상업적 이용이 불가능한 API에 대해 상업적으로 활용한 경우
  • - 또는 트래픽 초과로 인해 시스템이 부하가 발생할 경우 관리자가 사용을 제한할 수 있습니다.
  • - API는 부하를 고려하여 일일 20000건으로 제한되어 있습니다.
  • - API요청 건수를 늘리고자 하는 사용자 또는 활용기관은 관리자와 협의를 통해 진행하실 수 있습니다.

1.4. 개발환경

  • - OPEN API는 누구나 쉽게 사용할 수 있도록 자바스크립트 형태로 제공하여 별도의 개발환경 제한을 두고 있지 않음
  • - Explorer 8.0 이상, Chrome, FireFox, Safari 지원
  • - REST(Representation State Transfer) 방식으로 서비스 제공

1.5. 문의사항

본 사이트에서 제공하는 API에 대해 문의사항을 우리원 홈페이지 자유게시판으로 보내주시면 성실히 답변드리겠습니다.

사용 예제

2.1. 요청/응답 메시지

요청주소   http://nosc.go.kr/openapi/meta/search.do?ServiceKey=인증키&startDate=20210113&endDate=20210114&slot=2&ResultType=json
요청변수(Request Parameter)
항목명(영문) 항목명(국문) 샘플데이터 비고
ServiceKey 인증키 a0f388e85ec2f9f259e1d25247106f5db144f94fc34e4927a8c4ecd51bd433d1
startDate 검색 시작일자 20210113
endDate 검색 종료일자 20210114
slot 영상 슬롯번호 2 슬롯번호 0~11
(13번 : 한반도 전체 영역
영상 슬롯번호)
ResultType 결과타입 json, xml
출력결과 (Response Element)
항목명(영문) 항목명(국문) 샘플데이터 비고
Satellite 위성 GK2B
Sensor 센서 GOCI-II
Level 레벨 L1B
ObsArea 관측영역 한반도
fileName 파일명 GK2B_GOCI2_L2_20210113_021530_LA_S002_FGI.nc
slot 영상 슬롯번호 2 슬롯번호 0~11
(13번 : 한반도 전체 영역영상 슬롯번호)
product 산출물 AC AC: 대기보정 IOP:고유 광특성 산출물 Kd:하향 확산 감쇠 계수 Zsd:세키깊이 SSC:표층 해류 CF:해양 전선 LSSS:저염분수 SI:해빙 Chl:엽록소농도 RI:적조 지수 FA:부유 조류 FGI:어장환경지수 PP:해양 일차 생산력 CDOM:용존 유기물 TSS:총 부유물 농도 MF:해무 AOD:에어로졸 광학 두께 SRL:육상지표반사도 LSAB:육상알베도-광대역 LSAN:육상알베도-협대역 VI:식생지수 LCC:토지피복
ObsTime(UTC) 관측시간(UTC) 2021-01-13 02:15:30 UTC
ObsTime(KST) 관측시간(KST) 2021-01-13 11:15:30 KST
MetaData 메타 데이터 정보보기

2.2. 응답 메시지(JSON)

{"resultCode":"200","resultMsg":"성공","totalCount":1,"data":[{"sateName":"GK2B","sensor":"GOCI-II","sateLevel":"L1B","obsArea":"한반도","product":"","slot":2,"fileName":"GK2B_GOCI2_L2_20210113_021530_LA_S002_FGI.nc","obsTimeUTC":"2021-01-13 02:15:30","obsTimeKST":"2021-01-13 11:15:300","metaData":{"acknowledgement":"","comment":"","conventions":"CF-1.6 ACDD-1.3","creator_email":"kosc@kiost.ac.kr","creator_name":"KOSC","creator_url":"http://kosc.kiost.ac.kr","earth_radius":"6378137","false_easting":"0","false_northing":"0","geographic_crs_name":"WGS 84","geospatial_lat_max":"48.769047","geospatial_lat_min":"38.014893","geospatial_lat_resolution":"250 meters","geospatial_lat_units":"degree_north","geospatial_lon_max":"149.51588","geospatial_lon_min":"136.94371","geospatial_lon_resolution":"250 meters","geospatial_lon_units":"degree_east","grid_mapping_name":"geostationary","history":"input:STATIC,CHL,KD,OC,SST__output:FGI","horizontal_datum_name":"WGS 1984","id":"GK2B_GOCI2_L2_20210113_021530_LA_S002_FGI.nc","image_center_latitude":"42.962868","image_center_longitude":"142.31635","image_lowerright_latitude":"38.266815","image_lowerright_longitude":"145.56505","image_upperleft_latitude":"48.298962","image_upperleft_longitude":"138.78926","institution":"KIOST, Korea Ocean Satellite Center","instrument":"GOCI-II","keywords":"","keywords_vocabulary":"","latitude_of_projection_origin":null,"license":"","longitude_of_projection_origin":"128.2","naming_authority":"kr.ac.kiost.kosc","nominal_satellite_height":"42164000","number_of_columns":"2780","number_of_lines":"2780","number_of_total_bands":null,"number_of_total_slots":"1","observation_end_time":"20210113_021909","observation_mode":"LA","observation_start_time":"20210113_021817","perspective_point_height":"35786000","platform":"GK-2B","prime_meridian_name":"Greenwich","processing_end":"20210113041319","processing_level":"L2","processing_start":"20210113041313","product_name":"GK2B_GOCI2_L2_20210113_021530_LA_S002_FGI.nc","product_version":"","projection_type":"GEOS","publisher_email":"kosc@kiost.ac.kr","publisher_name":"KIOST/KOSC","publisher_url":"http://kosc.kiost.ac.kr","reference":"","reference_ellipsoid_name":"WGS 84","semi_major_axis":"6378137","semi_minor_axis":null,"slot_acquisition_time":"20210113_021817","standard_name_vocabulary":"","sub_longitude":"0","summary":"GK2B GOCI-II Level-2 Data","time_synchro_obt":"663776297.0935601","time_synchro_utc":"20210113_021817","title":"GK2B GOCI-II Level-2 Data"}}]}

위성 메타데이터 정보

닫기
항목명(영문) 항목명(국문) 샘플데이터 비고
conventions 규칙 CF-1.6 ACDD-1.3
creator_email 연락처 이메일 kosc@kiost.ac.kr
creator_name 파일 생산자 KIOST/KOSC
ObsArea 관측영역 한반도
creator_url 생산자 홈페이지 주소 http://kosc.kiost.ac.kr
ObsTime(UTC) 관측시간(UTC) 2020-10-27 17:15:00 UTC
earth_radius 지구 반지름 6378137
false_easting 동쪽으로 측정된 거리향 0
false_northing 북쪽으로 측정된 거리 0
geographic_crs_name 좌표계 명 WGS 84
geospatial_lat_max 최대 위도 48.769047
geospatial_lat_min 최소 위도 38.014893
geospatial_lat_resolution 위도 공간 해상도 250 mter
geospatial_lat_units 위도 단위 degree_north
geospatial_lon_max 최대 경도 149.51588
geospatial_lon_min 최소 경도 136.94371
geospatial_lon_resolution 경도 공간 해상도 250 mter
geospatial_lon_units 경도 단위 degree_east
grid_mapping_name 격자 매핑 이름 geostationary
history 이력정보 BAND_CNT = 12 BAND1_THRESHOLD = 83.25651667 BAND2_THRESHOLD = 90.0812654 BAND3_THRESHOLD = 89.63409104 BAND4_THRESHOLD = 69.4189555 BAND5_THRESHOLD = 73.09733276 BAND6_THRESHOLD = 52.19173528 BAND7_THRESHOLD = 39.93854121 BAND8_THRESHOLD = 38.15407331 BAND9_THRESHOLD = 79.11057958 BAND10_THRESHOLD = 28.83724487 BAND11_THRESHOLD = 17.40420075 BAND12_THRESHOLD = 18.71788365 HG = /input/GK2_GOCI2_L1B_20210113_021500_RLA_S0002_HG.nc LG = /input/GK2_GOCI2_L1B_20210113_021500_RLA_S0002_LG.nc OUTPUT = /output/GK2_GOCI2_L1B_20210113_021530_LA_S002.nc STATIC = /main_storage_temp/G2GS/STATIC
horizontal_datum_name 수평 좌표계 WGS 1984
id 아이디 1.2.4_20201130/GK2_GOCI2_L1B_20210113_021530_LA_S002.nc
image_center_latitude 이미지 중심 위도 42.962868
image_center_longitude 이미지 중심 경도 142.31635
image_lowerright_latitude 이미지 하단 오른쪽 위도 38.266815
image_lowerright_longitude 이미지 하단 오른쪽 경도 145.56505
image_upperleft_latitude 이미지 외쪽 상단 위도 48.298962
image_upperleft_longitude 이미지 외쪽 상단 경도 138.78926
institution 생산기관 KIOST, Korea Ocean Satellite Center
instrument 활용 센서 GOCI-II
keywords 키워드 Earth Science > Oceans > Ocean Optics > Ocean Color
keywords_vocabulary 키워드 사전 NASA Global Change Master Directory (GCMD) Science Keywords
longitude_of_projection_origin 투영 원점 경도 128.2
naming_authority 생산자 kr.ac.kiost.kosc
nominal_satellite_height 위성고도 42164000
number_of_columns 데이터 컬럼수 2780
number_of_lines 데이터 라인 수 2780
number_of_total_slots 슬롯 갯수 1
observation_end_time 관측 종료 시간 20210113_021909
observation_mode 관측 모드 RLA
observation_start_time 관측 시작 시간 20210113_021817
perspective_point_height 투시점 높이 35786000
platform 위성명 GK-2B
prime_meridian_name 본초 자오선 Greenwich
processing_level 레벨 L1B
product_name 파밀 명 GK2_GOCI2_L1B_20210113_021530_LA_S002.nc
product_version 버전 1.0.0_20191030
projection_type 투영법 종류 GEOS
TOP