파이썬으로 기상청 일기예보와 날씨 API 사용하기

기상청에서 제공하는 날씨 API를 사용해보려고 한다.

현재 내가 다니고 있는 회사는 모임플래폼을 운영하고 있다.

 

어플에서는 모임을 만들 수 있는데 날짜와 시간, 장소를 적는다.

그러면 모임을 하는 날이 일기예보가 제공되는 날이라면

날씨를 알려주면 모임 날을 바꾸거나 픽스하는데 도움이 되지 않을까하는 생각에서 시작하게 되었다. 

 

알려주는 곳이 없어서 직접 적어본다.이걸 보고 좋은 api를 써보면서 양질의 사이트가 나왔으면 좋겠다.

 

먼저 API를 사용하기 위해 공공데이터사이트에 가서 가입해준다.

공공데이터 포털

가입을 한 다음에 검색창에 기상청을 검색한다.

그다음 오픈 API를 눌러서 본인이 원하는 API를 찾아준다. 나는 중기예보 조회서비스를 이용한다.

 

활용신청 버튼을 눌러서 목적에 맞게 작성한다. 나는 '공부'라고 적었다.

 

활용신청을 하고 [승인] 기상청_중기예보 조회서비스를 누르면 API 키를 얻을 수 있다.

 

위에 보이는 일반 인증키 2개를 전부 복사해서 사용한다.

적혀있는 내용에서도 둘 중 되는거 아무거나 쓰라고 명시되어 있다.

 

이제 사용할 준비가 끝났는데 본인이 사용할 목적이 무엇인지에 맞게 쓰면 된다.

 

1. 일기예보가지고오기

○ (하늘상태) 이번 예보기간에는 대체로 맑겠으나, 22일(수)~24일(금)에는 가끔 구름많겠습니다.
○ (기온) 21일(화)~22일(수) 아침 기온은 -5~1도, 낮 기온은 3~11도로 평년(최저기온 -2~2도, 최고기온 9~12도)과 비슷하거나 조금 낮겠고, 23일(목)~27일(월) 아침 기온은 -2~4도, 낮 기온은 7~13도로 평년(최저기온 -1~3도, 최고기온 9~12도)과 비슷하겠습니다.
○ (해상) 바다의 물결은 서해남부와 남해서부 해상에서 21일(화)에 1~4m로 매우 높게 일겠고, 그 밖의 날은 1~2m로 일겠습니다.

위와 같은 일기예보를 얻고 싶으면 아래와 같은 코드를 입력하면 된다.

# Python3 샘플 코드 #
import requests
import json

url = 'http://apis.data.go.kr/1360000/MidFcstInfoService/getMidFcst'
params = {
            'serviceKey' : key2, #본인 키값
            'pageNo' : '1',
            'numOfRows' : '10', 
            'dataType' : 'JSON', 
            'stnId' : '156', #지역코드
            'tmFc' : '202302171800' #확인할 날짜
         }

response = requests.get(url, params=params)
response.content.decode('utf8')
# print(response.content)
print(json.loads(response.text))

"""
기상청 예제에서는 print(response.content)로 되어있었는데,
나는 여기서 한글이 유니코드로 나와서 한글을 읽을 수가 없었다.

그래서 json을 읽을 수 있게 import json을 해주고
json으로 로드해서 읽었다.

그냥 print해서 한글이 나온다면 주석처리를 지우고 사용해도 된다.
"""

'serviceKey' 변수에는 아까 키값 2개중 하나 되는걸 입력하면 된다.

나는 인코딩키가 될때도 있었고, 디코딩키가 될때가 있었다.

 

'pageNo'와 'numOfRows'는 변수명과 같고, 

'dataType'은 'XML' 또는 'JSON'형식으로 받을 수 있다.

 

'stnId'는 알고 싶은 지역을 적으면 된다.

나는 광주, 전라남도 지역을 알고 싶어서 '156'을 입력했다.

지점번호	구역
105	강원도
108	전국
109	서울, 인천, 경기도
131	충청북도
133	대전, 세종, 충청남도
146	전라북도
156	광주, 전라남도
143	대구, 경상북도
159	부산, 울산, 경상남도
184	제주도

'tmFc' 는 날짜를 적으면 된다. 이부분은 제한사항이 있다.

오늘 날짜 기준으로 1일전까지 입력가능하다.

 

오늘 기준으로 2023년 02월 18일이라고 한다면

202302170600 ~ 202302180600 까지 된다.

-일 2회(06:00,18:00)회 생성 되며 발표시각을 입력 YYYYMMDD0600 (1800)-최근 24시간 자료만 제공

만약 범위에서 벗어난 날짜를 입력하면 에러코드를 리턴받게 된다.

{'response': {'header': {'resultCode': '99',
   'resultMsg': '최대 조회 기간은 오늘 기준으로 1일 전까지입니다.'}}}

2. 중기육상예보조회하기

예보구역코드, 발표시각의 조회 조건으로 예보일로부터

3일에서 10일까지 육상날씨정보를 조회하는 기능이다.

 

# Python3 샘플 코드 #
import requests
import json

url = 'http://apis.data.go.kr/1360000/MidFcstInfoService/getMidLandFcst'
params = {
            'serviceKey' : key2, # 본인 키값
            'pageNo' : '1',
            'numOfRows' : '10', 
            'dataType' : 'JSON', 
            'regId' : '11F20000', # 지역코드
            'tmFc' : '202302171800' # 확인할 날짜
         }

response = requests.get(url, params=params)
response.content.decode('utf8')
# print(response.content)
print(json.loads(response.text))

{'response': {'header': {'resultCode': '00', 'resultMsg': 'NORMAL_SERVICE'},   'body': {'dataType': 'JSON',    'items': {'item': [{'regId': '11F20000',       'rnSt3Am': 0,       'rnSt3Pm': 0,       'rnSt4Am': 0,       'rnSt4Pm': 0,       'rnSt5Am': 0,       'rnSt5Pm': 30,       'rnSt6Am': 30,       'rnSt6Pm': 30,       'rnSt7Am': 30,       'rnSt7Pm': 10,       'rnSt8': 20,       'rnSt9': 10,       'rnSt10': 10,       'wf3Am': '맑음',       'wf3Pm': '맑음',       'wf4Am': '맑음',       'wf4Pm': '맑음',       'wf5Am': '맑음',       'wf5Pm': '구름많음',       'wf6Am': '구름많음',       'wf6Pm': '구름많음',       'wf7Am': '구름많음',       'wf7Pm': '맑음',       'wf8': '맑음',       'wf9': '맑음',       'wf10': '맑음'}]},    'pageNo': 1,    'numOfRows': 10,    'totalCount': 1}}}

나머지 값들은 다 똑같으니 넘어가고

'regId'는 지역코드이다. 중기육상일기예보에서는 지역코드가 또 다르다.

예보구역코드	구역
11B00000	서울, 인천, 경기도
11D10000	강원도영서
11D20000	강원도영동
11C20000	대전, 세종, 충청남도
11C10000	충청북도
11F20000	광주, 전라남도
11F10000	전라북도
11H10000	대구, 경상북도
11H20000	부산, 울산, 경상남도
11G00000	제주도

그리고 리턴값에 대해서 조금 알려주자면  

'rnSt3Am': 0 은 3일 후 오전에 비올 확률이 0%라는 뜻이다.

'rnSt3Pm': 0 은 3일 후 오후에 비올 확률이 0%라는 뜻이다.

4,5,6,7,8,9,10 은 본인이 적은 날짜의 4일후, 5일후, 10일후 라는 뜻이다.

 'wf3Am': '맑음', 이건 3일 후 오전의 구름 상태이다.

 

상태는 아래와 같이 나타난다고 한다.

중기예보 통보문에서 구름의 양에 따라 하늘상태를 3단계(맑음, 구름많음, 흐림)으로 표현, 현상에 따라 비, 눈, 비/눈, 소나기 로 표현하고 있으며, 이를 종합하여 함께 사용하고 있음 - 맑음 - 구름많음, 구름많고 비, 구름많고 눈, 구름많고 비/눈, 구름많고 소나기 - 흐림, 흐리고 비, 흐리고 눈, 흐리고 비/눈, 흐리고 소나기

 

그 외에도 온도, 해상날씨가 있는데 그건 찾아서 해보길 바란다.

 

혹시라도 에러가 난다면 아래 표를 참고해서 해결하면 도움이 된다.

에러코드	에러메세지	설명
00	NORMAL_SERVICE	정상
01	APPLICATION_ERROR	어플리케이션 에러
02	DB_ERROR	데이터베이스 에러
03	NODATA_ERROR	데이터없음 에러
04	HTTP_ERROR	HTTP 에러
05	SERVICETIME_OUT	서비스 연결실패 에러
10	INVALID_REQUEST_PARAMETER_ERROR	잘못된 요청 파라메터 에러
11	NO_MANDATORY_REQUEST_PARAMETERS_ERROR	필수요청 파라메터가 없음
12	NO_OPENAPI_SERVICE_ERROR	해당 오픈API서비스가 없거나 폐기됨
20	SERVICE_ACCESS_DENIED_ERROR	서비스 접근거부
21	TEMPORARILY_DISABLE_THE_SERVICEKEY_ERROR	일시적으로 사용할 수 없는 서비스 키
22	LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR	서비스 요청제한횟수 초과에러
30	SERVICE_KEY_IS_NOT_REGISTERED_ERROR	등록되지 않은 서비스키
31	DEADLINE_HAS_EXPIRED_ERROR	기한만료된 서비스키
32	UNREGISTERED_IP_ERROR	등록되지 않은 IP
33	UNSIGNED_CALL_ERROR	서명되지 않은 호출
99	UNKNOWN_ERROR	기타에러