Open-Meteo API 스킬

전 세계 국가 기상청 데이터를 통합한 무료 오픈소스 날씨 API.

핵심 특징

무료 & API 키 불필요: 비상업적 사용 무료, 즉시 사용 가능
빠른 응답: 10ms 이하 응답 시간
다양한 데이터: 16일 예보, 80년 역사 데이터, 대기질, 해양 날씨
라이선스: 데이터 CC BY 4.0, 코드 AGPLv3

기본 API 호출

# 날씨 예보 (서울)
curl "https://api.open-meteo.com/v1/forecast?latitude=37.5665&longitude=126.9780&hourly=temperature_2m,precipitation&daily=temperature_2m_max,temperature_2m_min&timezone=Asia/Seoul"

주요 엔드포인트

| 엔드포인트 | URL | 용도 | |-----------|-----|------| | Forecast | api.open-meteo.com/v1/forecast | 날씨 예보 | | Archive | archive-api.open-meteo.com/v1/archive | 과거 데이터 | | Air Quality | air-quality-api.open-meteo.com/v1/air-quality | 대기질 | | Marine | marine-api.open-meteo.com/v1/marine | 해양 날씨 | | Geocoding | geocoding-api.open-meteo.com/v1/search | 위치 검색 | | Elevation | api.open-meteo.com/v1/elevation | 고도 조회 |

필수 파라미터

latitude: 위도 (-90 ~ 90)
longitude: 경도 (-180 ~ 180)

상세 문서

API 상세 명세: references/api-spec.md
MCP 서버 가이드: references/mcp-guide.md
날씨 변수 목록: references/weather-variables.md
Flutter 날씨 구현 가이드: references/flutter-weather-guide.md

Flutter 날씨 구현 가이드 → flutter-weather-guide.md

Flutter 앱에서 Open-Meteo API를 활용한 날씨 기능 구현 전체 가이드를 다룹니다. 시간대별 날씨 표시 기법(오늘은 2시간 단위, 내일~7일은 4시간 단위로 필터링하는 getTodayWeather(), getDayWeather() 메서드)과 캐시 기반 실시간 날씨 아이콘 표시 (FutureBuilder 패턴으로 WeatherService.getCurrentWeather()를 호출하여 홈 화면 퀵메뉴에 동적 아이콘 표시)를 상세히 설명합니다. WMO 날씨 코드를 Flutter Icons로 매핑하는 로직, 낮/밤 판단(isDay getter), 아이콘 색상 매핑, 30분 FileCache 설정, API 파라미터 구성 등 실제 구현에 필요한 핵심 코드와 체크리스트를 포함합니다.

테스트 스크립트

# 테스트 실행
./scripts/test-forecast.sh          # 날씨 예보 테스트
./scripts/test-air-quality.sh       # 대기질 테스트
./scripts/test-geocoding.sh         # 지오코딩 테스트
./scripts/test-all.sh               # 전체 테스트

open-meteo-skill