항공기상

공항 근처의 관측과 예보, 특보 데이터를 제공합니다.

api 상세
개요

항공기상관측은 항공기 안전운항에 필요한 기상정보를 생산·제공하기 위하여 공항 내 기상상태를 항공기상관측지침에 의해 측정하는 업무이며, 해당 관측은 당해 공항 내에서 사용하는 보고와 당해 공항 밖으로 통보되는 보고로 구분됩니다.
항공기상관측은 정해진 시간간격을 두고 실시하는 정시관측 및 특정 기준에 해당하는 변화가 있을 때 실시하는 특별관측, 관제기관 등의 요청 및 항공기 사고 시 실시하는 수시관측이 있습니다.

요 소

풍향, 풍속, 하늘상태, 시정, 강수량 등

지 점

6개소 공항

생산주기

시간(특정 기준에 해당하는 변화 발생시 특별관측 수시 수행)

1. 항공기상전문 조회

호출URL정보

METAR/SPECI조회

https://apihub.kma.go.kr/api/typ02/openApi/AmmIwxxmService/getMetar?pageNo=1&numOfRows=10&dataType=XML&icao=RKSI&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

icao

ICAO 코드

국내공항의 ICAO 코드 RKSI 인천공항 RKSS 김포공항 RKPC 제주공항 RKPK 김해공항 RKNY 양양공항 RKNW원주공항 RKTU 청주공항 RKTN 대구공항 RKTH 포항공항 RKJJ 광주공항 RKJB 무안공항 RKJY 여수공항 RKPU 울산공항 RKPS 사천공항 RKJK 군산공항

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

msgText

METAR/SPECI 전문

om:phenomenonTime

관측시간

om:featureOfInterest

발표공항

sams:shape

공항위치

iwxxm:airTemperature

기온

iwxxm:dewpointTemperature

이슬점 온도

iwxxm:qnh

기압

iwxxm:meanWindDirection

풍향

iwxxm:meanWindSpeed

풍속

iwxxm:windGustSpeed

최고풍속

iwxxm:extremeClockwiseWindDirection

풍향변동폭

iwxxm:extremeCounterClockwiseWindDirection

풍향변동폭

iwxxm:AerodromeHorizontal Visibility

시정

iwxxm:AerodromeObserved Clouds

구름

iwxxm:AerodromeObserved Clouds

구름

iwxxm:AerodromeObserved Clouds

구름

iwxxm:presentWeather

현재일기

2. 기상청 METAR 해독자료

호출URL정보

기상청 METAR

https://apihub.kma.go.kr/api/typ01/url/air_metar_dec.php?tm=202211301200&org=K&help=1&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

년월일시분(UTC)

조회시각 (없으면 현재시각)

org

기관

K (기상청:default)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

3. 항공 지상기상연보 조회

호출URL정보

항공기상관측지점일람표조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getrAirStnLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지점번호

stn_ko

지역명(국문)

stn_en

지역명(영문)

lat

북위

lon

동경

ht_pa

기압계의 해발높이

ht_ta

온도계의 높이

ht_wd

풍속계의 지상높이

ht_rn

우량계의 지상높이

호출URL정보

요소별항공관측지점정보조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getAirStnInfo?pageNo=1&numOfRows=10&dataType=XML&year=2017&station=128&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

station

지점번호

지점번호

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stnId

지점번호

stnKo

관측지점

str

해당 데이터 컬럼

va_mon_{month}

해당 월

호출URL정보

요소별항공관측지점정보(2)조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getAirStnInfo2?pageNo=1&numOfRows=10&dataType=XML&year=2017&station=128&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

station

지점번호

지점번호

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Inx(1~17까지)

인덱스

Inx(18~22)

인덱스

Inx(23~27)

인덱스

Inx(28~34)

인덱스

Inx(35~40)

인덱스

Inx(41~45)

인덱스

inx(46~50)

인덱스

Inx(51~55)

인덱스

Inx(56~60)

인덱스

Inx(61~65)

인덱스

Inx(66~71)

인덱스

Inx(72~77)

인덱스

호출URL정보

요소별항공관측지점정보(3)조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getAirStnInfo3?pageNo=1&numOfRows=10&dataType=XML&year=2016&station=128&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년

2016년 발표

station

지점번호

지점번호

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

Inx

인덱스

Inx(1~11)

인덱스

Inx(12~14)

인덱스

Inx(15~17)

인덱스

Inx(18~20)

인덱스

Inx(21~23)

인덱스

Inx(24~26)

인덱스

Inx(27~29)

인덱스

Inx(30~32)

인덱스

Inx(33~35)

인덱스

Inx(36~38)

인덱스

va_mon_{해당월}

va_ann

호출URL정보

지상관측지점일람표조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getSfcStnLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지점번호

stn_ko

지역명(국문)

stn_en

지역명(영문)

lat

북위

lon

동경

ht

노장의 해발높이

ht_pa

기압계의 해발높이

ht_ta

온도계의 높이

ht_wd

풍속계의 지상높이

ht_rn

우량계의 지상높이

호출URL정보

일러두기조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcYearlyInfoService/getNote?pageNo=1&numOfRows=10&dataType=XML&year=2016&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

getNote

일러두기

4. 항공 지상기상월보 조회

호출URL정보

일별항공기상자료조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcMtlyInfoService/getDailyAirData?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=92&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

year

발표년도

2016년 발표

month

발표월

09월 발표

station

지역번호

92번 지역

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

dd

날짜

ta_max

최고기온

ta_min

최저기온

ws_max

최대풍속

wd_max

최대풍향

ws_ins

최대순간풍속

wd_ins

최대순간풍향

sd_max

최심적설

vs_min

최단시정

avg_ps

평균해면기압

avg_ta

평균기온

avg_td

평균이슬점온도

avg_hm

평균상대습도

min_hm

최소상대습도

avg_ws

평균풍속

avg_ca_tot

평균운량

sum_rn

강수량

ca1

최저운고 운량

ct1

최저운고 운형

ch1

최저운고 고도

호출URL정보

항공기상관측지점일람표조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcMtlyInfoService/getrAirStnLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지점번호

stn_ko

지역명(국문)

stn_en

지역명(영문)

lat

북위

lon

동경

ht_pa

기압계의 해발높이

ht_ta

온도계의 높이

ht_wd

퐁속계의 지상높이

ht_rn

우량계의 지상높이

호출URL정보

항공기상관측일러두기조회

https://apihub.kma.go.kr/api/typ02/openApi/SfcMtlyInfoService/getAirNote?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

note

일러두기

5. 항공통계자료 조회

호출URL정보

https://apihub.kma.go.kr/api/typ01/url/kma_air_tm.php?tm1=202211301200&tm2=202212011200&stn=&help=1&authKey=XZ15B2mZRGqdeQdpmURqUg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

기간: 시작시간 또는 시작일 (없으면 현재시간)

tm2

년월일시분(KST)

기간: 종료시간 또는 종료일 (없으면 현재시간)

stn

지점번호

해당 지점들(:로 구분)의 정보 표출 (0 이거나 없으면 전체지점)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

TM

관측시각 (KST)

STN

국내 지점번호

WD

풍향 (16방위)

WS

풍속 (knots)

GST

돌풍속 (knots)

VS

시정 (m)

RVR1

1방향 활주로 시정 (m)

RVR2

2방향 활주로 시정 (m)

WC

현재일기 (Code 4677)

CA

전운량 (1/8)

CA1

1층 운량 (1/8)

CT1

1층 운형

CH1

1층 운고 (ft)

CA2

2층 운량 (1/8)

CT2

2층 운형

CH2

2층 운고 (ft)

CA3

3층 운량 (1/8)

CT3

3층 운형

CH3

3층 운고 (ft)

CA4

4층 운량 (1/8)

CT4

4층 운형

CH4

4층 운고 (ft)

TA

기온 (C)

TD

이슬점온도 (C)

HM

상대습도 (%)

PA

현지기압 (hPa)

PS

해면기압 (hPa)

RN

강수량 (mm)