@uniai-fe/uds-templates 0.1.16 → 0.1.17

package/src/weather/utils/weather.ts

@@ -0,0 +1,304 @@
+import type {
+  API_Res_WeatherKoreaBase,
+  API_Res_WeatherKoreaForecast,
+  API_Res_WeatherKoreaNow,
+  KMA_Res_WeatherItem,
+  KMA_Res_WeatherForecast,
+  KMA_Res_WeatherNow,
+} from "../types";
+import { getMoments } from "./date-time";
+
+/**
+ * 날씨 도구; 현재 날씨/예보 값 추출
+ * @param {KMA_Res_WeatherItem[]} items - 현재 날씨 아이템
+ * @param {string} category - 카테고리
+ * @return {string | null} 현재 날씨 값
+ */
+const getValueNow = (
+  items: KMA_Res_WeatherItem[],
+  category: string,
+): string | null => items.find(i => i.category === category)?.fcstValue || null;
+
+/**
+ * 날씨 도구; 예보 값 추출
+ * @param {KMA_Res_WeatherItem[]} items - 예보 아이템
+ * @param {string} date - 날짜
+ * @param {string} category - 카테고리
+ * @return {string | null} 예보 값
+ */
+const getValueForecast = (
+  items: KMA_Res_WeatherItem[],
+  date: string,
+  category: string,
+): string | null =>
+  items.find(i => i.fcstDate === date && i.category === category)?.fcstValue ||
+  null;
+
+/**
+ * 강수량 코드
+ * @desc
+ * - 1(약한 비); 3mm/h 미만
+ * - 2(보통 비); 3mm/h 이상 15mm/h 미만
+ * - 3(강한 비); 15mm/h 이상
+ * @param {string} props.pty - 강수형태 코드
+ * @param {string} props.pcp - 1시간 강수량
+ * @return {string | null} 강수량 코드; 1(약한비), 2(보통비), 3(강한비)
+ */
+const getRainAmount = ({
+  pty,
+  pcp,
+}: {
+  pty: string | null;
+  pcp: string | null;
+}): string | null => {
+  if (!pty || !pcp) return null;
+
+  if (Number(pcp) < 3) return "1";
+  else if (3 <= Number(pcp) && Number(pcp) < 15) return "2";
+  else return "3";
+};
+
+/**
+ * 강설량 코드
+ * @desc
+ * - 1(보통 눈); 1cm/h 미만
+ * - 2(많은 눈); 1cm/h 이상
+ * @param {string} props.pty - 강수형태 코드
+ * @param {string} props.snow - 1시간 신적설
+ * @return {string | null} 강설량 코드; 1(보통눈), 2(많은눈)
+ */
+const getSnowAmount = ({
+  pty,
+  snow,
+}: {
+  pty: string | null;
+  snow: string | null;
+}): string | null => {
+  if (!pty || !snow) return null;
+
+  if (Number(snow) < 1) return "1";
+  else return "2";
+};
+
+/**
+ * 풍속 코드
+ * @desc
+ * - 1(약한 바람); 4m/s 미만
+ * - 2(약간 강한 바람); 4m/s 이상 9m/s 미만
+ * - 3(강한 바람); 9m/s 이상
+ * @param {string} props.wind - 풍속
+ * @return {string | null} 풍속 코드; 1(약한바람), 2(약간강한바람), 3(강한바람)
+ */
+const getWindSpeed = ({ wind }: { wind: string | null }): string | null => {
+  if (!wind) return null;
+  if (Number(wind) < 4) return "1";
+  else if (4 <= Number(wind) && Number(wind) < 9) return "2";
+  else return "3";
+};
+
+/**
+ * 날씨 상태 코드
+ * @desc
+ * - sky-1(맑음)
+ * - sky-2(구름조금)
+ * - sky-3(구름많음)
+ * - sky-4(흐림)
+ * - drop-rain-shower(소나기)
+ * - drop-rain(비)
+ * - drop-rain-1(약한 비)
+ * - drop-rain-2(보통 비)
+ * - drop-rain-3(강한 비)
+ * - drop-rain-snow(비/눈)
+ * - drop-rain-snow-1(약한 비/눈)
+ * - drop-rain-snow-2(보통 비/눈)
+ * - drop-rain-snow-3(강한 비/눈)
+ * - drop-snow(눈)
+ * - drop-snow-1(보통 눈)
+ * - drop-snow-2(많은 눈)
+ * @param {string} props.sky - 하늘상태 코드; 1(맑음), 2(구름조금), 3(구름많음), 4(흐림)
+ * @param {string} props.pty - 강수형태 코드; 0(없음), 1(비), 2(비/눈), 3(눈), 4(소나기)
+ * @param {string} props.pcp - 1시간 강수량
+ * @param {string} props.snow - 1시간 신적설
+ */
+const getWeatherCondition = ({
+  sky,
+  pty,
+  pcp,
+  snow,
+}: {
+  sky: string | null;
+  pty: string | null;
+  pcp: string | null;
+  snow: string | null;
+}): { code: string | null; name: string | null } => {
+  const dropType = () => {
+    if (!pty || isNaN(Number(pty)) || pty === "0") return null;
+    switch (Number(pty)) {
+      case 1:
+        return "rain";
+      case 2:
+        return "rain-snow";
+      case 3:
+        return "snow";
+      case 4:
+        return "shower";
+      default:
+        return null;
+    }
+  };
+
+  if (!dropType()) {
+    const skyCode = sky === null ? null : sky;
+    const skyName = () => {
+      switch (Number(skyCode)) {
+        case 1:
+          return "맑음";
+        case 2:
+          return "구름조금";
+        case 3:
+          return "구름많음";
+        case 4:
+          return "흐림";
+        default:
+          return null;
+      }
+    };
+
+    return {
+      code: `sky-${skyCode}`,
+      name: skyName(),
+    };
+  }
+
+  const rainAmount = getRainAmount({ pty, pcp });
+  const snowAmount = getSnowAmount({ pty, snow });
+
+  const dropStrength = (): string | null => {
+    const type = dropType();
+    if (type === "rain") return rainAmount;
+    else if (type === "snow") return snowAmount;
+    else if (type === "rain-snow") {
+      if (rainAmount === null) return snowAmount;
+      if (snowAmount === null) return rainAmount;
+      // rainAmount와 snowAmount 중 큰 값을 선택
+      return Math.max(Number(rainAmount), Number(snowAmount)).toString();
+    }
+    // 소나기
+    else if (type === "shower") return type;
+    return null;
+  };
+
+  const dropCode = `drop-${dropType()}${dropStrength() ? `-${dropStrength()}` : ""}`;
+  const dropName = () => {
+    const type = dropType();
+    if (type === "rain") {
+      if (dropStrength() === null) return "비";
+      if (rainAmount === "1") return "약한 비";
+      else if (rainAmount === "2") return "보통 비";
+      else if (rainAmount === "3") return "강한 비";
+    } else if (type === "snow") {
+      if (dropStrength() === null) return "눈";
+      if (snowAmount === "1") return "보통 눈";
+      else if (snowAmount === "2") return "많은 눈";
+    } else if (type === "rain-snow") {
+      if (dropStrength() === null) return "비/눈";
+      if (dropStrength() === "1") return "약한 비/눈";
+      else if (dropStrength() === "2") return "보통 비/눈";
+      else if (dropStrength() === "3") return "강한 비/눈";
+    } else if (type === "shower") {
+      return "소나기";
+    }
+    return null;
+  };
+
+  return {
+    code: dropCode,
+    name: dropName(),
+  };
+};
+
+export function now(
+  outputResponse: API_Res_WeatherKoreaNow,
+  apiResponse: KMA_Res_WeatherNow,
+): API_Res_WeatherKoreaNow {
+  const res: API_Res_WeatherKoreaNow = { ...outputResponse };
+
+  const items = apiResponse?.response?.body?.items?.item;
+  if (!items || !Array.isArray(items) || items.length === 0) return res;
+
+  const sky = getValueNow(items, "SKY"); // 없음
+  const pty = getValueNow(items, "PTY"); // 강수형태
+  const pcp = getValueNow(items, "RN1"); // 1시간 강수량 PCP없음
+  const snow = getValueNow(items, "SNO"); // 없음
+  const wind = getValueNow(items, "WSD");
+
+  const condition = getWeatherCondition({ sky, pty, pcp, snow });
+
+  const getDailyState: API_Res_WeatherKoreaBase = {
+    sky,
+    drop: pty,
+    rainAmount: getRainAmount({ pty, pcp }),
+    snowAmount: getSnowAmount({ pty, snow }),
+    windSpeed: getWindSpeed({ wind }),
+    condition: condition.code,
+    conditionName: condition.name,
+  };
+
+  res.today.temperature = getValueNow(items, "T1H");
+  res.today.humidity = getValueNow(items, "REH");
+
+  Object.assign(res.today, getDailyState);
+
+  return res;
+}
+
+export function forecast(
+  outputResponse: API_Res_WeatherKoreaForecast,
+  apiResponse: KMA_Res_WeatherForecast,
+): API_Res_WeatherKoreaForecast {
+  const res: API_Res_WeatherKoreaForecast = { ...outputResponse };
+
+  const items = apiResponse?.response?.body?.items?.item;
+  if (!items || !Array.isArray(items) || items.length === 0) return res;
+
+  const { today, tomorrow, dayAfterTomorrow } = getMoments();
+
+  const getDailyState = (date: string): API_Res_WeatherKoreaBase => {
+    const sky = getValueForecast(items, date, "SKY");
+    const pty = getValueForecast(items, date, "PTY");
+    const pcp = getValueForecast(items, date, "PCP");
+    const snow = getValueForecast(items, date, "SNO");
+    const wind = getValueForecast(items, date, "WSD");
+
+    const condition = getWeatherCondition({ sky, pty, pcp, snow });
+
+    return {
+      sky,
+      drop: pty,
+      rainAmount: getRainAmount({ pty, pcp }),
+      snowAmount: getSnowAmount({ pty, snow }),
+      windSpeed: getWindSpeed({ wind }),
+      condition: condition.code,
+      conditionName: condition.name,
+    };
+  };
+
+  res.today.temperature = getValueForecast(items, today, "TMP");
+  res.today.humidity = getValueForecast(items, today, "REH");
+  Object.assign(res.today, getDailyState(today));
+
+  res.day_1.max_temperature = getValueForecast(items, tomorrow, "TMX");
+  res.day_1.min_temperature = getValueForecast(items, tomorrow, "TMN");
+  Object.assign(res.day_1, getDailyState(tomorrow));
+
+  res.day_2.max_temperature = getValueForecast(items, dayAfterTomorrow, "TMX");
+  res.day_2.min_temperature = getValueForecast(items, dayAfterTomorrow, "TMN");
+  Object.assign(res.day_2, getDailyState(dayAfterTomorrow));
+
+  return res;
+}
+
+export const extractWeatherSummary = {
+  forecast,
+  now,
+};