항공기상정보공공데이터개발 (OPEN API) 개발자가이드 1. 서비스개요 서비스정보 서비스 ID 서비스명 ( 국문 ) 서비스명 ( 영문 ) 서비스설명 SC-SD-WI-WB-001 항공기상정보 amoapi 항공기상전문 (METAR/SPECI, TAF, 공항경보, SIGMET, AIRMET) 서비스제공자정보 서비스보안 적용기술수준 서비스 URL 서비스 WADL 서비스배포정보 기관명 항공기상청 [ ] 서비스 Key [ ] 인증서 (GPKI) 서비스인증 / 권한 [ ] Basic (ID/PW) [O] 없음 [ ] WS-Security 메시지레벨암호화 [ ] 전자서명 [ ] 암호화 [0] 없음 전송레벨암호화 [ ] SSL [0] 없음 [ ] SOAP 1.2 인터페이스표준 (RPC-Encoded, Document Literal, Document Literal Wrapped) [ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타 교환데이터표준 [ O ] XML [ ] JSON [ ] MIME [ ] MTOM 개발환경 운영환경 개발환경 운영환경 서비스버전 http://localhost:8088/amoapi http://amoapi.kma.go.kr/amoapi 유효일자 배포일자 2018-03 서비스이력 [ O ] Request-Response [ ] Publish-Subscribe 메시지교환유형 [ ] Fire-and-Forgot [ ] Notification 메시지로깅수준성공 [O] Header [ ] Body 실패 [O] Header [O} Body 사용제약사항 ( 비고 ) 2. 오퍼레이션목록 일련번호 1 서비스명 ( 국문 ) 오퍼레이션명 ( 영문 ) 오퍼레이션명 ( 국문 ) metar/speci metar/speci MetarByAirport 2 taf taf TafByAirport 3 항공기상전문 wrng wrng Warning 4 sigmet sigmet SIGMET 5 airmet airmet AIRMET
오퍼레이션정보 호출메시지정보응답메시지정보 (1) METAR / SPECI 조회 오퍼레이션번호 1 오퍼레이션명 ( 국문 ) metar/speci 오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) metar/speci 오퍼레이션설명 Call Back URL 최대메시지사이즈 ICAO 공항코드를사용해국내공항의유효한 METAR/SPECI 전문을조회 * 참고자료 : METAR/SPECI 해석방법, METAR/SPECI 형판 [2Kbytes] 평균응답시간 [10ms] 초당최대트랜잭션 [30tps] 선행오퍼레이션 HTTP Method MetarByAirport 변수형 국내공항의 ICAO 코드 METAR/SPECI 리스트형 호출메시지의국내공항 ICAO 코드에따라유효한 METAR/SPECI 전문을제공한다. 1 요청메시지명세 http://amoapi.kma.go.kr/amoapi/metar /END POINT URL 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기항목구분샘플데이터항목설명 icao ICAO 코드 4 0 RKSI 2 응답메시지명세 METAR/SPECI 국내공항의 ICAO 코드 RKSI 인천공항 RKSS 김포공항 RKPC 제주공항 RKPK 김해공항 RKNY 양양공항 RKNW 원주공항 RKTU 청주공항 RKTN 대구공항 RKTH 포항공항 RKJJ 광주공항 RKJB 무안공항 RKJY 여수공항 RKPU 울산공항 RKPS 사천공항 RKJK 군산공항 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기항목구분샘플데이터항목설명 resultcode 결과코드 4 1 0000 결과코드 resultmsg 결과메시지 50 1 OK 결과메시지 icaocode ICAO 코드 4 1 RKSI ICAO 코드 airportname 공항명 100 1 인천공항공항명 metarmsg METAR/SPECI 전문 2100 1 METAR RKSI 082000Z 29010KT 7000 NSC 05/M01 Q1018 NOSIG= METAR/SPECI 전문
3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) 응답메시지 http://amoapi.kma.go.kr/amoapi/metar?icao=rksi <?xml version="1.0" encoding="utf-8"?> <response> <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> <body> <items> <metarmsg><![cdata[metar RKSI 082000Z 29010KT 7000 NSC 05/M01 Q1018 NOSIG=]]></metarMsg> </items> </body> </response>
(2) TAF 조회 오 오퍼레이션번호 2 오퍼레이션명 ( 국문 ) taf 퍼 오퍼레이션유형 조회 ( 목록 ) 오퍼레이션명 ( 영문 ) taf 레 ICAO 공항코드를사용해국내공항의유효한 TAF 전문을조회오퍼레이션설명이 * 참고자료 : TAF 해석방법, TAF 형판 션 Call Back URL 정 최대메시지사이즈 [2Kbytes] 보 평균응답시간 [10ms] 초당최대트랜잭션 [30tps] 호출 TafByAirport 메 변수형 시지 국내공항의 ICAO 코드 정보 선행오퍼레이션 응답 TAF 메시 리스트형 지정 호출메시지의국내공항 ICAO 코드에따라 TAF 전문을제공한다. 보 HTTP Method 1 요청메시지명세 /END POINT URL http://amoapi.kma.go.kr/amoapi/taf 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 항목구분 샘플데이터 항목설명 icao ICAO 코드 4 0 RKSI 국내공항의 ICAO 코드 RKSI 인천공항 RKSS 김포공항 RKPC 제주공항 RKPK 김해공항 RKNY 양양공항 RKNW 원주공항 RKTU 청주공항 RKTN 대구공항 RKTH 포항공항 RKJJ 광주공항 RKJB 무안공항 RKJY 여수공항 RKPU 울산공항 RKPS 사천공항 RKJK 군산공항 2 응답메시지명세 TAF 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 항목구분 샘플데이터 항목설명 resultcode 결과코드 4 1 0000 결과코드 resultmsg 결과메시지 50 1 OK 결과메시지 icaocode ICAO 코드 4 1 RKSI ICAO 코드 airportname 공항명 100 1 인천공항 공항명 tafmsg TAF 전문 2100 1 TAF RKSI 090500Z 0906/1012 33020G35KT CAVOK TNM06/0920Z TX01/1005Z TAF 전문 BECMG 1003/1004 32015G25KT=
3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) 응답메시지 http://amoapi.kma.go.kr/amoapi/taf?icao=rksi <?xml version="1.0" encoding="utf-8"?> <response> <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> <body> <items> <tafmsg><![cdata[taf RKSI 090500Z 0906/1012 33020G35KT CAVOK TNM06/0920Z TX01/1005Z BECMG 1003/1004 32015G25KT=]]></tafMsg> </items> </body> </response>
오퍼레이션정보 호출메시지정보응답메시지정보 (3) 공항경보조회 오퍼레이션번호 3 오퍼레이션명 ( 국문 ) wrng 오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) wrng 오퍼레이션설명 Call Back URL 최대메시지사이즈 현재발효중인공항경보를조회 * 참고자료 : 공항경보, SIGMET, AIRMET 해석방법, 공항경보형판 [2Kbytes] 평균응답시간 [10ms] 초당최대트랜잭션 [30tps] 선행오퍼레이션 Warning 변수형 변수없음 WRNG 리스트형 현재발효중인공항경보전문을출력한다. HTTP Method 1 요청메시지명세 /END POINT URL http://amoapi.kma.go.kr/amoapi/wrng 2 응답메시지명세 WRNG 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기항목구분샘플데이터항목설명 resultcode 결과코드 4 1 0000 결과코드 resultmsg 결과메시지 50 1 OK 결과메시지 tm 발표시각 12 1 201511080852 년월일시분 UTC (yyyymmddhhmm) icaocode ICAO 코드 4 1 RKSI ICAO 코드 airportname 공항명 100 1 인천공항공항명 wrngtype 특보종류 20 1 윈드시어 validtm1 발효시작 12 1 201511070358 validtm1 발효종료 12 1 201511082359 발효시작시각 UTC (yyyymmddhhmm) 발효종료시각 UTC (yyyymmddhhmm) wrngmsg 공항경보전문 2100 1 RKSI WS CLIMB-OUT WRNG 1 140400 VALID 140400/140800 WS RWY ALL 공항경보전문
3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) 응답메시지 http://amoapi.kma.go.kr/amoapi/wrng <?xml version="1.0" encoding="utf-8"?> <response> <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> <body> <items> <tm>201511080852</tm> <wrngtype> 윈드시어 </wrngtype> <validtm1>201511070358</validtm1> <validtm2>201511082359</validtm2> <wrngmsg><![cdata[rksi WS CLIMB-OUT WRNG 1 140400 VALID 140400/140800 WS RWY ALL=]]></wrngMsg> <tm>201511080852</tm> <wrngtype> 윈드시어 </wrngtype> <validtm1>201511070358</validtm1> <validtm2>201511082359</validtm2> <wrngmsg><![cdata[rksi WS CLIMB-OUT WRNG 1 140400 VALID 140400/140800 WS RWY ALL=]]></wrngMsg> </items> </body> </response>
(4) SIGMET 조회 오퍼레이션번호 4 오퍼레이션명 ( 국문 ) sigmet 오퍼레이션정보 오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) sigmet 오퍼레이션설명 Call Back URL 최대메시지사이즈 현재발효중인 SIGMET 정보조회 * 참고자료 : 공항경보, SIGMET, AIRMET 해석방법, SIGMET,AIRMET 형판 [2Kbytes] 평균응답시간 [10ms] 초당최대트랜잭션 [30tps] 호출메시지정보 응답메시지정보 SIGMET 변수형 변수없음 선행오퍼레이션 SIGMET 리스트형 현재발효중인 SIGMET 전문을출력한다. HTTP Method 1 요청메시지명세 /END POINT URL http://amoapi.kma.go.kr/amoapi/sigmet 2 응답메시지명세 SIGMET 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기 항목구분 샘플데이터 항목설명 resultcode 결과코드 4 1 0000 결과코드 resultmsg 결과메시지 50 1 OK 결과메시지 tmdate 발효일 10 1 20050323 년월일 UTC (yyyymmdd) icaocode ICAO 코드 4 1 RKSI ICAO 코드 airportname 공항명 100 1 인천공항 공항명 sttm 시작일시분 6 1 232050 시작일시분 UTC edtm 종료일시분 6 1 240050 종료일시분 UTC sigmetmsg SIGMET 전문 2100 1 INCHEON FIR ISOL TS FCST TOP FL200 IN AREA BOUNDED BY 36N126E 36N128E 35N128E 35N126E AND 36N126E MOV E 07KT NC SIGMET 전문
3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) 응답메시지 http://amoapi.kma.go.kr/amoapi/sigmet <?xml version="1.0" encoding="utf-8"?> <response> <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> <body> <items> <tmdate>20050323</tmdate> <sttm>232050</sttm> <edtm>240050</edtm> <sigmetmsg><![cdata[incheon FIR ISOL TS FCST TOP FL200 IN AREA BOUNDED BY 36N126E 36N128E 35N128E 35N126E AND 36N126E MOV E 07KT NC]]></sigmetMsg> <tmdate>20050323</tmdate> <sttm>231800</sttm> <edtm>232200</edtm> <sigmetmsg><![cdata[incheon FIR ISOL TS FCST TOP FL200IN AREA BOUNDED BY 34N125E 34N128E 32N128E 32N125E AND 34N125E MOV SE 07KT NC]]></sigmetMsg> <tmdate>20050323</tmdate> <sttm>231000</sttm> <edtm>231400</edtm> <sigmetmsg><![cdata[incheon FIR FRQ TS FCST TOP FL260 IN AREA BOUNDED BY 38N 128E 38N 129E 35N 129E 35N 128E AND 38N 128E MOV E 07KT INTSF]]></sigmetMsg> </items> </body> </response>
오퍼레이션정보 호출메시지정보 응답메시지정보 (5) AIRMET 조회 오퍼레이션번호 5 오퍼레이션명 ( 국문 ) airmet 오퍼레이션유형조회 ( 목록 ) 오퍼레이션명 ( 영문 ) airmet 오퍼레이션설명 Call Back URL 최대메시지사이즈 현재발효중인 AIRMET 정보조회 * 참고자료 : 공항경보, SIGMET, AIRMET 해석방법, SIGMET,AIRMET 형판 [2Kbytes] 평균응답시간 [10ms] 초당최대트랜잭션 [30tps] 선행오퍼레이션 AIRMET 변수형 변수없음 AIRMET 리스트형 현재발효중인 AIRMET 전문을출력한다. HTTP Method 1 요청메시지명세 /END POINT URL http://amoapi.kma.go.kr/amoapi/airmet 2 응답메시지명세 AIRMET 항목명 ( 영문 ) 항목명 ( 국문 ) 항목크기항목구분샘플데이터항목설명 resultcode 결과코드 4 1 0000 결과코드 resultmsg 결과메시지 50 1 OK 결과메시지 tmdate 발효일 10 1 20050323 년월일 UTC (yyyymmdd) icaocode ICAO 코드 4 1 RKSI ICAO 코드 airportname 공항명 100 1 인천공항공항명 sttm 시작일시분 6 1 232050 시작일시분 UTC edtm 종료일시분 6 1 240050 종료일시분 UTC airmetmsg AIRMET 전문 2100 1 INCHEON FIR SFC VIS 5000M RA BR AND BKN CLD 1000FT OBS BOUNDED BY N3734E12617 N3757E12821 N3539E12901 N3437E12552 N3522E12549 N3553E12723 AND N3734E12617 MOV SE 05KT WKN= AIRMET 전문
3 요청 / 응답메시지예제 SOAP( 요청메세지 ) REST(URI) 응답메시지 http://amoapi.kma.go.kr/amoapi/airmet <?xml version="1.0" encoding="utf-8"?> <response> <header> <resultcode>0000</resultcode> <resultmsg>ok</resultmsg> </header> <body> <items> <tmdate>20071119</tmdate> <sttm>191540</sttm> <edtm>191940</edtm> <airmetmsg><![cdata[incheon FIR SFC VIS 5000M RA BR AND BKN CLD 1000FT OBS BOUNDED BY N3734E12617 N3757E12821 N3539E12901 N3437E12552 N3522E12549 N3553E12723 AND N3734E12617 MOV SE 05KT WKN=]]></airmetMsg> <tmdate>20071119</tmdate> <sttm>191540</sttm> <edtm>191940</edtm> <airmetmsg><![cdata[incheon FIR SFC VIS 5000M RA BR AND BKN CLD 1000FT OBS BOUNDED BY N3734E12617 N3757E12821 N3539E12901 N3437E12552 N3522E12549 N3553E12723 AND N3734E12617 MOV E 05KT NC=]]></airmetMsg> </items> </body> </response>