[Work 45] 장소 검색/주변 장소/역지오코딩을 카카오 로컬 API로 연동했습니다.

WhereAreYou/WhereAreYou/Core/DI/Implementation/AppDIContainer+Register.swift

@@ -54,10 +54,19 @@ extension DIContainer {
         // 채팅
         register(ChatRepository.self) { MockChatRepository() }
 
+        // 네트워크
+        register(APIClient.self, instance: URLSessionAPIClient())
+
         // 장소 검색/조회
-        register(NearbyPlaceRepository.self) { MockNearbyPlaceRepository() }
-        register(PlaceSearchRepository.self) { MockPlaceSearchRepository() }
-        register(ReverseGeocodingRepository.self) { MockReverseGeocodingRepository() }
+        register(NearbyPlaceRepository.self) {
+            KakaoNearbyPlaceRepository(apiClient: self.resolve(APIClient.self))
+        }
+        register(PlaceSearchRepository.self) {
+            KakaoPlaceSearchRepository(apiClient: self.resolve(APIClient.self))
+        }
+        register(ReverseGeocodingRepository.self) {
+            KakaoReverseGeocodingRepository(apiClient: self.resolve(APIClient.self))
+        }
         register(SharedPlaceRepository.self) { MockSharedPlaceRepository() }
 
         // 길찾기

WhereAreYou/WhereAreYou/Core/DI/Implementation/ScreenFactory+Chat.swift

@@ -18,6 +18,13 @@ extension ScreenFactory {
             getCurrentLocationUseCase: GetCurrentLocationUseCase(
                 repository: container.resolve(LocationRepository.self)
             ),
+            getCurrentLocationPlaceUseCase: GetCurrentLocationPlaceUseCase(
+                locationRepository: container.resolve(LocationRepository.self),
+                getNearbyPlaceUseCase: GetNearbyPlaceUseCase(
+                    nearbyPlaceRepository: container.resolve(NearbyPlaceRepository.self),
+                    reverseGeocodingRepository: container.resolve(ReverseGeocodingRepository.self)
+                )
+            ),
             shareLocationUseCase: ShareLocationUseCase(repository: chatRepository),
             sharePlaceUseCase: SharePlaceUseCase(
                 chatRepository: chatRepository,

WhereAreYou/WhereAreYou/Core/DI/Implementation/ScreenFactory+RouteSearch.swift

@@ -12,8 +12,12 @@ extension ScreenFactory {
             searchRoutesUseCase: SearchRoutesUseCase(
                 repository: container.resolve(RouteSearchRepository.self)
             ),
-            getCurrentLocationUseCase: GetCurrentLocationUseCase(
-                repository: container.resolve(LocationRepository.self)
+            getCurrentLocationPlaceUseCase: GetCurrentLocationPlaceUseCase(
+                locationRepository: container.resolve(LocationRepository.self),
+                getNearbyPlaceUseCase: GetNearbyPlaceUseCase(
+                    nearbyPlaceRepository: container.resolve(NearbyPlaceRepository.self),
+                    reverseGeocodingRepository: container.resolve(ReverseGeocodingRepository.self)
+                )
             )
         )
         return RouteSearchViewController(viewModel: viewModel, departure: departure, destination: destination)

WhereAreYou/WhereAreYou/Core/Info.plist

@@ -4,6 +4,8 @@
 <dict>
 	<key>NMFClientId</key>
 	<string>$(NMF_CLIENT_ID)</string>
+	<key>KakaoRestAPIKey</key>
+	<string>$(KAKAO_REST_API_KEY)</string>
 	<key>UIApplicationSceneManifest</key>
 	<dict>
 		<key>UIApplicationSupportsMultipleScenes</key>

WhereAreYou/WhereAreYou/Data/CoreLocationRepository.swift

@@ -29,6 +29,8 @@ final class CoreLocationRepository: NSObject, LocationRepository {
     }
 
     func getCurrentLocation(completion: @escaping (Result<Coordinate, Error>) -> Void) {
+        // 이전 요청이 끝나기 전 재호출 시 이전 completion을 실패로 마무리 (async 변환 시 continuation 누수 방지)
+        self.completion?(.failure(LocationError.unableToFetch))
         self.completion = completion
 
         switch locationManager.authorizationStatus {

WhereAreYou/WhereAreYou/Data/KakaoNearbyPlaceRepository.swift

@@ -0,0 +1,102 @@
+//
+//  KakaoNearbyPlaceRepository.swift
+//  WhereAreYou
+//
+//  Created by 김성훈 on 9/29/26.
+//
+
+import Foundation
+
+/// 좌표 반경 내 가장 가까운 장소 1개 조회 (지도 장소 선택, 현재 위치 표시용, 키워드 검색과 무관)
+/// 카테고리 검색이 요청당 카테고리 1개만 지원해, 서비스가 다루는 카테고리를 병렬 요청 후 가장 가까운 결과 선택
+/// 지도 이동 1회당 카테고리 수만큼 호출 발생 — PlaceSelectionViewModel의 디바운스/최소 이동 거리로 호출량 제한
+final class KakaoNearbyPlaceRepository: NearbyPlaceRepository {
+
+    /// 카카오 API가 허용하는 최대 반경(m)
+    private static let maximumRadiusMeters = 20000
+
+    /// 조회 대상 카테고리 — 검색 화면 필터와 무관, PlaceType 매핑 대상만 포함
+    private static let categoryCodes: [KakaoCategoryGroupCode] = [
+        .subwayStation, .restaurant, .cafe, .hospital, .largeMart, .convenienceStore
+    ]
+
+    private let apiClient: APIClient
+
+    init(apiClient: APIClient) {
+        self.apiClient = apiClient
+    }
+
+    /// 카테고리 하나 조회 결과 — 결과 없음(정상)과 요청 실패를 구분해 상위에서 정책을 결정할 수 있게 함
+    private enum CategoryResult {
+        case found(Place, distanceMeters: Double)
+        case notFound
+        case failed(Error)
+    }
+
+    func fetchNearbyPlace(coordinate: Coordinate, radiusKm: Double) async throws -> Place? {
+        let radiusMeters = min(Int(radiusKm * 1000), Self.maximumRadiusMeters)
+
+        let results = try await withThrowingTaskGroup(of: CategoryResult.self) { group in
+            for code in Self.categoryCodes {
+                group.addTask {
+                    try await self.nearestDocument(code: code, coordinate: coordinate, radiusMeters: radiusMeters)
+                }
+            }
+            var collected: [CategoryResult] = []
+            for try await result in group {
+                collected.append(result)
+            }
+            return collected
+        }
+
+        // 카테고리 중 하나라도 성공(결과 유무 무관)했으면 그 결과로 판단.
+        // 전부 요청 실패였을 때만 대표로 첫 실패를 throw — 상위(GetNearbyPlaceUseCase)가 역지오코딩 폴백 여부를 판단할 신호로 사용
+        var best: (place: Place, distance: Double)?
+        var firstFailure: Error?
+        var hasSucceeded = false
+
+        for result in results {
+            switch result {
+            case .found(let place, let distance):
+                hasSucceeded = true
+                if best == nil || distance < best!.distance {
+                    best = (place, distance)
+                }
+            case .notFound:
+                hasSucceeded = true
+            case .failed(let error):
+                if firstFailure == nil { firstFailure = error }
+            }
+        }
+
+        if !hasSucceeded, let firstFailure {
+            throw firstFailure
+        }
+        return best?.place
+    }
+
+    // MARK: - Private
+
+    /// 카테고리 하나를 조회해 결과 유무/실패를 구분해 반환. 취소는 흡수하지 않고 그대로 다시 throw
+    private func nearestDocument(
+        code: KakaoCategoryGroupCode,
+        coordinate: Coordinate,
+        radiusMeters: Int
+    ) async throws -> CategoryResult {
+        do {
+            let response: KakaoPlaceResponse = try await apiClient.request(
+                KakaoLocalEndpoint.category(code: code, coordinate: coordinate, radiusMeters: radiusMeters)
+            )
+            guard let document = response.documents.first,
+                  let place = document.toPlace(),
+                  let distance = document.distanceMeters else {
+                return .notFound
+            }
+            return .found(place, distanceMeters: distance)
+        } catch is CancellationError {
+            throw CancellationError()
+        } catch {
+            return .failed(error)
+        }
+    }
+}

WhereAreYou/WhereAreYou/Data/KakaoPlaceSearchRepository.swift

@@ -0,0 +1,25 @@
+//
+//  KakaoPlaceSearchRepository.swift
+//  WhereAreYou
+//
+//  Created by 김성훈 on 9/29/26.
+//
+
+import Foundation
+
+/// 카카오 로컬 API 기반 키워드 장소 검색
+final class KakaoPlaceSearchRepository: PlaceSearchRepository {
+
+    private let apiClient: APIClient
+
+    init(apiClient: APIClient) {
+        self.apiClient = apiClient
+    }
+
+    func searchPlaces(keyword: String) async throws -> [Place] {
+        let response: KakaoPlaceResponse = try await apiClient.request(
+            KakaoLocalEndpoint.keyword(query: keyword)
+        )
+        return response.documents.compactMap { $0.toPlace() }
+    }
+}

WhereAreYou/WhereAreYou/Data/KakaoReverseGeocodingRepository.swift

@@ -0,0 +1,29 @@
+//
+//  KakaoReverseGeocodingRepository.swift
+//  WhereAreYou
+//
+//  Created by 김성훈 on 9/29/26.
+//
+
+import Foundation
+
+/// 카카오 로컬 API 기반 역지오코딩
+final class KakaoReverseGeocodingRepository: ReverseGeocodingRepository {
+
+    private let apiClient: APIClient
+
+    init(apiClient: APIClient) {
+        self.apiClient = apiClient
+    }
+
+    func reverseGeocode(coordinate: Coordinate) async throws -> Place {
+        do {
+            let response: KakaoAddressResponse = try await apiClient.request(
+                KakaoLocalEndpoint.coord2address(coordinate: coordinate)
+            )
+            return try response.toPlace(coordinate: coordinate)
+        } catch let error as NetworkError {
+            throw error.appError
+        }
+    }
+}

WhereAreYou/WhereAreYou/Data/MockNearbyPlaceRepository.swift

@@ -9,18 +9,13 @@ import Foundation
 
 final class MockNearbyPlaceRepository: NearbyPlaceRepository {
 
-    func fetchNearbyPlace(
-        coordinate: Coordinate,
-        radiusKm: Double,
-        completion: @escaping (Result<Place?, Error>) -> Void
-    ) {
+    func fetchNearbyPlace(coordinate: Coordinate, radiusKm: Double) async throws -> Place? {
         let nearest = Self.mockPlaces
             .filter { $0.coordinate.distance(to: coordinate) <= radiusKm }
             .min { $0.coordinate.distance(to: coordinate) < $1.coordinate.distance(to: coordinate) }
 
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
-            completion(.success(nearest))
-        }
+        try await Task.sleep(for: .milliseconds(300))
+        return nearest
     }
 
     private static let mockPlaces: [Place] = [

WhereAreYou/WhereAreYou/Data/MockPlaceSearchRepository.swift

@@ -9,22 +9,10 @@ import Foundation
 
 final class MockPlaceSearchRepository: PlaceSearchRepository {
 
-    func searchPlaces(
-        keyword: String,
-        completion: @escaping (Result<[Place], Error>) -> Void
-    ) {
+    func searchPlaces(keyword: String) async throws -> [Place] {
         let trimmed = keyword.trimmingCharacters(in: .whitespaces)
-        let results: [Place]
-
-        if trimmed.isEmpty {
-            results = []
-        } else {
-            results = Self.mockPlaces
-        }
-
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
-            completion(.success(results))
-        }
+        try await Task.sleep(for: .milliseconds(300))
+        return trimmed.isEmpty ? [] : Self.mockPlaces
     }
 
     private static let mockPlaces: [Place] = [

WhereAreYou/WhereAreYou/Data/MockReverseGeocodingRepository.swift

@@ -9,10 +9,7 @@ import Foundation
 
 final class MockReverseGeocodingRepository: ReverseGeocodingRepository {
 
-    func reverseGeocode(
-        coordinate: Coordinate,
-        completion: @escaping (Result<Place, Error>) -> Void
-    ) {
+    func reverseGeocode(coordinate: Coordinate) async throws -> Place {
         let (roadName, fullAddress) = Self.mockAddress(near: coordinate)
         let place = Place(
             id: "address_\(coordinate.latitude)_\(coordinate.longitude)",
@@ -22,9 +19,8 @@ final class MockReverseGeocodingRepository: ReverseGeocodingRepository {
             type: .other
         )
 
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
-            completion(.success(place))
-        }
+        try await Task.sleep(for: .milliseconds(300))
+        return place
     }
 
     /// 실제 API의 도로명주소 응답 형태를 흉내낸 더미 주소 생성

WhereAreYou/WhereAreYou/Data/Network/APIClient.swift

@@ -0,0 +1,61 @@
+//
+//  APIClient.swift
+//  WhereAreYou
+//
+//  Created by 김성훈 on 9/29/26.
+//
+
+import Foundation
+
+/// Endpoint 기반 네트워크 요청 실행기
+protocol APIClient {
+    func request<T: Decodable>(_ endpoint: Endpoint) async throws -> T
+}
+
+/// URLSession 기반 APIClient 구현
+final class URLSessionAPIClient: APIClient {
+
+    private let session: URLSession
+    private let decoder: JSONDecoder
+
+    init(session: URLSession = .shared, decoder: JSONDecoder = JSONDecoder()) {
+        self.session = session
+        self.decoder = decoder
+    }
+
+    func request<T: Decodable>(_ endpoint: Endpoint) async throws -> T {
+        let urlRequest: URLRequest
+        do {
+            urlRequest = try endpoint.makeURLRequest()
+        } catch {
+            throw (error as? NetworkError ?? .invalidURL).appError
+        }
+
+        let data: Data
+        let response: URLResponse
+        do {
+            (data, response) = try await session.data(for: urlRequest)
+        } catch {
+            throw NetworkError.transport(error).appError
+        }
+
+        return try decode(data: data, response: response)
+    }
+
+    // MARK: - Private
+
+    /// 응답 검증 및 디코딩
+    private func decode<T: Decodable>(data: Data, response: URLResponse) throws -> T {
+        guard let httpResponse = response as? HTTPURLResponse else {
+            throw NetworkError.invalidResponse.appError
+        }
+        guard (200..<300).contains(httpResponse.statusCode) else {
+            throw NetworkError.httpStatus(httpResponse.statusCode).appError
+        }
+        do {
+            return try decoder.decode(T.self, from: data)
+        } catch {
+            throw NetworkError.decoding(error).appError
+        }
+    }
+}

WhereAreYou/WhereAreYou/Data/Network/APIKey.swift

@@ -0,0 +1,31 @@
+//
+//  APIKey.swift
+//  WhereAreYou
+//
+//  Created by 김성훈 on 9/29/26.
+//
+
+import Foundation
+
+/// Info.plist에 등록된 외부 API 키를 한 곳에서 읽어오기 위한 타입
+enum APIKey {
+
+    /// 카카오 로컬 API 호출에 사용하는 REST API 키
+    static var kakaoRestAPIKey: String {
+        value(forInfoDictionaryKey: "KakaoRestAPIKey")
+    }
+
+    // MARK: - Private
+
+    /// Info.plist에서 키 값을 조회
+    /// Config.xcconfig에 키가 설정되지 않았을 때 assertionFailure로 알림
+    private static func value(forInfoDictionaryKey key: String) -> String {
+        guard let value = Bundle.main.object(forInfoDictionaryKey: key) as? String,
+              !value.isEmpty,
+              !value.hasPrefix("$(") else {
+            assertionFailure("Info.plist에 \(key) 값이 설정되어 있지 않습니다. Config.xcconfig를 확인하세요.")
+            return ""
+        }
+        return value
+    }
+}