📌 [SpringBoot] 공공데이터포털 XML API 연동 실습 - 실시간 버스 정보

📅 2025-05-12

---

✅ 실습 개요

• 실시간 버스 도착정보 OpenAPI(XML)를 Spring Boot에서 호출
• JAXB로 XML을 Java 객체로 자동 변환
• RestTemplate을 이용한 외부 API 통신
• JSON 출력 및 콘솔 출력 방식 실습
• 향후 CSV 연계 및 DB 저장 확장 가능

---

✅ 실습 순서 요약

단계	설명
1️⃣	프로젝트 생성 (Web + JAXB + Lombok 포함)
2️⃣	API 키 발급 (공공데이터포털)
3️⃣	XML 구조 분석
4️⃣	Java 클래스 (JAXB) 작성
5️⃣	컨트롤러 구성 및 요청 수행
6️⃣	응답 결과 콘솔 출력 / JSON 반환
7️⃣	예외 처리 및 향후 확장 설명 포함

---

✅ 사용 API 정보

• 서비스: 대구광역시 실시간 버스 도착정보
• 호출 URL:

https://apis.data.go.kr/6270000/dbmsapi01/getRealtime
?serviceKey=발급받은키
&bsId=7001001600
&routeNo=649

• 📌 예시 입력값:
  • routeNo = 649 → 서부정류장 방면
  • bsId = 7001001600 → 대구고등학교건너 정류장

---

✅ 1. 의존성 설정 (build.gradle)

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:4.0.0'
    implementation 'org.glassfish.jaxb:jaxb-runtime:4.0.2'
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
}

---

✅ 2. XML 응답 매핑 클래스 (BUSResult.java)

@XmlRootElement(name = "Result")
@Data
@XmlAccessorType(XmlAccessType.FIELD)
public class BUSResult {

    private Header header;
    private Body body;

    @Data
    public static class Header {
        private boolean success;
        private String resultCode;
        private String resultMsg;
    }

    @Data
    public static class Body {
        private Items items;
        private int totalCount;
    }

    @Data
    public static class Items {
        private String routeNo;

        @XmlElementWrapper(name = "arrList")
        @XmlElement(name = "arrList")
        private List<ArrList> arrList;
    }

    @Data
    public static class ArrList {
        private String routeId;
        private String routeNo;
        private int moveDir;
        private int bsGap;
        private String bsNm;
        private String vhcNo2;
        private String busTCd2;
        private String busTCd3;
        private String busAreaCd;
        private String arrState;
        private int prevBsGap;
    }
}

---

✅ 3. 실시간 버스 정보 컨트롤러 (OpenData03Controller.java)

@RestController
@Slf4j
@RequestMapping("/openData")
public class OpenData03Controller {

    // 실시간 버스 도착정보 콘솔 출력
    @GetMapping("/bus/realtime")
    public void bus_realtime() throws UnsupportedEncodingException {
        try {
            BUSResult result = fetchBusData();
            if (result != null) {
                // 콘솔에 정류소 도착 정보 출력
                result.getBody().getItems().getArrList().forEach(bus -> {
                    System.out.println("정류장명: " + bus.getBsNm());
                    System.out.println("도착예정: " + bus.getArrState());
                    System.out.println("차량번호: " + bus.getVhcNo2());
                    System.out.println("--------------------------");
                });
            } else {
                log.warn("응답 본문이 null입니다.");
            }
        } catch (Exception e) {
            log.error("실시간 버스 API 호출 실패", e);
        }
    }

    // JSON API로 응답 반환
    @GetMapping("/bus/json")
    public ResponseEntity<BUSResult> bus_json() throws UnsupportedEncodingException {
        try {
            BUSResult result = fetchBusData();
            return ResponseEntity.ok(result);
        } catch (Exception e) {
            return ResponseEntity.internalServerError().build();
        }
    }

    // 공통 호출 로직 분리
    private BUSResult fetchBusData() throws UnsupportedEncodingException {
        String url = "https://apis.data.go.kr/6270000/dbmsapi01/getRealtime";
        String serviceKey = "발급받은 디코딩 키";
        String bsId = "7001001600";
        String routeNo = "649";

        URI uri = UriComponentsBuilder
                .fromHttpUrl(url)
                .queryParam("serviceKey", URLEncoder.encode(serviceKey, "UTF-8"))
                .queryParam("bsId", bsId)
                .queryParam("routeNo", routeNo)
                .build(true)
                .toUri();

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

---

✅ 4. 실행 결과 예시

호출 주소

http://localhost:8090/openData/bus/realtime

콘솔 출력 결과

정류장명: 대구고등학교건너
도착예정: 7분
차량번호: 5266
--------------------------
정류장명: 서부정류장(관문시장앞)
도착예정: 18분
차량번호: 5214
--------------------------

JSON API 호출 예시

http://localhost:8090/openData/bus/json

---

✅ 5. 향후 확장 아이디어

확장 방향	설명
✅ 화면 출력	Thymeleaf, React 연동으로 리스트 UI 구성
✅ DB 저장	JPA를 이용해 정류소 도착 정보 영속화
✅ CSV 연계	공공데이터 포털에서 다운받은 노선/정류소 위치 CSV 파일과 연계하여 기준 데이터 활용
✅ 자동화	일정 간격으로 도착정보 갱신하여 모니터링 시스템 구축

---

🔗 참고 자료

• 공공데이터포털 버스 API
• JAXB 공식 문서
• Spring Boot Docs

---