@uniai-fe/uds-templates 0.5.29 → 0.6.1

package/src/weather/utils/location.ts

@@ -1,18 +1,17 @@
 import type {
   GeoCoordinate,
-  KMA_GridCoordinate,
-  KMA_Req_BaseGridCoordinate,
-  WeatherCoordinate,
+  WeatherGeoCoordinate,
+  WeatherGridCoordinate,
 } from "../types";
 
 /**
- * 날씨 도구; 접속위치 추출
+ * 날씨 도구; 접속위치 추출.
  * @util
- * @return {GeoCoordinate}}
+ * @desc 브라우저 geolocation API에서 현재 위치를 읽고, 사용할 수 없으면 null 좌표를 반환한다.
+ * @return {Promise<GeoCoordinate>} 브라우저 geolocation에서 읽은 위경도
  */
 export const userLocation = async (): Promise<GeoCoordinate> => {
   if (typeof window === "undefined" || !window.navigator.geolocation) {
-    // console.log("[userLocation] window 없음");
     return { latitude: null, longitude: null };
   }
 
@@ -22,12 +21,11 @@ export const userLocation = async (): Promise<GeoCoordinate> => {
         window.navigator.geolocation.getCurrentPosition(resolve, reject);
       },
     );
-    // console.log("[userLocation] 위치 정보:", position.coords);
-    const res = {
+
+    return {
       latitude: position.coords.latitude,
       longitude: position.coords.longitude,
     };
-    return res;
   } catch (error) {
     console.error("[userLocation] 위치 정보 에러", error);
     return { latitude: null, longitude: null };
@@ -35,41 +33,36 @@ export const userLocation = async (): Promise<GeoCoordinate> => {
 };
 
 /**
- * 날씨 도구; 위경도 -> 격자 좌표 변환
+ * 날씨 도구; 위경도 좌표를 backend weather 격자 좌표로 변환한다.
  * @util
- * @param {GeoCoordinate} coordinate - 위경도 좌표
- * @param {number} coordinate.latitude - 위도
- * @param {number} coordinate.longitude - 경도
- * @return {KMA_GridCoordinate} 격자 좌표
- * @desc
- * - 위경도 좌표를 기상청 격자 좌표로 변환합니다.
- * - 출처: 기상청
- * @see https://apihub.kma.go.kr/
- * @see https://apihub.kma.go.kr/getAttachFile.do?fileName=%EB%8B%A8%EA%B8%B0%EC%98%88%EB%B3%B4%20%EC%A1%B0%ED%9A%8C%EC%84%9C%EB%B9%84%EC%8A%A4_API%ED%99%9C%EC%9A%A9%EA%B0%80%EC%9D%B4%EB%93%9C_241128.docx
+ * @param {GeoCoordinate} coordinate 위경도 좌표
+ * @param {number|null} coordinate.latitude 위도
+ * @param {number|null} coordinate.longitude 경도
+ * @return {WeatherGridCoordinate} backend weather 격자 좌표
  */
-export function convertCoordinateToGrid({
+export const convertCoordinateToGrid = ({
   latitude,
   longitude,
-}: GeoCoordinate): KMA_GridCoordinate {
-  const res: KMA_GridCoordinate = { x: 0, y: 0 };
+}: GeoCoordinate): WeatherGridCoordinate => {
+  const fallback: WeatherGridCoordinate = { nx: null, ny: null };
 
-  if (latitude === null || longitude === null) return res;
+  if (latitude === null || longitude === null) return fallback;
 
-  const RE = 6371.00877; // Earth radius (km)
-  const GRID = 5.0; // Grid spacing (km)
-  const SLAT1 = 30.0; // Projection latitude 1 (degree)
-  const SLAT2 = 60.0; // Projection latitude 2 (degree)
-  const ORIGIN_LONGITUDE = 126.0; // Origin longitude (degree)
-  const ORIGIN_LATITUDE = 38.0; // Origin latitude (degree)
-  const XO = 43; // Origin X coordinate (GRID)
-  const YO = 136; // Origin Y coordinate (GRID)
+  const RE = 6371.00877;
+  const GRID = 5.0;
+  const SLAT1 = 30.0;
+  const SLAT2 = 60.0;
+  const ORIGIN_LONGITUDE = 126.0;
+  const ORIGIN_LATITUDE = 38.0;
+  const XO = 43;
+  const YO = 136;
 
   const RADIAN = Math.PI / 180.0;
   const re = RE / GRID;
   const slat1 = SLAT1 * RADIAN;
   const slat2 = SLAT2 * RADIAN;
-  const origin_longitude = ORIGIN_LONGITUDE * RADIAN;
-  const origin_latitude = ORIGIN_LATITUDE * RADIAN;
+  const originLongitude = ORIGIN_LONGITUDE * RADIAN;
+  const originLatitude = ORIGIN_LATITUDE * RADIAN;
 
   const sn =
     Math.log(Math.cos(slat1) / Math.cos(slat2)) /
@@ -80,85 +73,37 @@ export function convertCoordinateToGrid({
 
   const sf = Math.tan(Math.PI * 0.25 + slat1 * 0.5);
   const sfPow = (Math.pow(sf, sn) * Math.cos(slat1)) / sn;
-
   const ro =
     (re * sfPow) /
-    Math.pow(Math.tan(Math.PI * 0.25 + origin_latitude * 0.5), sn);
-
+    Math.pow(Math.tan(Math.PI * 0.25 + originLatitude * 0.5), sn);
   const ra =
     (re * sfPow) /
     Math.pow(Math.tan(Math.PI * 0.25 + latitude * RADIAN * 0.5), sn);
-  let theta = longitude * RADIAN - origin_longitude;
+  let theta = longitude * RADIAN - originLongitude;
+
   if (theta > Math.PI) theta -= 2.0 * Math.PI;
   if (theta < -Math.PI) theta += 2.0 * Math.PI;
   theta *= sn;
 
-  res.x = Math.floor(ra * Math.sin(theta) + XO + 0.5);
-  res.y = Math.floor(ro - ra * Math.cos(theta) + YO + 0.5);
-
-  // console.log("[WEATHER] 위/경도 -> 기상청 격자값", res);
-
-  return res;
-}
+  return {
+    nx: Math.floor(ra * Math.sin(theta) + XO + 0.5),
+    ny: Math.floor(ro - ra * Math.cos(theta) + YO + 0.5),
+  };
+};
 
 /**
- * 날씨 도구; 위도/경도 -> 기상청 격자 좌표 변환
+ * 날씨 도구; weather 위경도 좌표를 backend weather 격자 좌표로 변환한다.
  * @util
- * @param {WeatherCoordinate} [coordinate] - 사용자 위치 이외의 특정 위도/경도 좌표
- * @param {number} coordinate.lat - 위도
- * @param {number} coordinate.lng - 경도
- * @return {KMA_Req_BaseGridCoordinate} 기상청 격자 좌표
+ * @param {Partial<WeatherGeoCoordinate>} coordinate weather 위경도 좌표
+ * @param {number|null} [coordinate.lat] 위도
+ * @param {number|null} [coordinate.lng] 경도
+ * @return {WeatherGridCoordinate} backend weather 격자 좌표
  */
-export async function getWeatherGridLocation(
-  coordinate?: WeatherCoordinate,
-): Promise<KMA_Req_BaseGridCoordinate> {
-  const res: KMA_Req_BaseGridCoordinate = { nx: 0, ny: 0 };
-
-  if (typeof window === "undefined") return res;
-
-  const geo: GeoCoordinate = {
-    latitude: coordinate?.lat ?? null,
-    longitude: coordinate?.lng ?? null,
-  };
-  const hasInjectedAddress =
-    typeof coordinate?.address === "string" && coordinate.address.trim() !== "";
-
-  // console.log("[getWeatherLocation] 특정 좌표지정 확인", coordinate);
-
-  // 변경 설명: 서비스가 address만 명시적으로 주입한 경우에는 geolocation fallback을 재시도하지 않는다.
-  if (
-    typeof window !== "undefined" &&
-    !hasInjectedAddress &&
-    (typeof coordinate === "undefined" ||
-      geo.latitude === null ||
-      geo.longitude === null)
-  ) {
-    const { latitude, longitude } = await userLocation();
-
-    if (latitude === null || longitude === null) {
-      // console.log("[getWeatherLocation] window.navigator 실패", geo);
-      return res;
-    }
-    geo.latitude = latitude;
-    geo.longitude = longitude;
-    // console.log("[getWeatherLocation] 사용자 위치", geo);
-  }
-
-  // 위경도 좌표를 기상청 격자좌표로 변환
-  const grid = convertCoordinateToGrid(geo);
-
-  if (grid.x === 0 || grid.y === 0) {
-    // console.error("[getWeatherLocation] 위치 정보를 가져오는데 실패했습니다.", {
-    //   latitude: geo.latitude,
-    //   longitude: geo.longitude,
-    // });
-    return res;
-  }
-  // console.log("[getWeatherLocation] 기상청 격자좌표", grid);
-
-  res.nx = grid.x;
-  res.ny = grid.y;
-
-  // console.log("[getWeatherLocation] result", res);
-  return res;
-}
+export const convertWeatherCoordinateToGrid = ({
+  lat,
+  lng,
+}: Partial<WeatherGeoCoordinate>): WeatherGridCoordinate =>
+  convertCoordinateToGrid({
+    latitude: lat ?? null,
+    longitude: lng ?? null,
+  });