본문 바로가기
코딩일기/날씨앱 만들기 프로젝트

[RestAPI] 기상청 API 사용에 도움되는 API

by 욱파이어니어 2022. 1. 27.
728x90
반응형

기상청 API에서 제공해주는 단기예보 API 와 중기예보 API를 사용하려다가 불편함을 겪으신분들을 위해

제가 API 2개를 만들었습니다.

 

제가 만든 API 사용을 위해선 서비스키가 필수적으로 필요합니다.

따라서 API 사용을 원하시는 분들은 저에게 따로 메일을 보내주시면 제가 메일을 통해 서비스키를 발급해 드리겠습니다.

 

메일 : hankgood958@gmail.com

 

그럼 이제 설명 시작하겠습니다.

 


 

최고최저온도 API

 

기상청에서 제공해주는 날씨정보 API 에서는 그날의 최고 온도와 최저 온도 값을 구하기 힘드셨죠??

 

그 마음 제가 잘 알고 있습니다. 왜냐면 제가 그랬기 때문이죠.

그래서 제가 최고온도와 최저온도값을 제공해주는 API를 만들었습니다.

 

제가 만든 최고온도최저온도 API는 현재일로부터 +2일째 되는 날까지의 최고온도와 최저 온도값을 제공해줍니다.

 

그 이후 날짜의 최고 온도값을 알고싶으시다면

기상청에서 제공해주는 중기예보조회서비스 API 를 사용해주시면 됩니다.

 

 

호출 URI

http://wooks-weather.com:8090/maxmintemp

 

유형 : GET

 

설명 

 

특정 날짜를 호출 URI에 입력해 해당 날짜의 최고온도와 최저온도를 조회하는 기능입니다.

해당 API는 현재 날짜로부터 +2일 까지의 최고온도와 최저온도를 조회할수 있습니다. 

그리고 한달전의 날짜의 데이터는 조회할수 없습니다.

 

 

요청 메시지

 

Header

항목명 샘플데이터 항목설명
serviceKey 인증키 저에게 받은 인증키를 입력합니다.
(필수)

 

Path Parameter

형식 샘플데이터 항목설명
yyyyMMddxy 202201259996 X좌표와 Y좌표의 년월일의 최고온도와

최저온도를 조회한다는 뜻으로 

년월일과 XY좌표를 입력해주시면
됩니다. 

(필수)

 

※ X,Y 좌표를 구하는 방법 

https://wpioneer.tistory.com/191?category=1011784 

 

날씨 앱 만들기 : 위도와 경도 기상청 격자 정보 X,Y 로 변환 (Java)

지난번에 GPS로 받아온 위도와 경도로 기상청 API에 날씨정보를 요청하려면 기상청에서 사용하는 격자정보 X,Y로 변환을 해줘야 한다. https://fronteer.kr/service/kmaxy 기상청 격자정보 - 위경도 변환 : Gr

wpioneer.tistory.com

 

PostMan 요청예시

 

 

 


 

 

 

응답메시지

항목명 샘플데이터 항목설명
statusCode
200 응답 코드입니다.
200 : 성공
204 : 없는 데이터
401 : 인증 오류
message
Success
응답 메시지입니다.
tempKey
202201259996
요청줄때의 yyyyMMddxy입니다.
bestMin
-1
최저온도
bestMax
10
최고온도
date
20220125
예보날짜
nx
99 x좌표
ny
96
y좌표

 

PostMan 응답 예시

 

 

 

 


 

지역코드 조회 API

 

+2일 이후 날짜의 최고온도와 최저온도를 알고싶으면 중기예보조회 서비스 API를 사용해야 합니다.

 

https://www.data.go.kr/data/15059468/openapi.do

 

위 API를 사용하려면 현재 위치의 지역코드가 필요합니다.

 

하지만 제가 확인해본바로는 현재위치의 구역코드를 알려주는 API는 존재하지 않더라구요.

그래서 제가 주소를 통해서 지역코드를 조회할수 있는 API를 만들었습니다.

 

 

※제가 제공해주는 구역코드로는 중기예보조회 API에서 중기육상예보조회 API 와 중기기온조회 API만을 사용할수 있습니다.

 

 

 

호출 URI

http://wooks-weather.com:8090/regioncode

 

유형 : GET

 

설명 

주소와 받고 싶은 코드의 종류를 가지고 요청해 해당 지역의 지역코드를 조회할수 있는 API 입니다.

 

 

요청 메시지

 

Header

항목명 샘플데이터 항목설명
serviceKey 인증키 저에게 받은 인증키를 입력합니다.
(필수)

 

Request Body Parameter

항목명 샘플데이터 항목설명
address
서울특별시 강동구 천호1동
지번 주소를 입력 (필수)
type
2 1 : 중기기온조회 API 사용을 위한 지역코드

2 : 중기육상예보조회 API 사용을 위한 지역코드

(필수)

 

 

PostMan 요청예시

 

 


 

 

 

응답메시지

항목명 샘플데이터 항목설명
statusCode
200 응답 코드입니다.
200 : 성공
204 : 없는 데이터
401 : 인증 오류
message Success 응답 메시지입니다.
address
서울특별시 강동구 천호1동
요청한 주소
regionCode
11B00000
지역코드
type
2 1 : 중기기온조회 API 사용을 위한
지역코드

2 : 중기육상예보조회 API 사용을 위한 지역코드

 

 

 

PostMan 응답 예시

 

 

 

 


 

 

기타 문의 사항이 있으신 분들은 저에게 메일을 주신다면 제가 답변 메일을 꼭 보내드리도록 하겠습니다!!!

반응형