해양위성정보

개발자 가이드

1. 개요

1.1. 목적

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

1.2. API 호출 절차

1) 사용자가 API키 발급 요청을 하면 인증키가 2~3일 내로 메일을 통해 키 발급이 된다. 사용자 별로 API키 발급은 1개만 발급합니다.
3) 취득한 인증키를 이용하여 본 시스템에서 제공하는 모든 해양위성정보 OPEN API 서비스 호출합니다.
4) 관리자는 필요한 경우, 경우에 따라 API 사용을 제한하거나 인증키를 삭제합니다.

1.3. 사용 제한

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

1.4. 개발환경

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

1.5. 문의사항

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

2. 사용 예제

2.1. 요청/응답 메시지

요청주소 :http://www.khoa.go.kr/nosc/satellite/api/meta/search.do?ServiceKey=인증키&startDate=20201222&endDate=20201223&slot=2&ResultType=json

요청변수(Request Parameter)

항목명(영문)	항목명(국문)	샘플데이터	비고
ServiceKey	인증키	a0f388e85ec2f9f259e1d25247106f5db144f94fc34e4927a8c4ecd51bd433d1
startDate	검색 시작일자	20201020
endDate	검색 종료일자	20201022
slot	영상 슬롯번호	2	슬롯번호 0~11 (13번 : 한반도 전체 영역 영상 슬롯번호)
ResultType	결과타입	json, xml

출력결과 (Response Element)

항목명(영문)	항목명(국문)	샘플데이터	비고
Satellite	위성	GK2B
Sensor	센서	GOCI-II
Level	레벨	L1B
ObsArea	관측영역	한반도
fileName	파일명	GK2_GOCI2_L1B_20201027_081500_RLA_1.jpg
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)	2020-10-27 17:15:00 UTC
ObsTime(KST)	관측시간(KST)	2020-10-27 17:15:00 KST
MetaData	메타 데이터		정보보기

2.2. 응답 메시지(JSON)

			{
				"resultCode": "200",
				"resultMsg": "성공",
				"totalCount": 2,
				"data": [{
					"sateName": "GK2B",
					"sensor": "GOCI-II",
					"sateLevel": "L1B",
					"obsArea": "한반도",
					"product": "",
					"slot": 2,
					"fileName": "GK2_GOCI2_L1B_20210113_021530_LA_S002.nc",
					"obsTimeUTC": "2021-01-13 02:15:30",
					"obsTimeKST": "2021-01-13 11:15:30",
					"metaData": {
						"acknowledgement": "",
						"comment": "",
						"conventions": "CF-1.6 ACDD-1.3",
						"creator_email": "kosc@kiost.ac.kr",
						"creator_name": "KIOST/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": "BAND_CNT = 12\nBAND1_THRESHOLD = 83.25651667\nBAND2_THRESHOLD = 90.0812654\nBAND3_THRESHOLD = 89.63409104\nBAND4_THRESHOLD = 69.4189555\nBAND5_THRESHOLD = 73.09733276\nBAND6_THRESHOLD = 52.19173528\nBAND7_THRESHOLD = 39.93854121\nBAND8_THRESHOLD = 38.15407331\nBAND9_THRESHOLD = 79.11057958\nBAND10_THRESHOLD = 28.83724487\nBAND11_THRESHOLD = 17.40420075\nBAND12_THRESHOLD = 18.71788365\nHG = /input/GK2_GOCI2_L1B_20210113_021500_RLA_S0002_HG.nc\nLG = /input/GK2_GOCI2_L1B_20210113_021500_RLA_S0002_LG.nc\nOUTPUT = /output/GK2_GOCI2_L1B_20210113_021530_LA_S002.nc\nSTATIC = /main_storage_temp/G2GS/STATIC\n",
						"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",
						"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": "RLA",
						"observation_start_time": "20210113_021817",
						"perspective_point_height": "35786000",
						"platform": "GK-2B",
						"prime_meridian_name": "Greenwich",
						"processing_end": null,
						"processing_level": "L1B",
						"processing_start": null,
						"product_name": "GK2_GOCI2_L1B_20210113_021530_LA_S002.nc",
						"product_version": "1.0.0_20191030",
						"projection_type": "GEOS",
						"publisher_email": "kosc@kiost.ac.kr",
						"publisher_name": "KIOST/KOSC",
						"publisher_url": "http://kosc.kiost.ac.kr",
						"reference": "GK2B GOCI-II L1B File Format Document",
						"reference_ellipsoid_name": "WGS 84",
						"semi_major_axis": "6378137",
						"semi_minor_axis": null,
						"slot_acquisition_time": "20210113_021817",
						"standard_name_vocabulary": "CF Standard Name Table v72",
						"sub_longitude": "128.2",
						"summary": "GK2B GOCI-II Level-1B Radiances",
						"time_synchro_obt": "663776297.0935601",
						"time_synchro_utc": "20210113_021817",
						"title": "GK2B GOCI-II Level-1B Radiances"
					}
				}, {
					"sateName": "GK2B",
					"sensor": "GOCI-II",
					"sateLevel": "L2",
					"obsArea": "한반도",
					"product": "FGI",
					"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:30",
					"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