목 차 version 예보별제공요소정의 1. 1 국내현재날씨 국내케이웨더예보 1시간단위 국내케이웨더예보 6시간단위 ----

Size: px

Start display at page:

Download "목 차 version 예보별제공요소정의 1. 1 국내현재날씨 국내케이웨더예보 1시간단위 국내케이웨더예보 6시간단위 ----"

재현 부
5 years ago
Views:

1 Version 1.0.0

2 목 차 version 예보별제공요소정의 1. 1 국내현재날씨 국내케이웨더예보 1시간단위 국내케이웨더예보 6시간단위 국내케이웨더예보 12시간단위 국내케이웨더예보일단위 국내생활지수 세계현재날씨 세계예보 1시간단위 세계예보일단위 세계기후정보 세계생활지수 날씨뉴스 날씨방송영상 날씨방송썸네일정보 현재위치검색 도시명검색 메소드호출리턴코드 아이콘정보 아이콘 아이콘 풍향정보 지역코드 ( 별첨)

3 1. 예보별제공요소정의 모든예보는메소드를통하여접근가능하며, 래의내용을참조하시면됩니다. 제공받은요소에대한정의는아 1. 1 국내현재날씨 구분설명표시형식표출형태 result 데이터검색성공/ 실 1 패 region_id 지역코드 5 자리의 숫자로구성 country_ko/e 국가 이름( 한글/ 영문) n state_ko/en 광역도 이름( 한글/ 영 문 ) dong_ko/en 동 이름( 한글/ 영문 locale 국내/ 해외 구분 kma/world lon 경도 lat 위도 tz time zone UTC:+9:0 date 관측시각정보 YYYYMMDDHH, dst local time(summer à 2011년12월26일13시미적용 NA, 적용시 -1 time) daynight 낮(D)/ 밤(N) 구분 국내는 NA, 해외는 D/N icon 날씨아이콘 1~40 temp 현재기온 ( 소수점 첫째자리) 소수점 첫째자리로 표출 max_temp 일 최고기온( 예보) ( 소수점 첫째자리) 정수로 표출 min_temp 일 최저기온( 에보) ( 소수점 첫째자리) 정수로 표출 sens_temp 체감온도 ( 소수점 첫째자리) 소수점 첫째자리로 wd_ws 풍향/ 풍속 36 방위, m/s( 소수점첫째자 리 ) humi 습도 % rainf 강수량 mm snowf 적설량 cm pa 해면기압 hpa( 소수점 첫째자리) badfeel 불쾌지수 0~100 표출 - 1 -

4 pm10 미세먼지농도 0~ -값이들어올경우 wtext 짧은개황 wf_today 오늘개황 wf_tomorrow 내일 개황 wf_week 주간 개황 sunrise 일출 hh:mm sunset 일몰 hh:mm moonrise 월출 hh:mm moonset 월몰 hh:mm violet 자외선 지수 소수젓 첨째자리 vs 가시거리 Meter(ex 1km > 1000) NA 처리 1. 2 국내케이웨더예보 1시간단위 1 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) announce_date 발표시각 date 적용 날짜 icon 날씨아이콘 1~12 icontext 하늘상태 맑음, 구름조금 temp 기온 ( 소수점 첫째자리) humi 습도 69 wd_ws 풍향: 풍속 2:04 rainp 강수확률 ( 소수점 첫째자리) rainf 강수량 cm 없으면 na snowf 강설량 cm 없으면 na 1. 3 국내케이웨더예보 6시간단위 1 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) - 2 -

5 announce_date 발표시각 quater 적용시간 1- 새벽(00~06), 2- 아침(06~12), 3-낮 (12~18), 4- 저녁(18~24) date 적용 날짜 icon 날씨아이콘 1~12 icontext 하늘상태 맑음, 구름조금 max_temp 최고기온 ( 소수점 첫째자리) min_temp 최저기온 ( 소수점 첫째자리) max_humi 최고습도 69 min_humi 최저습도 69 wd8l_wd8r_ws 풍향1: 풍향2: 풍속 2:00:04 풍향1,2 값이모두들어있다면풍향을 북- 북동 으로표현할수있다. rainp 강수확률 ( 소수점 첫째자리) rainf 강수량 cm 없으면 na snowf 강설량 cm 없으면 na 1. 4 국내케이웨더예보 12시간단위 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) announce_date 발표시각 ampm 적용 시간 1-am, 2-pm date 적용 날짜 icon 날씨아이콘 1~12 icontext 하늘상태 맑음, 구름조금 max_temp 최고기온 ( 소수점 첫째자리) min_temp 최저기온 ( 소수점 첫째자리) max_humi 최고습도 69 min_humi 최저습도 69 wd8l_wd8r_ws 풍향1: 풍향2: 풍속 2:00:04 풍향1,2 값이모두들어있다면풍향을 북- 북동 으로표현할수있다. rainp 강수확률 ( 소수점첫째자리) rainf 강수량 cm 없으면 na - 3 -

6 snowf 강설량 cm 없으면 na 1. 5 국내케이웨더예보일단위 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) announce_date 발표시각 ampm 적용 시간 1-am, 2-pm date 적용 날짜 icon 날씨아이콘 1~12 icontext 하늘상태 맑음, 구름조금 max_temp 최고기온 ( 소수점 첫째자리) min_temp 최저기온 ( 소수점 첫째자리) max_humi 최고습도 69 min_humi 최저습도 69 wd8l_wd8r_ws 풍향1: 풍향2: 풍속 2:00:04 풍향1,2 값이모두들어있다면풍향을 북- 북동 으로표현할수있다. rainp 강수확률 ( 소수점 첫째자리) rainf 강수량 cm 없으면 na snowf 강설량 cm 없으면 na 1. 6 국내생활지수 구분설명표시형 식 1 region_id 지역코드 5자리 숫자 date 업데이트시각 YYYYMMDDH 표출형태 H URL BI 링크 URL name 지수종류감기, 나들이, 불쾌, 운동, 자외선 - 4 -

7 level 지수 단계 0~100 text 지수 설명 평소 건강관리에 유의하 세요 지수단계 - 불쾌지수 ( 국내/ 해외동일) 매우좋음 (10~20) 좋음 (30~40) 보통 (50~60) 나쁨 (70~80) 매우나쁨 (80~100) 지수단계 - 그외지수 ( 국내/ 해외동일) 매우좋음 (90~100) 좋음 (70~80) 보통 (50~60) 나쁨 (30~40) 매우나쁨 (10~20) 1. 7 세계현재날씨 구분 설명 표시형식 표출형태 region_id 지역코드 5 자리의 숫자로구성 locale 국내/ 해외 구분 kma/world lon 경도 lat 위도 tz time zone UTC:+9:0 date 관측시각정보 YYYYMMDDHH, dst local time(summer 2613 => 2011년12월26일13시미적용 NA, 적용시 -1 time) daynight 낮(D)/ 밤(N) 구분 국내는 NA, 해외는 D/N icon 날씨아이콘 1~40 temp 현재기온 ( 소수점 첫째자리) 소수점 첫째자리 로표출 max_temp 일 최고기온( 예보) ( 소수점 첫째자리) 정수로 표출 min_temp 일 최저기온( 에보) ( 소수점 첫째자리) 정수로 표출 sens_temp 체감온도 ( 소수점 첫째자리) 소수점 첫째자리 wd_ws 풍향/ 풍속 16 방위, m/s( 소수점첫 째자리 ) humi 습도 % pa 해면기압 hpa( 소수점 첫째자리) 로표출 - 5 -

8 1. 8 세계예보 1시간단위 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) announce_date 발표시각 date 날짜 icon 아이콘 코드 1~40 hour 시각 03, 06, 09 temp 기온 ( 소수점 첫째자리) humi 습도 % wd:ws 풍향: 풍속 36 방위, m/s rainp 강수확률 % rainf 오전예상강수량: 오후예상강 cm(~ 의 경우앞에붙으면, 미만, 뒤에 snowf 수량( 국내) 누적강수량( 해외) 오전예상적설량: 오후예상적 설량누적강수량( 해외) 붙으면이상 ) cm(~ 가앞에붙을경우미만, 뒤에붙 을경우이상 ) 1. 9 세계예보일단위 표 출 형 태 region_id 지역코드 5 자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) date 날짜 dow 요일 1~7( 일~ 토) icon 날씨아이콘 1~40 max_temp 최고기온 ( 소수점 첫째자리) 정수 min_temp 최저기온 ( 소수점 첫째자리) 정수 - 6 -

9 1. 10 세계기후정보 Region_id 시티 코드 Region_ko/en 대륙 명( 한글/ 영문) 공항 month 적용 월 1, 2, 3, 12 Max_temp 월 평균최고기온 20.2 Min_temp 월 평균최저기온 3.8 rainf 월 평균강수량 mm, 16.7 raindays 월 평균강수일수 3 Climate 월 기후특징 텍스트 tourtip 월 옷차림정보 텍스트 세계생활지수 구분 설명 표시형식 표출형태 region_id 지역코드 5자리 숫자 date 업데이트시각 YYYYMMDDH H URL BI 링크 URL name 지수 코드 level 지수 단계 0~ text 지수 설명 평소 건강관리에유의하세 지수코드 01 나들이 02 운동 04 불쾌 05 냉방 06 빨래 07 세차 08 불조심 09 부패 10 감기 11 난방 요 날씨뉴스 구분 설명 표시형식 표출형태 region_id 지역코드 5자리 숫자 date 업데이트시각 YYYYMMDDH

10 H URL BI 링크 URL name 지수 코드 level 지수 단계 0~ text 지수 설명 평소 건강관리에유의하세 구 분 카테고리명 ( 날씨뉴스, 방송영상, 썸네일정보동일) lifestyle 라이프스타일 lifeinfo 날씨와생활정보 food 맛있는날씨 weatherplus 날씨플러스 요 1.13 날씨방송영상 구분설명표시형식 result 데이터검색성공/ listcnt 검색갯수 9 url 영상상위 URL http 포함한 URL vod 영상파일명 영상파일명 1.14 날씨방송썸네일정보 listcnt 검색갯수 9 url 썸네일상위 URL http 포함한 URL title 방송제목 contents 방송대본 img 썸네일파일명 1.15 현재위치검색 srch_cnt 검색 결과개수 region_id 지역코드 5자리의 숫자로구성 Dong_ko/en 동 이름( 한글/ 영문) lon 경도 lat 위도 - 8 -

11 distance 좌표와의거리입력좌표와 region 좌표와의직선거리( 단 위 : meter) 1.16 도시명검색정렬기준 : 오름차순[A->Z, ㄱ-> ㅎ], 최대20건표출 srch_cnt 검색 결과개수 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) 2. 메소드호출리턴코드 메소드를통한접근시처리상태에따른상태코드번호를리턴합니다. 코드 내용 1 정상호출 2 호출횟수초과 3 유효기간만료 4 API 키오류 - 9 -

12 3. 아이콘정보 아이콘 번호아이콘설명 1 맑음 2 구름조금 3 구름많음 4 흐림 5 흐리고비 6 흐리고눈 7 비온후갬 8 소나기 9 비또는눈 10 눈또는비 11 천둥번개 12 안개 아이콘 번호아이콘설명 1 맑음 2 구름조금 3 구름많음

13 4 흐림 5 흐린후차차갬 6 맑은후차차흐려짐 7 소나기 8 오전소나기 9 오후소나기 10 흐리고비 11 오전비 12 오후비 13 차차흐려져비 14 차차흐려져오후비 15 비온후갬 16 오전비온후갬 17 오후비온후갬 18 흐리고눈 19 오전눈 20 오후눈 21 차차흐려져눈 22 차차흐려져오후눈

14 23 눈온후갬 24 오전눈온후갬 25 오후눈온후갬 26 비또는눈 27 오전비또는눈 28 오후비또는눈 29 차차흐려져비또는눈 30 차차흐려져오후비또는눈 31 눈또는비 32 오전눈또는비 33 오후눈또는비 34 차차흐려져눈또는비 35 차차흐려져오후비또는눈 36 눈또는비온후갬 오전비또는눈 / 눈또는비온후갬오후비또는눈 / 눈또는비온후갬 39 천둥번개 40 안개

15 4. 풍향정보 - 현재날씨는 36방위를사용하고케이웨더예보는 16 방위코드를사용합니다. - 케이웨더예보에 wd8l, wd8r는만약각각 1ㅡ 2 가들어있다면풍향을 북- 북동 이라고 표현할수있으며공간상하나만표현할경우 wd8l 만표시합니다. 36설명 36코드 8설명 8코드 바람없음 0 바람없음 0 북북동 2 북동풍 2 북동 5 북동풍 2 동북동 7 북동풍 2 동 9 동풍 3 동남동 11 남동풍 4 남동 14 남동풍 4 남남동 16 남동풍 4 남 18 남풍 5 남남서 20 남서풍 6 남서 23 남서풍 6 서남서 25 남서풍 6 서 27 서풍 7 서북서 29 북서풍 8 북서 32 북서풍 8 북북서 34 북서풍 8 북 36 북풍

src.xls

src.xls [ 동네예보 XML element 설명 ] ex) http://www.kma.go.kr/wid/querydfs.jsp?gridx=59&gridy=127 xml 코드 xml 설명 비고 xml 선언부에한글처리 (utf-8) 인코딩선언 - 동네예보열기 - 지역, 구역헤더열기