날씨 정보 제공 openAPI

1. 기상청 API

공공데이터 포털

국가에서 보유하고 있는 다양한 데이터를『공공데이터의 제공 및 이용 활성화에 관한 법률(제11956호)』에 따라 개방하여 국민들이 보다 쉽고 용이하게 공유•활용할 수 있도록 공공데이터(Dataset)와 Open API로 제공하는 사이트입니다.

https://www.data.go.kr/tcs/dss/selectDataSetList.do?dType=API&keyword=기상청&operator=&detailKeyword=&publicDataPk=&recmSe=&detailText=&relatedKeyword=&commaNotInData=&commaAndData=&commaOrData=&must_not=&tabId=&dataSetCoreTf=&coreDataNm=&sort=_score&relRadio=&orgFullName=&orgFilter=&org=&orgSearch=&currentPage=1&perPage=10&brm=&instt=&svcType=&kwrdArray=&extsn=&coreDataNmArray=&pblonsipScopeCode=

2. OpenWeatherMap

Current weather and forecast

OpenWeather provides comprehensive weather data services, including current, forecast, and historical weather information. Explore a wide range of APIs for solar radiation, road risk assessment, solar energy prediction, and more, with global coverage and user-friendly access. Ideal for developers and businesses seeking accurate and reliable weather insights.

https://openweathermap.org/

3. AccuWeather

AccuWeather APIs | home

/tropical/{version}/gov/storms/{yyyy}/{basinID}/{governmentID}/positions

https://developer.accuweather.com/

선정 API

DB 테이블 설계

Temperature 테이블 명세표

설명:

1. id: BaseEntity에서 상속된 기본 키로, BIGINT 타입이며 자동 증가 설정이 되어 있습니다.

2. city: EnumType.STRING으로 저장된 도시의 이름입니다. VARCHAR(255)로 지정되어 있으며 NOT NULL 제약 조건을 가집니다.

3. date: 해당 날의 기온 정보를 나타내는 DATE 타입입니다.

4. average_temp, max_temp, min_temp: 각 날짜의 평균 기온, 최고 기온, 최저 기온을 나타내며, DOUBLE 타입입니다. 이들은 모두 NULLABLE로 설정되어 있습니다.

5. created_at, updated_at, deleted_at: BaseEntity에서 상속된 컬럼들로 각각 레코드의 생성, 수정, 삭제 시간을 저장합니다. deleted_at은 소프트 삭제를 위한 컬럼입니다.

ERD

서비스 흐름

1. 프론트에서 도시와 유형을 선택하고 요청을 보냅니다.
1. 유형
1. 오늘과 어제 기온 비교
2. 오늘과 예년 주 평균 기온과 비교
3. 오늘과 예년 월 평균 기온과 비교

2. 요청 날짜에 맞게 DB에 이미 자료가 생성되어 있으면 바로 조회하여 응답하고 해당 날짜에 데이터가 없는 경우는 저장한 뒤 응답합니다.

실제 구현

트러블 슈팅

feign Decoder 오버라이드를 통해 날씨 API 요청에 대한 text/xml 응답 처리하기

https://velog.io/@byeongju/feign을-통한-날씨-API-요청에-대한-textxml-응답-처리하기feat.Decoder-override

package com.pure.weather.infra.feignConfig;

import com.pure.weather.infra.dto.error.OpenAPIServiceResponse;
import feign.RetryableException;
import feign.codec.ErrorDecoder;
import jakarta.xml.bind.JAXBContext;
import jakarta.xml.bind.JAXBException;
import java.io.IOException;
import java.io.InputStream;
import java.util.Collections;
import org.springframework.http.HttpHeaders;

public class CustomErrorDecoder implements ErrorDecoder {

  @Override
  public Exception decode(String methodKey, feign.Response response) {
    String contentType =
        response
            .headers()
            .getOrDefault(HttpHeaders.CONTENT_TYPE, Collections.singleton(""))
            .toString();
    if (contentType.contains("text/xml")) {
      try {
        InputStream body = response.body().asInputStream();
        JAXBContext jaxbContext = JAXBContext.newInstance(OpenAPIServiceResponse.class);
        OpenAPIServiceResponse apiErrorResponse =
            (OpenAPIServiceResponse) jaxbContext.createUnmarshaller().unmarshal(body);

        String errMsg = apiErrorResponse.getCmmMsgHeader().getErrMsg();
        String returnReasonCode = apiErrorResponse.getCmmMsgHeader().getReturnReasonCode();

        if (returnReasonCode.equals("04")) {
          return new RetryableException(
              response.status(),
              errMsg,
              response.request().httpMethod(),
              1000L,
              response.request());
        }

        return new RuntimeException(
            String.format("Feign Error: %s , Code: %s%n", errMsg, returnReasonCode));
      } catch (JAXBException | IOException e) {
        return new RuntimeException("Error decoding XML response", e);
      }
    }

    return new Default().decode(methodKey, response);
  }
}

<OpenAPI_ServiceResponse>
	<cmmMsgHeader>
		<errMsg>SERVICE ERROR</errMsg>
		<returnAuthMsg>HTTP ROUTING ERROR</returnAuthMsg>
		<returnReasonCode>04</returnReasonCode>
	</cmmMsgHeader>
</OpenAPI_ServiceResponse>