Version 1.0.0
목 차 version 1.0.0 1. 예보별제공요소정의 1. 1 국내현재날씨 ------------------------------------- 1 1. 2 국내케이웨더예보 1시간단위 -------------------- 2 1. 3 국내케이웨더예보 6시간단위 -------------------- 2 1. 4 국내케이웨더예보 12시간단위 ------------------- 3 1. 5 국내케이웨더예보일단위 ------------------------ 4 1. 6 국내생활지수 ------------------------------------- 4 1. 7 세계현재날씨 ------------------------------------- 5 1. 8 세계예보 1시간단위 ------------------------------ 6 1. 9 세계예보일단위 ---------------------------------- 6 1.10 세계기후정보 ------------------------------------- 7 1.11 세계생활지수 ------------------------------------- 7 1.12 날씨뉴스 ------------------------------------------ 7 1.13 날씨방송영상 ------------------------------------- 8 1.14 날씨방송썸네일정보 ------------------------------ 8 1.15 현재위치검색 --------------------------------------- 8 1.16 도시명검색 ----------------------------------------- 9 2. 메소드호출리턴코드 ------------------------------- 9 3. 아이콘정보 1. 1 12아이콘 ------------------------------------------ 10 1. 2 40아이콘 ------------------------------------------ 10 4. 풍향정보 ------------------------------------------- 13 5. 지역코드 ( 별첨)
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,2011122613 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 -
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 발표시각 2012050321 date 적용 날짜 20120503 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 -
announce_date 발표시각 2012050321 quater 적용시간 1- 새벽(00~06), 2- 아침(06~12), 3-낮 (12~18), 4- 저녁(18~24) date 적용 날짜 20120503 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 발표시각 2012050321 ampm 적용 시간 1-am, 2-pm date 적용 날짜 20120503 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 -
snowf 강설량 cm 없으면 na 1. 5 국내케이웨더예보일단위 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) announce_date 발표시각 2012050321 ampm 적용 시간 1-am, 2-pm date 적용 날짜 20120503 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자리 숫자 10000 date 업데이트시각 YYYYMMDDH 2013042514 표출형태 H URL BI 링크 URL name 지수종류감기, 나들이, 불쾌, 운동, 자외선 - 4 -
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,201112 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 -
1. 8 세계예보 1시간단위 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) announce_date 발표시각 2011122611 date 날짜 20111226 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 날짜 20111226 dow 요일 1~7( 일~ 토) icon 날씨아이콘 1~40 max_temp 최고기온 ( 소수점 첫째자리) 정수 min_temp 최저기온 ( 소수점 첫째자리) 정수 - 6 -
1. 10 세계기후정보 Region_id 시티 코드 15000 Region_ko/en 대륙 명( 한글/ 영문) 공항 month 적용 월 1, 2, 3, 12 Max_temp 월 평균최고기온 20.2 Min_temp 월 평균최저기온 3.8 rainf 월 평균강수량 mm, 16.7 raindays 월 평균강수일수 3 Climate 월 기후특징 텍스트 tourtip 월 옷차림정보 텍스트 1. 11 세계생활지수 구분 설명 표시형식 표출형태 region_id 지역코드 5자리 숫자 10000 date 업데이트시각 YYYYMMDDH 2013042514 H URL BI 링크 URL name 지수 코드 level 지수 단계 0~100 80 text 지수 설명 평소 건강관리에유의하세 지수코드 01 나들이 02 운동 04 불쾌 05 냉방 06 빨래 07 세차 08 불조심 09 부패 10 감기 11 난방 요 1. 12 날씨뉴스 구분 설명 표시형식 표출형태 region_id 지역코드 5자리 숫자 10000 date 업데이트시각 YYYYMMDDH 2013042514-7 -
H URL BI 링크 URL name 지수 코드 level 지수 단계 0~100 80 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 -
distance 좌표와의거리입력좌표와 region 좌표와의직선거리( 단 위 : meter) 1.16 도시명검색정렬기준 : 오름차순[A->Z, ㄱ-> ㅎ], 최대20건표출 srch_cnt 검색 결과개수 region_id 지역코드 5자리의 숫자로구성 dong_ko/en 동 이름( 한글/ 영문) 2. 메소드호출리턴코드 메소드를통한접근시처리상태에따른상태코드번호를리턴합니다. 코드 내용 1 정상호출 2 호출횟수초과 3 유효기간만료 4 API 키오류 - 9 -
3. 아이콘정보 1.1 12 아이콘 번호아이콘설명 1 맑음 2 구름조금 3 구름많음 4 흐림 5 흐리고비 6 흐리고눈 7 비온후갬 8 소나기 9 비또는눈 10 눈또는비 11 천둥번개 12 안개 1.2 40 아이콘 번호아이콘설명 1 맑음 2 구름조금 3 구름많음 - 10 -
4 흐림 5 흐린후차차갬 6 맑은후차차흐려짐 7 소나기 8 오전소나기 9 오후소나기 10 흐리고비 11 오전비 12 오후비 13 차차흐려져비 14 차차흐려져오후비 15 비온후갬 16 오전비온후갬 17 오후비온후갬 18 흐리고눈 19 오전눈 20 오후눈 21 차차흐려져눈 22 차차흐려져오후눈 - 11 -
23 눈온후갬 24 오전눈온후갬 25 오후눈온후갬 26 비또는눈 27 오전비또는눈 28 오후비또는눈 29 차차흐려져비또는눈 30 차차흐려져오후비또는눈 31 눈또는비 32 오전눈또는비 33 오후눈또는비 34 차차흐려져눈또는비 35 차차흐려져오후비또는눈 36 눈또는비온후갬 37 38 오전비또는눈 / 눈또는비온후갬오후비또는눈 / 눈또는비온후갬 39 천둥번개 40 안개 - 12 -
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 북풍 1-13 -