기상청 단기예보 조회서비스 Open API 활용가이드 목 차 TOC \o "1-4" \h \z \u 1. 서비스 명세 PAGEREF _Toc74944757 \h 31.1 단기예보 조회서비스 PAGEREF _Toc74944758 \h 3가. API 서비스 개요 PAGEREF _Toc74944759 \h 3나. 상세기능 목록 PAGEREF _Toc74944760 \h 4다. 상세기능내역 PAGEREF _Toc74944761 \h 41) [초단기실황조회] 상세기능명세 PAGEREF _Toc74944762 \h 42) [초단기예보조회] 상세기능명세 PAGEREF _Toc74944763 \h 73) [단기예보조회] 상세기능명세 PAGEREF _Toc74944764 \h 104) [예보버전조회] 상세기능명세 PAGEREF _Toc74944765 \h 132. 참고자료 PAGEREF _Toc74944766 \h 161. 서비스 명세1.1 단기예보 조회서비스가. API 서비스 개요API 서비스 정보API명(영문)VilageFcstInfoService_2.0API명(국문)단기예보 조회서비스(2.0)API 설명초단기실황, 초단기예보, 단기예보, 예보버전 정보를 조회하는 서비스입니다. 초단기실황정보는 예보 구역에 대한 대표 AWS 관측값을, 초단기예보는 예보시점부터 6시간 이내의 예보를, 단기예보는 예보기간과 구역을 시공간적으로 세분화한 예보를 제공합니다.API 서비스보안적용기술 수준서비스 인증/권한[O] ServiceKey [ ] 인증서 (GPKI/NPKI)[ ] Basic (ID/PW) [ ] 없음메시지 레벨암호화[ ] 전자서명 [ ] 암호화 [O] 없음전송 레벨 암호화[ ] SSL [O] 없음인터페이스 표준[ ] SOAP 1.2(RPC-Encoded, Document Literal, Document Literal Wrapped)[O] REST (GET)[ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타교환 데이터 표준(중복선택가능)[O] XML [O] JSON [ ] MIME [ ] MTOMAPI 서비스배포정보서비스 URLhttp://apis.data.go.kr/1360000/VilageFcstInfoService_2.0서비스 명세 URL(WSDL 또는 WADL)N/A서비스 버전1.0서비스 시작일2021-07-01서비스 배포일2021-07-01서비스 이력2021-07-01 : 서비스 시작메시지 교환유형[O] Request-Response [ ] Publish-Subscribe[ ] Fire-and-Forgot [ ] Notification데이터 갱신주기수시 (일 8회)나. 상세기능 목록번호API명(국문)상세기능명(영문)상세기능명(국문)1단기예보 조회서비스getUltraSrtNcst초단기실황조회2getUltraSrtFcst초단기예보조회3getVilageFcst단기예보조회4getFcstVersion예보버전조회다. 상세기능내역1) [초단기실황조회] 상세기능명세a) 상세기능정보상세기능 번호1상세기능 유형조회 (목록)상세기능명(국문)초단기실황조회상세기능 설명실황정보를 조회하기 위해 발표일자, 발표시각, 예보지점 X 좌표, 예보지점 Y 좌표의 조회 조건으로 자료구분코드, 실황값, 발표일자, 발표시각, 예보지점 X 좌표, 예보지점 Y 좌표의 정보를 조회하는 기능Call Back URLhttp://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getUltraSrtNcst최대 메시지 사이즈[1764] byte평균 응답 시간[100] ms초당 최대 트랙잭션[30] tpsb) 요청 메시지 명세항목명(영문)항목명(국문)항목크기항목구분샘플데이터항목설명serviceKey인증키1001인증키(URL Encode)공공데이터포털에서 발급받은 인증키numOfRows한 페이지 결과 수4110한 페이지 결과 수Default: 10pageNo페이지 번호411페이지 번호Default: 1dataType응답자료형식40XML요청자료형식(XML/JSON)Default: XMLbase_date발표일자8120210628‘21년 6월 28일 발표base_time발표시각41060006시 발표(정시단위)-매시각 10분 이후 호출nx예보지점 X 좌표2155예보지점의 X 좌표값*별첨 엑셀 자료 참조ny예보지점 Y 좌표21127예보지점의 Y 좌표값*별첨 엑셀 자료 참조※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)c) 응답 메시지 명세항목명(영문)항목명(국문)항목크기항목구분샘플데이터항목설명numOfRows한 페이지 결과 수411한 페이지당 표출데이터 수pageNo페이지 번호411페이지 수totalCount데이터 총 개수1011데이터 총 개수resultCode응답메시지 코드2100응답 메시지코드resultMsg응답메시지 내용1001NORMAL SERVICE응답 메시지 설명dataType데이터 타입41XML응답자료형식 (XML/JSON)baseDate발표일자8120210628‘21년 6월 28일 발표baseTime발표시각61060006시 발표(매 정시)nx예보지점 X 좌표2155입력한 예보지점 X 좌표ny예보지점 Y 좌표21127입력한 예보지점 Y 좌표category자료구분코드31RN1자료구분코드 * 하단 코드값 정보 참조obsrValue실황 값210RN1, T1H, UUU, VVV, WSD 실수 또는 정수로 제공* 하단 코드값 정보 참조※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n), 코드표별첨d) 요청/응답 메시지 예제요청메시지http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getUltraSrtNcst?serviceKey=인증키&numOfRows=10&pageNo=1&base_date=20210628&base_time=0600&nx=55&ny=127응답메시지<?xml version="1.0" encoding="UTF-8"?><response> <header> <resultCode>0</resultCode> <resultMsg>NORMAL_SERVICE</resultMsg> </header> <body> <dataType>XML</dataType> <items> <item> <baseDate>20210628</baseDate> <baseTime>0600</baseTime> <category>RN1</category> <nx>55</nx> <ny>127</ny> <obsrValue>1.1</obsrValue> </item> </items> <numOfRows>10</numOfRows> <pageNo>1</pageNo> <totalCount>8</totalCount> </body></response>2) [초단기예보조회] 상세기능명세a) 상세기능정보상세기능 번호2상세기능 유형조회 (상세)상세기능명(국문)초단기예보조회상세기능 설명초단기예보정보를 조회하기 위해 발표일자, 발표시각, 예보지점 X 좌표, 예보지점 Y 좌표의 조회 조건으로 자료구분코드, 예보값, 발표일자, 발표시각, 예보지점 X 좌표, 예보지점 Y 좌표의 정보를 조회하는 기능Call Back URLhttp://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getUltraSrtFcst최대 메시지 사이즈[2686] byte평균 응답 시간[100] ms초당 최대 트랙잭션[30] tpsb) 요청 메시지 명세항목명(영문)항목명(국문)항목크기항목구분샘플데이터항목설명serviceKey인증키1001인증키(URL Encode)공공데이터포털에서 발급받은 인증키numOfRows한 페이지 결과 수4110한 페이지 결과 수Default: 10pageNo페이지 번호411페이지 번호Default: 1dataType응답자료형식40XML요청자료형식(XML/JSON)Default: XMLbase_date발표일자(필수)8120210628‘21년 6월 28일 발표(필수)base_time발표시각(필수)41063006시30분 발표(30분 단위) (필수)- 매시각 45분 이후 호출nx예보지점 X 좌표(필수)2155예보지점 X 좌표값(필수)*별첨 엑셀 자료 참조ny예보지점 Y 좌표(필수)21127예보지점 Y 좌표값(필수)*별첨 엑셀 자료 참조※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)c) 응답 메시지 명세항목명(영문)항목명(국문)항목크기항목구분샘플데이터항목설명numOfRows한 페이지 결과 수411한 페이지당 표출데이터 수pageNo페이지 번호411페이지 수totalCount데이터 총 개수1011데이터 총 개수resultCode응답메시지 코드2100응답 메시지코드resultMsg응답메시지 내용1001NORMAL SERVICE응답 메시지 설명dataType데이터 타입41XML응답자료형식 (XML/JSON)baseDate발표일자8120210628‘21년 6월 28일 발표baseTime발표시각41120012시00분 발표nx예보지점 X 좌표2155입력한 예보지점 X 좌표ny예보지점 Y 좌표21127입력한 예보지점 Y 좌표category자료구분코드31LGT자료구분코드 * 하단 참고자료 참조fcstDate예측일자8120210628예측일자(YYYYMMDD)fcstTime예측시간411200예측시간(HH24MI)fcstValue예보 값210예보 값- Category(자료구분)에 대한 예측값* 하단 참고자료 참조※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n), 코드표별첨d) 요청/응답 메시지 예제요청메시지http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getUltraSrtFcst?serviceKey=인증키&numOfRows=10&pageNo=1&base_date=20210628&base_time=0630&nx=55&ny=127응답메시지<?xml version="1.0" encoding="UTF-8"?><response> <header> <resultCode>0</resultCode> <resultMsg>NORMAL_SERVICE</resultMsg> </header> <body> <dataType>XML</dataType> <items> <item> <baseDate>20210628</baseDate> <baseTime>0630</baseTime> <category>LGT</category> <fcstDate>20210628</fcstDate> <fcstTime>1200</fcstTime> <fcstValue>0</fcstValue> <nx>55</nx> <ny>127</ny> </item> </items> <numOfRows>10</numOfRows> <pageNo>1</pageNo> <totalCount>60</totalCount> </body></response>3) [단기예보조회] 상세기능명세a) 상세기능정보상세기능 번호3상세기능 유형조회 (상세)상세기능명(국문)단기예보조회상세기능 설명단기예보 정보를 조회하기 위해 발표일자, 발표시각, 예보지점 X좌표, 예보지점 Y 좌표의 조회 조건으로 발표일자, 발표시각, 자료구분문자, 예보 값, 예보일자, 예보시각, 예보지점 X 좌표, 예보지점 Y 좌표의 정보를 조회하는 기능Call Back URLhttp://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getVilageFcst최대 메시지 사이즈[48,452] byte평균 응답 시간[600] ms초당 최대 트랙잭션[30] tpsb) 요청 메시지 명세항목명(영문)항목명(국문)항목크기항목구분샘플데이터항목설명serviceKey인증키1001인증키(URL Encode)공공데이터포털에서 발급받은 인증키numOfRows한 페이지 결과 수4150한 페이지 결과 수Default: 10pageNo페이지 번호411페이지 번호Default: 1dataType응답자료형식40XML요청자료형식(XML/JSON)Default: XMLbase_date발표일자8120210628‘21년 6월 28일발표base_time발표시각41050005시 발표* 하단 참고자료 참조nx예보지점 X 좌표2155예보지점의 X 좌표값*별첨 엑셀 자료 참조ny예보지점 Y 좌표21127예보지점의 Y 좌표값*별첨 엑셀 자료 참조※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)c) 응답 메시지 명세항목명(영문)항목명(국문)항목크기항목구분샘플데이터항목설명numOfRows한 페이지 결과 수4150한 페이지당 표출데이터 수pageNo페이지 번호411페이지 수totalCount데이터 총 개수1011데이터 총 개수resultCode응답메시지 코드2100응답 메시지코드resultMsg응답메시지 내용1001NORMAL SERVICE응답 메시지 설명dataType데이터 타입41XML응답자료형식 (XML/JSON)baseDate발표일자8120210628‘21년 6월 28일 발표baseTime발표시각61050005시 발표fcstDate예보일자8120210628‘21년 6월 28일 예보fcstTime예보시각4106006시 예보category자료구분문자31TMP자료구분코드 * 하단 코드값 정보 참조fcstValue예보 값2121* 하단 코드값 정보 참조* TMP, TMN, TMX, UUU, VVV, WAV, WSD자료는 실수 또는 정수로 제공nx예보지점 X 좌표2155입력한 예보지점 X 좌표ny예보지점 Y 좌표21127입력한 예보지점 Y 좌표※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n), 코드표별첨※ 단기예보 5일 연장으로 02·05·08·11·14시 발표기준 글피 예보, 17·20·23시 발표기준 그글피 예보제공 - 연장기간인 (02·05·08·11·14시 발표)글피, (17·20·23시 발표)그글피 예보는 3시간 간격의 자료를 제공하며, 강수량(PCP), 강설(SNO), 풍속(WSD) 요소는 정성정보(코드값)를 제공(코드표 참고)d) 요청/응답 메시지 예제요청메시지http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getVilageFcst?serviceKey=인증키&numOfRows=10&pageNo=1&base_date=20210628&base_time=0500&nx=55&ny=127응답메시지<?xml version="1.0" encoding="UTF-8"?><response> <header> <resultCode>0</resultCode> <resultMsg>NORMAL_SERVICE</resultMsg> </header> <body> <dataType>XML</dataType> <items> <item> <baseDate>20210628</baseDate> <baseTime>0500</baseTime> <category>TMP</category> <fcstDate>20210628</fcstDate> <fcstTime>0600</fcstTime> <fcstValue>21</fcstValue> <nx>55</nx> <ny>127</ny> </item> </items> <numOfRows>10</numOfRows> <pageNo>1</pageNo> <totalCount>742</totalCount> </body></response>4) [예보버전조회] 상세기능명세a) 상세기능정보상세기능 번호4상세기능 유형조회 (목록)상세기능명(국문)예보버전조회상세기능 설명단기예보정보조회서비스 각각의 오퍼레이션(초단기실황, 초단기예보, 단기예보)들의 수정된 예보 버전을 파악하기 위해 예보버전을 조회하는 기능Call Back URLhttp://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getFcstVersion최대 메시지 사이즈[353] byte평균 응답 시간[100] ms초당 최대 트랙잭션[30] tpsb) 요청 메시지 명세항목명(영문)항목명(국문)항목크기항목구분샘플데이터항목설명serviceKey인증키1001인증키(URL Encode)공공데이터포털에서 발급받은 인증키numOfRows한 페이지 결과 수4110한 페이지 결과 수Default: 10pageNo페이지 번호411페이지 번호Default: 1dataType응답자료형식40XML요청자료형식(XML/JSON)Default: XMLftype파일구분51ODAM파일구분-ODAM: 초단기실황-VSRT: 초단기예보-SHRT: 단기예보basedatetime발표일시분101202106290800각각의 base_time 로 검색참고자료 참조※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)c) 응답 메시지 명세항목명(영문)항목명(국문)항목크기항목구분샘플데이터항목설명numOfRows한 페이지 결과 수411한 페이지당 표출데이터 수pageNo페이지 번호411페이지 수totalCount데이터 총 개수1011데이터 총 개수resultCode응답메시지 코드2100응답 메시지코드resultMsg응답메시지 내용1001NORMAL SERVICE응답 메시지 설명dataType데이터 타입41XML응답자료형식 (XML/JSON)version파일버전4120210628092217파일버전 정보- 파일 생성 시간filetype파일구분51ODAM파일구분-ODAM: 초단기실황-VSRT: 초단기예보-SHRT: 단기예보※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n), 코드표별첨d) 요청/응답 메시지 예제요청메시지http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getFcstVersion?serviceKey=인증키&numOfRows=10&pageNo=1&ftype=ODAM&basedatetime=202106280800응답메시지<?xml version="1.0" encoding="UTF-8"?><response> <header> <resultCode>0</resultCode> <resultMsg>NORMAL_SERVICE</resultMsg> </header> <body> <dataType>XML</dataType> <items> <item> <filetype>ODAM</filetype> <version>20210628092217</version> </item> </items> <numOfRows>10</numOfRows> <pageNo>1</pageNo> <totalCount>1</totalCount> </body></response>2. 참고자료# 단기예보 연장에 따른 코드값 정보(2024.11.28. 14시~)예보 요소정성정보 코드값정성정보용어정성정보 의미강수량(PCP)1약한 비시간당 3mm 미만의 약한 비2보통 비시간당 3mm 이상 15mm 미만의 보통 비3강한 비시간당 15mm 이상의 강한 비눈의양(SNO)1보통 눈시간당 1cm 미만의 보통 눈2많은 눈시간당 1cm 이상의 많은 눈풍 속(WSD)1약한 바람4m/s 이상의 약한 바람2약간 강한 바람4m/s 이상 9m/s 미만의 약간 강한 바람3강한 바람9m/s 이상의 강한 바람# 코드값 정보예보구분항목값항목명단위압축bit수단기예보POP강수확률%8PTY강수형태코드값4PCP1시간 강수량범주 (1 mm)8REH습도%8SNO1시간 신적설범주(1 cm)8SKY하늘상태코드값4TMP1시간 기온℃10TMN일 최저기온℃10TMX일 최고기온℃10UUU풍속(동서성분)m/s12VVV풍속(남북성분)m/s12WAV파고M8VEC풍향deg10WSD풍속m/s10초단기실황T1H기온℃10RN11시간 강수량mm8UUU동서바람성분m/s12VVV남북바람성분m/s12REH습도%8PTY강수형태코드값4VEC풍향deg10WSD풍속m/s10초단기예보T1H기온℃10RN11시간 강수량범주 (1 mm)8SKY하늘상태코드값4UUU동서바람성분m/s12VVV남북바람성분m/s12REH습도%8PTY강수형태코드값4LGT낙뢰kA(킬로암페어)4VEC풍향deg10WSD풍속m/s10◼ +900이상, –900 이하 값은 Missing 값으로 처리관측장비가 없는 해양 지역이거나 관측장비의 결측 등으로 자료가 없음을 의미◼ 압축 Bit 수의 경우 Missing 값이 아닌 경우의 기준# 특정 요소의 코드값 및 범주- 하늘상태(SKY) 코드 : 맑음(1), 구름많음(3), 흐림(4)- 강수형태(PTY) 코드 : (초단기) 없음(0), 비(1), 비/눈(2), 눈(3), 빗방울(5), 빗방울눈날림(6), 눈날림(7) (단기) 없음(0), 비(1), 비/눈(2), 눈(3), 소나기(4) - 초단기예보, 단기예보 강수량(RN1, PCP) 범주 및 표시방법(값)범주문자열표시0.1 ~ 1.0mm 미만1mm 미만1.0mm 이상 30.0mm 미만실수값+mm(1.0mm~29.9mm)30.0 mm 이상 50.0 mm 미만30.0~50.0mm50.0 mm 이상50.0mm 이상※ -, null, 0값은 ‘강수없음’예) PCP = 6.2 일 경우 강수량은 6.2mm PCP = 30 일 경우 강수량은 30.0~50.0mmJAVAif(f < 1.0f) return "1mm 미만";else if(f >= 1.0f && f < 30.0f) return "1.0~29.0mm";else if(f >= 30.0f && f < 50.0f) return "30.0~50.0mm";else return "50.0mm이상";- 신적설(SNO) 범주 및 표시방법(값)범주문자열표시0.1 ~ 0.5cm 미만0.5cm 미만0.5cm 이상 5.0cm 미만실수값+cm(0.5cm~4.9cm)5.0 cm 이상5.0cm 이상※ -, null, 0값은 ‘적설없음’- 낙뢰코드(LGT) 정보낙뢰(초단기예보) : 에너지밀도(0.2~100kA(킬로암페어)/㎢)- 풍속 정보동서바람성분(UUU) : 동(+표기), 서(-표기)남북바람성분(VVV) : 북(+표기), 남(-표기)❍ 단기예보조회 해상 마스킹 처리- 해상에는 기온군, 강수확률, 강수량/적설, 습도를 제공하지 않음(Missing값으로 마스킹처리 함)# 예보 발표시각❍ 단기예보 발표시각- Base_time : 0200, 0500, 0800, 1100, 1400, 1700, 2000, 2300 (1일 8회)- API 제공 시간(~이후) : 02:10, 05:10, 08:10, 11:10, 14:10, 17:10, 20:10, 23:10※ [단기예보 발표시간 별 예보시각]발표시각(KST)예보기간+1일+2일+3일+4일+5일02·05·08·11·14시1시간 간격 정량값 및 정성정보3시간 간격-17·20·23시 1시간 간격 정량값 및 정성정보3시간 간격❍ 초단기실황 발표시각 ※ 매시간 정시에 생성되고 10분마다 최신 정보로 업데이트기준 시간생성시간Base_timeAPI 제공 시간(~이후)기준 시간생성시간Base_timeAPI 제공 시간(~이후)00 시00:00000000:1012 시12:00120012:1001 시01:00010001:1013 시13:00130013:1002 시02:00020002:1014 시14:00140014:1003 시03:00030003:1015 시15:00150015:1004 시04:00040004:1016 시16:00160016:1005 시05:00050005:1017 시17:00170017:1006 시06:00060006:1018 시18:00180018:1007 시07:00070007:1019 시19:00190019:1008 시08:00080008:1020 시20:00200020:1009 시09:00090009:1021 시21:00210021:1010 시10:00100010:1022 시22:00220022:1011 시11:00110011:1023 시23:00230023:10❍초단기예보 발표시각※ 매시간 30분에 생성되고 10분마다 최신 정보로 업데이트(기온, 습도, 바람)기준 시간생성시각Base_timeAPI 제공 시간(~이후)예보시간 (매 발표시각마다 6시간 예보)h시~h+1시h+1시~h+2시h+2시~h+3시h+3시~h+4시h+4시~h+5시h+5시~h+6시00 시00:30003000:450~1시1~2시2~3시3~4시4~5시5~6시01 시01:30013001:451~2시2~3시3~4시4~5시5~6시6~7시02 시02:30023002:452~3시3~4시4~5시5~6시6~7시7~9시03 시03:30033003:453~4시4~5시5~6시6~7시7~8시8~9시04 시04:30043004:454~5시5~6시6~7시7~8시8~9시9~10시05 시05:30053005:455~6시6~7시7~8시8~9시9~10시10~11시06 시06:30063006:456~7시7~8시8~9시9~10시10~11시11~12시07 시07:30073007:457~8시8~9시9~10시10~11시11~12시12~13시08 시08:30083008:458~9시9~10시10~11시11~12시12~13시13~14시09 시09:30093009:459~10시10~11시11~12시12~13시13~14시14~15시10 시10:30103010:4510~11시11~12시12~13시13~14시14~15시15~16시11 시11:30113011:4511~12시12~13시13~14시14~15시15~16시~16~17시12 시12:30123012:4512~13시13~14시14~15시15~16시16~17시17~18시13 시13:30133013:4513~14시14~15시15~16시16~17시17~18시18~19시14 시14:30143014:4514~15시15~16시16~17시17~18시18~19시19~20시15 시15:30153015:4515~16시16~17시17~18시18~19시19~20시20~21시16 시16:30163016:4516~17시17~18시18~19시19~20시20~21시21~22시17 시17:30173017:4517~18시18~19시19~20시20~21시21~22시22~23시18 시18:30183018:4518~19시19~20시20~21시21~22시22~23시23~24시19 시19:301903019:4519~20시20~21시21~22시22~23시23~24시24~1시20 시20:30203020:4520~21시21~22시22~23시23~24시22~23시1~2시21 시21:30213021:4521~22시22~23시23~24시0~1시1~2시2~3시22 시22:30223022:4522~23시23~24시0~1시1~2시2~3시3~4시23 시23:30233023:4523~24시0~1시1~2시2~3시3~4시4~5시❍ 최고/최저기온의 발표시간별 저장되는 예보자료 시간발표시각(KST)최저기온최고기온오늘내일모레글피그글피오늘내일모레글피그글피2○○○○○○○○5○○○○○○○8○○○○○○○11○○○○○○○14○○○○○○17○○○○○○○○20○○○○○○○○23○○○○○○○○# 예보요소 규칙○ 하늘상태 : 상태변화 없음- 하늘상태 단위하늘상태전운량맑음0 ～ 5구름많음6 ～ 8흐림9 ～ 10○ 풍향- 풍향 구간별 표현단위풍향 구간(°)표현 단위풍향 구간(°)표현 단위0 – 45N-NE180 – 225S-SW45 – 90NE-E225 – 270SW-W90 – 135E-SE270 – 315W-NW135 – 180SE-S315 – 360NW-N○ 풍속- 기상청 통보문의 육상예보에 사용하는 바람강도 용어# 풍향값에 따른 16방위 변환식(풍향값 + 22.5 * 0.5) / 22.5) = 변환값(소수점 이하 버림)변환값16방위0N1NNE2NE3ENE4E5ESE6SE7SSE8S9SSW10SW11WSW12W13WNW14NW15NNW16N예)풍향값 : 339변환값 : (339 + 22.5 * 0.5 ) / 22.5 = 15.5666... => 1516방위 : NNW풍향값 : 165변환값 : (165 + 22.5 * 0.5 ) / 22.5 = 7.8333... => 716방위 : SSE# 단기예보 지점 좌표(X,Y)위치와 위경도 간의 전환 C 프로그램 예제** 아래 프로그램은 위경도 값을 직접 좌표 값으로 변환하여 사용하기 원하는 사용자를 위한 예제입니다. ** 행정구역별 지점 좌표(X,Y) 값은 별첨 엑셀 파일에 작성되어 제공 중입니다. ** 단기예보서비스는 남한에 대해서만 제공되며, 북한 및 국외는 제공되지 않습니다.** 아래의 컴파일 방법은 예시이며, 사용하는 컴파일러나 툴 등에 맞춰 컴파일하면 됩니다.○ 컴파일 방법 예시# cc 소스파일명 -lm○ 실행 방법 예시# 실행파일명 1 <X-grid> <Y-grid>예) # a.out 1 59 125출력결과)X = 59, Y = 125 --->lon.= 126.929810, lat.= 37.488201# 실행파일명 0 <경도> <위도>예) # a.out 0 126.929810 37.488201출력결과)lon.= 126.929810, lat.= 37.488201 ---> X = 59, Y = 125○ 소스파일/********************************************************************************/#include <stdio.h>#include <stdlib.h>#include <string.h>#include <signal.h>#include <sys/types.h>#include <sys/stat.h>#include <dirent.h>#include <time.h>#include <math.h>#define NX 149 /* X축 격자점 수 */#define NY 253 /* Y축 격자점 수 */struct lamc_parameter {float Re; /* 사용할 지구반경 [ km ] */float grid; /* 격자간격 [ km ] */float slat1; /* 표준위도 [degree] */float slat2; /* 표준위도 [degree] */float olon; /* 기준점의 경도 [degree] */float olat; /* 기준점의 위도 [degree] */float xo; /* 기준점의 X좌표 [격자거리] */float yo; /* 기준점의 Y좌표 [격자거리] */int first; /* 시작여부 (0 = 시작) */};/******************************************************************************** MAIN*******************************************************************************/int main (int argc, char *argv[]) {float lon, lat, x, y;struct lamc_parameter map;//// 인수 확인//if (argc != 4) {printf("[Usage] %s 1 <X-grid><Y-grid>\n", argv[0]);printf(" %s 0 <longitude><latitude>\n", argv[0]);exit(0);}if (atoi(argv[1]) == 1) {x = atof(argv[2]);y = atof(argv[3]);if (x < 1 || x > NX || y < 1 || y > NY) {printf("X-grid range [1,%d] / Y-grid range [1,%d]\n", NX, NY);exit(0);}} else if (atoi(argv[1]) == 0) {lon = atof(argv[2]);lat = atof(argv[3]);}//// 단기예보 지도 정보//map.Re = 6371.00877; // 지도반경map.grid = 5.0; // 격자간격 (km)map.slat1 = 30.0; // 표준위도 1map.slat2 = 60.0; // 표준위도 2map.olon = 126.0; // 기준점 경도map.olat = 38.0; // 기준점 위도map.xo = 210/map.grid; // 기준점 X좌표map.yo = 675/map.grid; // 기준점 Y좌표map.first = 0;//// 단기예보//map_conv(&lon, &lat, &x, &y, atoi(argv[1]), map);if (atoi(argv[1]))printf("X = %d, Y = %d --->lon.= %f, lat.= %f\n", (int)x, (int)y, lon, lat);elseprintf("lon.= %f, lat.= %f ---> X = %d, Y = %d\n", lon, lat, (int)x, (int)y);return 0;}/*============================================================================** 좌표변환*============================================================================*/int map_conv(float *lon, // 경도(degree)float *lat, // 위도(degree)float *x, // X격자 (grid)float *y, // Y격자 (grid)int code, // 0 (격자->위경도), 1 (위경도->격자)struct lamc_parameter map // 지도정보) {float lon1, lat1, x1, y1;//// 위경도 -> (X,Y)//if (code == 0) {lon1 = *lon;lat1 = *lat;lamcproj(&lon1, &lat1, &x1, &y1, 0, &map);*x = (int)(x1 + 1.5);*y = (int)(y1 + 1.5);}//// (X,Y) -> 위경도//if (code == 1) {x1 = *x - 1;y1 = *y - 1;lamcproj(&lon1, &lat1, &x1, &y1, 1, &map);*lon = lon1;*lat = lat1;}return 0;}/***************************************************************************** [ Lambert Conformal Conic Projection ]** olon, lat : (longitude,latitude) at earth [degree]* o x, y : (x,y) cordinate in map [grid]* o code = 0 : (lon,lat) --> (x,y)* 1 : (x,y) --> (lon,lat)****************************************************************************/int lamcproj(lon, lat, x, y, code, map)float *lon, *lat; /* Longitude, Latitude [degree] */float *x, *y; /* Coordinate in Map [grid] */int code; /* (0) lon,lat ->x,y (1) x,y ->lon,lat */struct lamc_parameter *map;{static double PI, DEGRAD, RADDEG;static double re, olon, olat, sn, sf, ro;double slat1, slat2, alon, alat, xn, yn, ra, theta;if ((*map).first == 0) {PI = asin(1.0)*2.0;DEGRAD = PI/180.0;RADDEG = 180.0/PI;re = (*map).Re/(*map).grid;slat1 = (*map).slat1 * DEGRAD;slat2 = (*map).slat2 * DEGRAD;olon = (*map).olon * DEGRAD;olat = (*map).olat * DEGRAD;sn = tan(PI*0.25 + slat2*0.5)/tan(PI*0.25 + slat1*0.5);sn = log(cos(slat1)/cos(slat2))/log(sn);sf = tan(PI*0.25 + slat1*0.5);sf = pow(sf,sn)*cos(slat1)/sn;ro = tan(PI*0.25 + olat*0.5);ro = re*sf/pow(ro,sn);(*map).first = 1;}if (code == 0) {ra = tan(PI*0.25+(*lat)*DEGRAD*0.5);ra = re*sf/pow(ra,sn);theta = (*lon)*DEGRAD - olon;if (theta > PI) theta -= 2.0*PI;if (theta < -PI) theta += 2.0*PI;theta *= sn;*x = (float)(ra*sin(theta)) + (*map).xo;*y = (float)(ro - ra*cos(theta)) + (*map).yo;} else {xn = *x - (*map).xo;yn = ro - *y + (*map).yo;ra = sqrt(xn*xn+yn*yn);if (sn< 0.0) -ra;alat = pow((re*sf/ra),(1.0/sn));alat = 2.0*atan(alat) - PI*0.5;if (fabs(xn) <= 0.0) {theta = 0.0;} else {if (fabs(yn) <= 0.0) {theta = PI*0.5;if(xn< 0.0 ) -theta;} elsetheta = atan2(xn,yn);}alon = theta/sn + olon;*lat = (float)(alat*RADDEG);*lon = (float)(alon*RADDEG);}return 0;}※ Open API 에러 코드 정리에러코드에러메세지설명00NORMAL_SERVICE정상01APPLICATION_ERROR어플리케이션 에러02DB_ERROR데이터베이스 에러03NODATA_ERROR데이터없음 에러04HTTP_ERRORHTTP 에러05SERVICETIME_OUT서비스 연결실패 에러10INVALID_REQUEST_PARAMETER_ERROR잘못된 요청 파라메터 에러11NO_MANDATORY_REQUEST_PARAMETERS_ERROR필수요청 파라메터가 없음12NO_OPENAPI_SERVICE_ERROR해당 오픈API서비스가 없거나 폐기됨20SERVICE_ACCESS_DENIED_ERROR서비스 접근거부21TEMPORARILY_DISABLE_THE_SERVICEKEY_ERROR일시적으로 사용할 수 없는 서비스 키22LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR서비스 요청제한횟수 초과에러30SERVICE_KEY_IS_NOT_REGISTERED_ERROR등록되지 않은 서비스키31DEADLINE_HAS_EXPIRED_ERROR기한만료된 서비스키32UNREGISTERED_IP_ERROR등록되지 않은 IP33UNSIGNED_CALL_ERROR서명되지 않은 호출99UNKNOWN_ERROR기타에러