구글시트 체크인 GPS 거리 검증: 현장 밖 체크인 차단하기

const CHK2_CONFIG = {                          // → 체크인(GPS) 전용 설정 모음
  BASE_LAT: 37.123456,                         // → 창고 기준 위도(여기만 수정)
  BASE_LNG: -122.123456,                       // → 창고 기준 경도(여기만 수정)
  MAX_DISTANCE_M: 150,                         // → 허용 반경(미터 단위)
  MAX_ACCURACY_M: 100,                         // → 이보다 부정확한 좌표는 판정하지 않는다
  REQUIRE_GPS: true                            // → 위치 없으면 거부할지 여부
};                                             

function CHK2_distanceMeters_(lat1Raw, lng1Raw, lat2Raw, lng2Raw) { // → 두 점 거리 계산
  const lat1 = Number(lat1Raw);                          // → 첫 번째 위도 숫자 변환
  const lng1 = Number(lng1Raw);                          // → 첫 번째 경도 숫자 변환
  const lat2 = Number(lat2Raw);                          // → 두 번째 위도 숫자 변환
  const lng2 = Number(lng2Raw);                          // → 두 번째 경도 숫자 변환

  if (!Number.isFinite(lat1) || !Number.isFinite(lng1) || // → 변환 후 검증
      !Number.isFinite(lat2) || !Number.isFinite(lng2)) { // → 네 값 모두 확인
    throw new Error('좌표 값이 올바르지 않습니다');          // → 잘못된 입력 막기
  }

  if (lat1 < -90 || lat1 > 90 ||                        // → 위도 허용 범위 검사
      lat2 < -90 || lat2 > 90 ||                        // → 두 좌표 모두 확인
      lng1 < -180 || lng1 > 180 ||                      // → 경도 허용 범위 검사
      lng2 < -180 || lng2 > 180) {                      // → 오타·이상값 차단
    throw new Error('좌표 범위가 유효하지 않습니다');        // → 범위 오류 메시지
  }

  const R = 6371000;                                    // → 지구 반지름(미터)
  const toRad = Math.PI / 180;                          // → 도 → 라디안 변환 상수

  const φ1 = lat1 * toRad;                              // → 첫 번째 위도 라디안
  const φ2 = lat2 * toRad;                              // → 두 번째 위도 라디안
  const Δφ = (lat2 - lat1) * toRad;                     // → 위도 차이 라디안
  const Δλ = (lng2 - lng1) * toRad;                     // → 경도 차이 라디안

  const sinHalfDLat = Math.sin(Δφ / 2);                 // → 위도 절반 사인
  const sinHalfDLng = Math.sin(Δλ / 2);                 // → 경도 절반 사인

  const a = sinHalfDLat * sinHalfDLat +                 // → 하버사인 공식 중간값
            Math.cos(φ1) * Math.cos(φ2) *               // → 위도 보정 항
            sinHalfDLng * sinHalfDLng;                  // → 경도 부분 제곱

  const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a)); // → 중심각 계산

  const d = R * c;                                      // → 거리(미터)
  return Math.round(d);                                 // → 반올림한 정수 반환
}                                                       

function CHK2_testDistance_() {                        // → 거리 테스트 함수
  const baseLat = CHK2_CONFIG.BASE_LAT;               // → 기준 위도
  const baseLng = CHK2_CONFIG.BASE_LNG;               // → 기준 경도
  const dist = CHK2_distanceMeters_(                  // → 거리 계산 실행
    baseLat, baseLng, baseLat, baseLng + 0.001        // → 경도 약간 이동
  );
  Logger.log('거리(m): ' + dist);                     // → 결과 로그로 출력
}                                                     

function CHK2_validateCheckinData_(formData) {         // → 체크인 입력 검증
  const result = {                                     // → 검증 결과 기본값
    ok: false,                                         // → 성공 여부
    message: '',                                       // → 사용자용 메시지
    cleaned: null                                      // → 정제된 데이터
  };                                                  

  if (!formData) {                                     // → 입력 자체가 없을 때
    result.message = '데이터가 전송되지 않았습니다';        // → 오류 메시지
    return result;                                     // → 즉시 종료
  }                                                    

  const containerNo = (formData.containerNo || '')     // → 컨테이너 번호 꺼내기
    .toString()                                        // → 문자열로 변환
    .trim();                                           // → 공백 제거

  if (!containerNo) {                                  // → 컨테이너 비었으면
    result.message = '컨테이너 번호를 입력해 주세요';      // → 안내 메시지
    return result;                                     // → 실패 반환
  }                                                    

  // ---- GPS 위치 검증 시작 ----
  // 공백만 든 문자열(' ')은 빈 문자열과 다르지만 Number(' ') 는 **0** 이다.
  // 그대로 두면 위도·경도 0(대서양 한가운데)으로 거리를 재게 된다. 먼저 다듬는다.
  const latRaw = (formData.lat == null) ? '' : String(formData.lat).trim();
  const lngRaw = (formData.lng == null) ? '' : String(formData.lng).trim();
  const accRaw = (formData.accuracyM == null) ? '' : String(formData.accuracyM).trim();

  let latNum = null;                                   // → 숫자형 위도 저장
  let lngNum = null;                                   // → 숫자형 경도 저장
  let distanceM = null;                                // → 기준점과 거리 저장
  let accuracyM = null;                                // → 좌표 정확도(미터)

  if (latRaw !== '' && lngRaw !== '') {               // → 두 값이 실제로 있을 때
    try {                                              // → 변환·계산 중 예외 대비
      distanceM = CHK2_distanceMeters_(               // → 기준점과 거리 계산
        latRaw,                                       // → 현재 위도 원본
        lngRaw,                                       // → 현재 경도 원본
        CHK2_CONFIG.BASE_LAT,                         // → 기준 위도
        CHK2_CONFIG.BASE_LNG                          // → 기준 경도
      );
      latNum = Number(latRaw);                        // → 숫자형 위도 보관
      lngNum = Number(lngRaw);                        // → 숫자형 경도 보관
      accuracyM = (accRaw === '') ? null : Number(accRaw); // → 정확도(없으면 null)
    } catch (e) {                                      // → 좌표·범위 오류 등
      result.message = '위치 정보를 읽는 중 오류가 발생했습니다'; // → 일반 오류 메시지
      return result;                                   // → 실패 반환
    }
  }                                                   

  if (CHK2_CONFIG.REQUIRE_GPS) {                       // → 위치 필수인 경우
    if (latNum === null || lngNum === null) {         // → 좌표가 없을 때
      result.message = '위치 권한을 허용해야 체크인할 수 있습니다'; // → 권한 안내
      return result;                                   // → 실패 반환
    }
    // 정확도가 반경보다 크면 '안에 있다/밖에 있다'를 말할 수 없다. 정확도 500m 짜리
    // 좌표로 150m 반경을 판정하면, 사실은 아무것도 판정하지 않은 것과 같다.
    if (!Number.isFinite(accuracyM) ||                // → 정확도를 안 보냈거나
        accuracyM > CHK2_CONFIG.MAX_ACCURACY_M) {     // → 너무 부정확하면
      result.message =
        'GPS 정확도가 낮습니다(오차 ' +                 // → 사용자 안내
        (Number.isFinite(accuracyM) ? Math.round(accuracyM) + 'm' : '알 수 없음') +
        '). 실외에서 잠시 후 다시 시도해 주세요';
      return result;                                   // → 판정 보류
    }
    if (distanceM > CHK2_CONFIG.MAX_DISTANCE_M) {     // → 허용 반경 초과
      result.message =
        '현장에서만 체크인할 수 있습니다 (기준 ' +      // → 반경 밖 안내
        CHK2_CONFIG.MAX_DISTANCE_M + 'm 이내)';       // → 허용 반경 표시
      return result;                                   // → 실패 반환
    }
  } else {                                             // → 위치가 선택인 경우
    // 좌표가 있을 때만 거리·좌표를 참고용으로 남기고, 반경 밖이라도 막지 않습니다.
    // 좌표가 없다면 추가 검증 없이 통과시킵니다.
  }
  // ---- GPS 위치 검증 끝 ----

  // ---- 여기 이후로는 예약 조회·상태 검증·최종 정제 로직을 넣습니다 ----
  // 예: const apptInfo = getApptInfoByCntr(containerNo); 등 (1편 조회 함수)
  // 이 글에서는 GPS 검증 흐름에 집중하기 위해 최소 예시만 포함합니다.

  result.ok = true;                                    // → 모든 검증 통과(예시)
  result.message = '체크인이 가능합니다';                // → 성공 메시지
  result.cleaned = {                                   // → 정제된 데이터 예시
    containerNo: containerNo,                          // → 컨테이너 번호
    lat: latNum,                                      // → 위도(없으면 null)
    lng: lngNum,                                      // → 경도(없으면 null)
    accuracyM: accuracyM,                             // → 좌표 정확도(없으면 null)
    distanceM: distanceM                              // → 기준점과 거리(없으면 null)
  };

  return result;                                       // → 최종 반환
}