• Home
  • Alerts & Forecasts
  • Open API
  • 이용 가이드

Open API

우주전파센터의 콘텐츠를 Open API로 제공합니다.

Font Size zoom inzoom out

Print

  • 3일간의 우주전파환경 상황을 실시간으로 제공합니다.

    http://spaceweather.rra.go.kr/api/warn

    http://spaceweather.rra.go.kr/api/warn

    파라미터 타입 설명 비고
    없음
    타입 설명 비고
    warn Object 경보목록
    R Object 태양흑점 폭발
    V0 String 현재 등급
    V1 String 24시간전 등급
    V2 String 48시간전 등급
    S Object 태양입자 유입
    V0 String 현재 등급
    V1 String 24시간전 등급
    V2 String 48시간전 등급
    G Object 지자기 교란
    V0 String 현재 등급
    V1 String 24시간전 등급
    V2 String 48시간전 등급
    lastUpdate String 최종 업데이트 시각 밀리초
    error Boolean 오류 여부 true 면 오류 발생
    errorCode String 오류 발생 시 오류 코드
    {
    	warn: {
    		S: {
    			v0: "S0",
    			v1: "S0",
    			v2: "S0",
    		},
    		R: {
    			v0: "R0",
    			v1: "R0",
    			v2: "R0",
    		},
    		G: {
    			v0: "G0",
    			v1: "G0",
    			v2: "G1",
    		}
    	},
    	error: false,
    	lastUpdate: "1444175400000",
    	errorCode: "NOERR"
    }
    			        			

    예보 상황 제공 (발생 확률)

    예보 상황 설명

    태양흑점폭발 상태

    R1-R2 : 10-5이상에서 10-4미만사이
    R3 이상 : 10-4이상

    * 기준 : GOES위성에서 측정한 0.1~0.8 nm 범위의 X-ray 플럭스 값
    (단위 : W·m-2)

    태양입자 유입 상태

    S1 이상 : 10개이상

    * 기준 : GOES위성에서 측정한 10MeV 이상 고에너지 입자(양성자)의 5분 평균값
    (단위 : 개수·cm-2·s-1·ster-1)

    지자기 교란 상태

    G1 : Kp=5
    G2 이상 : Kp≥6

    * 기준 : 지상에서 관측한 지구 자기장 변화량 기준 (0 ~ 9까지 등급화)

    http://spaceweather.rra.go.kr/api/prob

    http://spaceweather.rra.go.kr/api/prob

    파라미터 타입 설명 비고
    없음
    타입 설명 비고
    prob Object 예보상황 목록
    R1D1 String R1 - R2 (0 ~ 24hr)
    R1D2 String R1 - R2 (24 ~ 48hr)
    R1D3 String R1 - R2 (48 ~ 72hr)
    R3D1 String R3 이상 (0 ~ 24hr)
    R3D2 String R3 이상 (24 ~ 48hr)
    R3D3 String R3 이상 (48 ~ 72hr)
    S1D1 String S1 - S2 (0 ~ 24hr)
    S1D2 String S1 - S2 (24 ~ 48hr)
    S1D3 String S1 - S2 (48 ~ 72hr)
    S3D1 String S3 이상 (0 ~ 24hr)
    S3D2 String S3 이상 (24 ~ 48hr)
    S3D3 String S3 이상 (48 ~ 72hr)
    G1MD1 String G1 - G2 (0 ~ 24hr)
    G1MD2 String G1 - G2 (24 ~ 48hr)
    G1MD3 String G1 - G2 (48 ~ 72hr)
    G2MD1 String G3 이상 (0 ~ 24hr)
    G2MD2 String G3 이상 (24 ~ 48hr)
    G2MD3 String G3 이상 (48 ~ 72hr)
    error Boolean 오류 여부 true 면 오류 발생
    errorCode String 오류 발생 시 오류 코드
    {
    	error: false,
    	errorCode: "NOERR",
    	prob: {
    		R1D1: "1",
    		R1D2: "1",
    		R1D3: "1",
    		R3D1: "1",
    		R3D2: "1",
    		R3D3: "1",
    		S1D1: "1",
    		S1D2: "1",
    		S1D3: "1",
    		S3D3: "1",
    		S3D2: "1",
    		S3D1: "1",
    		G1MD1: "50",
    		G1MD2: "40",
    		G1MD3: "60",
    		G2MD1: "10",
    		G2MD2: "10",
    		G2MD3: "20",
    		date: "2015-10-06 00:00:00"
    	}
    }
    			        			

    우주전파센터의 1일/3일/27일 예보를 제공합니다.

    예보 설명

    1일 예보 1일 예보는 매일 0시를 기준으로 3시간 간격으로 업데이트 됩니다. (현재 시범 운영중입니다.)
    3일 예보 3일 예보는 매일 오전 11시를 기준으로 24시간 간격으로 업데이트 됩니다.
    27일 예보 27일 예보는 매주 화요일 오전11시에 업데이트 됩니다.

    1일 예보 : http://spaceweather.rra.go.kr/api/forecast/day

    3일 예보 : http://spaceweather.rra.go.kr/api/forecast/day3

    27일 예보 : http://spaceweather.rra.go.kr/api/forecast/day27

    1일 예보 : http://spaceweather.rra.go.kr/api/forecast/day

    3일 예보 : http://spaceweather.rra.go.kr/api/forecast/day3

    27일 예보 : http://spaceweather.rra.go.kr/api/forecast/day27

    파라미터 타입 설명 비고
    count Int 출력할 예보 갯수 최근 count개 출력
    타입 설명 비고
    list Array 예보 목록
    subject String 예보 제목
    date String 예보 발표 일자
    summary String 예보 요약 HTML 코드
    writer String 발표자
    content String 예보 내용 HTML 코드
    error Boolean 오류 여부 true 면 오류 발생
    errorCode String 오류 발생 시 오류 코드

    1일 예보 : http://spaceweather.rra.go.kr/api/forecast/day?count=2

    
    {
    	error: false,
    	errorCode: "NOERR",
    	list: [
    		{
    			content: " <ul class="forecast"> <li class="last-24">가. 지난 24시간 우주전파환경 요약 <ul> <li> 지난 24시간 동안 발령된 우주전파환경은 1단계 수준이었음 <ul> <li> 1단계수준 전파두절 경보상황이 있었으며 현재 종료됨</li> </ul> </li> <!--또는 R, S, G 경보가 모두 없었을 경우 start --> <!--또는 R, S, G 경보가 모두 없었을 경우 stop --> </ul> </li> <br> <li class="future-24">나. 향후 24시간 우주전파환경 예보 <ul> <li> 향후 24시간 내에 우주전파환경 경보상황 발생 가능성이 낮음 <ul> </ul> </li> </ul> </li> </ul> ",
    			summary: null,
    			subject: "1일 우주전파환경 상황 및 예보",
    			date: "2015-02-04 00:00",
    			writer: "관리자"
    		},
    		{
    			content: " <ul class="forecast"> <li class="last-24">가. 지난 24시간 우주전파환경 요약 <ul> <li> 지난 24시간 동안 발령된 우주전파환경은 1단계 수준이었음 <ul> <li> 1단계수준 전파두절 경보상황이 있었으며 현재 종료됨</li> </ul> </li> <!--또는 R, S, G 경보가 모두 없었을 경우 start --> <!--또는 R, S, G 경보가 모두 없었을 경우 stop --> </ul> </li> <br> <li class="future-24">나. 향후 24시간 우주전파환경 예보 <ul> <li> 향후 24시간 내에 우주전파환경 경보상황 발생 가능성이 낮음 <ul> </ul> </li> </ul> </li> </ul> ",
    			summary: null,
    			subject: "1일 우주전파환경 상황 및 예보",
    			date: "2015-02-04 00:00",
    			writer: "관리자"
    		}
    	]
    }
    			        			

    지구자기장 관측데이터를 제공합니다.

    지구자기장 관측데이터 설명

    Kp Kp는 미국 NOAA SWPC(Space Weather Prediction Center)에서 위도 44 – 60도 사이의 8개 지자기 관측소에서의 구한 K 지수를 통합하여 산출하고 있다. SWPC는 일분 단위의 지자기 관측 자료를 이용하여 Kp 지수 값을 실시간으로 모니터링 한다. 실시간으로 지자기 관측소에서의 자료를 사용할 수 없는 경우에는, 사용 가능한 자료를 바탕으로 한 지수를 이용해서 가장 적절한 예측 값을 산출한다.
    Kk 지구와 지구 주위에는 자석과 같은 자성을 가지는 지자기가 존재한다. 이 지자기는 형태가 고정되어 있지는 않지만 규칙적으로 변화한다. 하지만 외부의 요인(태양풍, CME 등)으로 지자기의 변화가 규칙적인 변화보다 큰 지자기 교란이 발생한다. 즉, K 지수는 특정 지역에서의 지자기 변동의 정도를 로그스케일로 나타낸 지수이다 3시간에 한 번씩, 조용한 상태인 0에서 급변하는 상태 9까지로 표시된다.

    http://spaceweather.rra.go.kr/api/kindex

    http://spaceweather.rra.go.kr/api/kindex

    파라미터 타입 설명 비고
    없음
    타입 설명 비고
    kindex Object 관측 값 목록
    time String 최종 수집 시각 yyyy-MM-dd HH:mm:ss
    currentP Int 현재 Kp
    currentK Int 현재 Kk
    max24P Int 24시간내 최대 Kp
    max24K Int 24시간내 최대 Kk
    recent Array 최근 측정 값 목록
    itme String 수집 시각 yyyy-MM-dd HH:mm:ss
    kp Int 측정된 Kp
    kk Int 측정된 Kk
    lastUpdate String 최종 업데이트 시각 밀리초
    error Boolean 오류 여부 true 면 오류 발생
    errorCode String 오류 발생 시 오류 코드
    {
    	error: false,
    	lastUpdate: "1444175400000",
    	errorCode: "NOERR",
    	kindex: {
    		time: "2015-10-06 21:00:00",
    		currentP: 4,
    		currentK: 5,
    		max24P: 4,
    		max24K: 5,
    		recent: [
    			{
    				time: "2015-10-06 21:00:00",
    				kp: 4,
    				kk: 5
    			},
    			{
    				time: "2015-10-06 18:00:00",
    				kp: 3,
    				kk: 4
    			},
    			{
    				time: "2015-10-06 15:00:00",
    				kp: 3,
    				kk: 3
    			},
    			{
    				time: "2015-10-06 12:00:00",
    				kp: 2,
    				kk: 2
    			},
    			{
    				time: "2015-10-06 09:00:00",
    				kp: 3,
    				kk: 2
    			},
    			{
    				time: "2015-10-06 06:00:00",
    				kp: 4,
    				kk: 2
    			},
    			{
    				time: "2015-10-06 03:00:00",
    				kp: 3,
    				kk: 2
    			},
    			{
    				time: "2015-10-06 00:00:00",
    				kp: 2,
    				kk: 1
    			}
    		]
    	}
    }
    			        			

    탑승한 비행편에 대한 항공 우주방사선량 계산 정보를 제공합니다.

     

    비행편명 조회 입력한 날짜에 대한 비행편명을 조회합니다.
    항공 우주방사선량 계산 입력한 비행편명에 대한 누적 항공 우주방사선량(mSv)이 산출됩니다.

    비행편명 조회 : http://kswcpub.rra.go.kr:8081/safe/airall_openapi/getflightlist

    항공 우주방사선량 계산 : http://kswcpub.rra.go.kr:8081/safe/airall_openapi/getfightaccdose

    비행편명 조회 : http://kswcpub.rra.go.kr:8081/safe/airall_openapi/getflightlist?depDate=20160724

    항공 우주방사선량 계산 : http://kswcpub.rra.go.kr:8081/safe/airall_openapi/getfightaccdose?depDate=20160724&flight=AAR1135

    비행편명 조회

    파라미터 타입 설명 비고
    depDate String 항공기 탑승일자(출발일) UTC 기준

    항공 우주방사선량 계산

    파라미터 타입 설명 비고
    depDate String 항공기 탑승일자(출발일) UTC 기준
    flight String 항공편명 ICAO 표기명 기준 (예 : KE → KAL)

    비행편명 조회

    타입 설명 비고
    errorCode String 오류 발생 시 오류 코드
    flight String 항공편명 ICAO 기준
    airline String 항공사명

    항공 우주방사선량 계산

    타입 설명 비고
    errorCode String 오류 발생 시 오류 코드
    flight String 항공편명 ICAO 기준
    departure String 항공기 탑승일자(출발일) UTC 기준
    from_iata String 출발지 공항 IATA 기준(예 : ICN)
    to_iata String 도착지 공항 IATA 기준(예 : ICN)
    nairas_ins_val String NAIRAS 모델 순간 방사선량(μSv/hr) 소수점 4자리까지 출력
    nairas_acc_val String NAIRAS 모델 순간 방사선량(mSv) 소수점 4자리까지 출력
    cari6_ins_val String CARI-6 모델 순간 방사선량(μSv/hr) 소수점 4자리까지 출력
    cari6_acc_val String CARI-6 모델 순간 방사선량(mSv) 소수점 4자리까지 출력

    비행편명 조회

    {
      "flightList":{
        "Korean Air Lines Co., Ltd.":"KAL1851",
        "Jeju Air":"JJA8504",
        "Asiana Airlines":"AAR308",
        "Eastar Jet":"ESR614"
      },
      "errorCode":"NOERR"
    }
    			        			

    항공 우주방사선량 계산

    {
      "flightList":{
        "flight":"AAR1045",
        "departure":"2016-07-20 15:48",
        "from_iata":"GMP",
        "to_iata":"HND",
        "nairas_ins_val":"0.0014",
        "nairas_acc_val":"0.0002",
        "cari6_ins_val":"0.0021",
        "cari6_acc_val":"0.0004"
      },
      "errorCode":"NOERR"
    }
    			        			

    ACE 관측 데이터

     

    ACE Interplanetary Magnetic Field ACE위성에서 관측하는 행성간 자기장 정보를 제공합니다.
    ACE Solar Wind ACE 위성에서 관측하는 태양풍의 속도, 밀도, 온도 정보를 제공합니다.

    ACE Interplanetary Magnetic Field : http://spaceweather.rra.go.kr/api/ace/mag

    ACE Solar Wind : http://spaceweather.rra.go.kr/api/ace/sw

    ACE Interplanetary Magnetic Field : http://spaceweather.rra.go.kr/api/ace/mag

    ACE Solar Wind : http://spaceweather.rra.go.kr/api/ace/sw

    ACE Interplanetary Magnetic Field

    파라미터 타입 설명 비고
    입력 값 없음

    ACE Solar Wind

    파라미터 타입 설명 비고
    입력 값 없음

    ACE Interplanetary Magnetic Field

    타입 설명 비고
    error Boolean 오류 발생 여부 false: 오류 없음
    errorCode String 오류 발생 시 오류 코드
    data List 측정 값 목록
    time String 수집시각 Universal Time
    aceBx Float X성분 자기장 단위: nano Tesla
    aceBy Float Y성분 자기장
    aceBz Float Z성분 자기장
    aceBtotal Float 자기장 크기
    lastUpdate String 최종 업데이트 시각

    ACE Solar Wind

    타입 설명 비고
    error Boolean 오류 발생 여부 false: 오류 없음
    errorCode String 오류 발생 시 오류 코드
    data List 측정 값 목록
    data List 측정 값 목록
    time String 수집시각 Universal Time
    protonDensity Float 태양풍 밀도
    bulkSpeed Float 태양풍 속도
    ionTemp Float 태양풍 온도
    lastUpdate String 최종 업데이트 시각

    ACE Interplanetary Magnetic Field

    {
      "error": false,
      "errorCode":"NOERR",
      "data": [
      	{
      	  "time": "2016-07-20 15:40",
      	  "aceBx": 0.3,
      	  "aceBy": 0.4,
      	  "aceBz": 1,0,
      	  "aceBtotal": 0.5
      	},
      	...
      ],
      "lastUpdate": "2016-07-20 15:50:00"
    }
    			        			

    ACE Solar Wind

    {
      "error": false,
      "errorCode":"NOERR",
      "data": [
      	{
      	  "time": "2016-07-20 15:40",
      	  "protonDensity": 0.3,
      	  "bulkSpeed": 0.4,
      	  "ionTemp": 1,0,
      	},
      	...
      ],
      "lastUpdate": "2016-07-20 15:50:00"
    }
    			        			
    오류 코드 상황
    NOERR 오류 없음
    ERR001 수집 데이터 없음
    ERR002 수집 데이터 읽기 오류
    ERR003 수집 데이터 분석 오류