📌 OpenWeatherMap을 활용한 날씨 정보 조회 API 구현

📅 2025-05-12

---

📝 학습 내용

✅ 1. OpenWeatherMap 가입 및 API Key 발급

• 사이트: https://home.openweathermap.org
• 로그인 후 API keys 메뉴에서 키 생성 가능

---

✅ 2. 실시간 날씨 조회 API 개요

• API Endpoint:

  https://api.openweathermap.org/data/2.5/weather
  

• 주요 파라미터:

  파라미터	설명
  lat	위도
  lon	경도
  appid	발급받은 API 키
  units	단위 (metric: 섭씨, standard: 켈빈)
  lang	언어 코드 (kr, en 등)

---

✅ 3. Spring Boot 구현 예시

✅ OpenWeatherController.java

package com.example.demo.C02OpenWeatherMap;

import lombok.extern.slf4j.Slf4j;
import org.springframework.http.HttpMethod;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.RestTemplate;
import org.springframework.web.util.UriComponentsBuilder;

import java.io.UnsupportedEncodingException;
import java.net.URI;
import java.net.URLEncoder;

@RestController
@Slf4j
@RequestMapping("/open/weather")
public class OpenWeatherController {

    @GetMapping("/get/{lat}/{lon}")
    public ResponseEntity<String> get(@PathVariable String lat, @PathVariable String lon) throws UnsupportedEncodingException {
        log.info("GET /open/weather/get...");

        String url = "https://api.openweathermap.org/data/2.5/weather";
        String serviceKey = "발급 받은 키";

        URI uri = UriComponentsBuilder
                .fromHttpUrl(url)
                .queryParam("appid", URLEncoder.encode(serviceKey, "UTF-8"))
                .queryParam("lat", lat)
                .queryParam("lon", lon)
                .queryParam("units", "metric") // 섭씨 설정
                .queryParam("lang", "kr") // 한글 응답 설정
                .build(true)
                .toUri();

        RestTemplate rt = new RestTemplate();
        ResponseEntity<String> response = rt.exchange(uri, HttpMethod.GET, null, String.class);
        return response;
    }
}

---

✅ 4. API 테스트 결과

📍 호출 URL:

http://localhost:8090/open/weather/get/35.8662861111111/128.608397222222

🔹 응답 예시 (요약):

{
  "name": "Daegu",
  "weather": [
    {
      "main": "Clear",
      "description": "clear sky",
      "icon": "01d"
    }
  ],
  "main": {
    "temp": 23.0,
    "feels_like": 22.2,
    "humidity": 35,
    "pressure": 1010
  },
  "wind": {
    "speed": 3.09,
    "deg": 270
  }
}

※ units=metric 설정 덕분에 온도는 섭씨(°C)로 변환되어 출력됨

※ lang=kr 설정으로 description에 한글 지원 가능

---

✅ 5. 주요 응답 필드 정리

JSON Key 경로	설명	예시 값
name	도시명	Daegu
weather[0].main	날씨 요약	Clear
weather[0].description	상세 설명	clear sky
main.temp	현재 온도 (°C)	23.0
main.feels_like	체감 온도	22.2
main.humidity	습도 (%)	35
wind.speed	풍속 (m/s)	3.09

---

🔥 정리

• OpenWeatherMap API는 단순한 설정으로 전 세계 날씨 데이터를 가져올 수 있는 강력한 도구
• RestTemplate을 활용하면 Spring Boot에서도 간편하게 연동 가능
• units=metric, lang=kr 파라미터 설정으로 섭씨 및 한글 처리까지 가능
• 다음 단계로는 DTO 매핑 및 화면 출력을 고려할 수 있음

---

🔗 참고 자료

• 🌐 OpenWeatherMap 공식 문서
• 🛠 JSON → Java 클래스 생성기

---