기상청 날씨 달력 가이드

1 프로젝트 포크 (Fork)

상단 원본 저장소 링크 접속 후 오른쪽 상단의 [Fork] 버튼을 눌러 내 계정으로 가져옵니다.

🔄 기존 포크 사용자 업데이트 방법

이미 포크하신 분들은 본인 저장소 메인에서 [Sync fork] → [Update branch]를 누르세요. 최신 코드가 반영되어 Secrets 설정만으로 관리할 수 있게 됩니다.

2 기상청 API 인증키 발급

1. 기상청 API 허브 회원가입 후 [인증키 현황]에서 키를 복사합니다.

2. 좌측 메뉴 [예특보] 항목에서 아래 서비스들을 찾아 각각 활용 신청을 완료하세요:

• 단기 예보 〉 4.3 단기예보조회
• 중기 예보 〉 2.2 중기기온조회
• 중기 예보 〉 2.3 중기육상예보조회

3 내 동네 설정값 찾기

① 가까운 예보 지점을 선택하세요:

② 상세 주소(도로명)를 입력하세요:

✅ 다음 단계(Secrets)에서 입력할 값입니다:

NX: - / NY: -
REG_ID_LAND: - / REG_ID_TEMP: -

4 GitHub Secrets 설정

내 저장소 Settings → Secrets and variables → Actions에서 아래 항목들을 추가합니다.

• KMA_API_KEY : 기상청 인증키
• KMA_NX, KMA_NY : 위에서 계산된 좌표 값
• REG_ID_LAND, REG_ID_TEMP : 위에서 확인한 구역 코드
• LOCATION_NAME : 달력에 표시될 동네 이름 (예: 우리집)

5 자동 업데이트 활성화

⚠️ 중요: GitHub Actions 활성화 (최초 1회)
GitHub 정책상 Fork된 저장소는 자동 실행 기능이 꺼져 있습니다.
상단 [Actions] 탭 클릭 후 나타나는 초록색 버튼 "I understand my workflows, go ahead and enable them"을 반드시 눌러주세요!

⏳ 첫 실행 확인하기
활성화 후 왼쪽 목록에서 Weather Calendar Update를 선택하고, Run workflow를 눌러 수동으로 한 번 실행해 보세요.

6 캘린더 구독하기

생성된 weather.ics 파일의 Raw 주소를 복사하여 스마트폰 달력 앱에 등록하세요.

⏰ 업데이트 주기 안내

단기 예보 (오늘~3일): 기상청 데이터 갱신에 맞춰 매 3시간마다 자동 갱신됩니다.
중기 예보 (4일~10일): 하루 2번(오전 6시, 오후 6시) 자동 갱신됩니다.

※ 주의: 스마트폰 달력 앱(아이폰, 갤럭시 등) 자체의 동기화 주기에 따라 실제 반영은 약간 늦어질 수 있습니다.

📸 달력 적용 예시 (클릭하면 커집니다):