🌸 Cherry Blossom Korea (벚꽃 코리아)

2026 BuildWithAI & HelloWorld에서 사용되었던 간단한 Flutter 벚꽃 앱입니다. 벚꽃 시즌을 맞이하여 지도, 음악, 날씨 정보를 한눈에 확인할 수 있습니다.

🚀 시작하기 (Getting Started)

원활한 앱 실행을 위해 여러 외부 API 키들이 필요합니다. 프로젝트 루트에 dartdefine.json 파일을 생성하고 아래와 같이 키를 설정해주세요.

🔑 필수 API 키 (dartdefine.json 파일 구성)

{
  "MAP_API_KEY": "YOUR_GOOGLE_MAPS_API_KEY",
  "SPOTIFY_CLIENT_ID": "YOUR_SPOTIFY_CLIENT_ID",
  "SPOTIFY_CLIENT_SECRET": "YOUR_SPOTIFY_CLIENT_SECRET",
  "KMA_API_AUTH_KEY": "YOUR_KMA_API_KEY",
  "TOUR_API_KEY": "YOUR_TOUR_API_KEY"
}

💻 실행 명령어

설정한 환경 변수 파일을 통해 한 번에 적용하여 앱을 실행합니다.

flutter run --dart-define-from-file=dartdefine.json

📡 데이터 소스 (Data Sources)

앱에서 실시간으로 제공받는 데이터의 출처입니다:

• 🎵 음악 추천: Spotify Search API
• 🌤️ 날씨 (온습도/자외선/대기질): Open-Meteo API
• 🗺️ 벚꽃 축제 및 명소: 한국관광공사 TourAPI (locationBasedList2)
• 📍 지도 서비스: Google Maps (google_maps_flutter)