feat: add location description for mobility call

Author: jaehyyuun

src/main/java/backend/knowhow/domain/mobility/controller/MobilityController.java

@@ -18,7 +18,7 @@ public class MobilityController {
     @PostMapping("/call")
     public ApiResponse<MobilityResponse> call(@Valid @RequestBody MobilityRequest request) {
 
-        String phoneNumber = mobilityService.getPhoneNumber(request.lat(), request.lon(), request.mobilityType());
-        return ApiResponse.success(new MobilityResponse(phoneNumber));
+        MobilityResponse mobilityResponse = mobilityService.getCallTaxiInfo(request.lat(), request.lon(), request.mobilityType());
+        return ApiResponse.success(mobilityResponse);
     }
 }

src/main/java/backend/knowhow/domain/mobility/dto/MobilityResponse.java

@@ -1,6 +1,7 @@
 package backend.knowhow.domain.mobility.dto;
 
 public record MobilityResponse(
-        String phoneNumber
+        String phoneNumber,
+        String description
 ) {
 }

src/main/java/backend/knowhow/domain/mobility/dto/RegionInfo.java

@@ -0,0 +1,7 @@
+package backend.knowhow.domain.mobility.dto;
+
+public record RegionInfo(
+        String city,
+        String district,
+        String dong
+) {}

src/main/java/backend/knowhow/domain/mobility/service/MobilityService.java

@@ -2,6 +2,8 @@
 
 import backend.knowhow.domain.mobility.domain.MobilityType;
 import backend.knowhow.domain.mobility.domain.RegionAreaCode;
+import backend.knowhow.domain.mobility.dto.MobilityResponse;
+import backend.knowhow.domain.mobility.dto.RegionInfo;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 
@@ -11,19 +13,43 @@ public class MobilityService {
 
     private final ReverseGeoApiClient reverseGeoApiClient;
 
-    private static final String TAXI_UNITED_NUMBER = "1333";
+    private static final String TAXI_UNITED_NUMBER = "114";
     private static final String SUBSTITUTE_NUMBER = "1588-0000";
 
-    public String getPhoneNumber(double lat, double lon, MobilityType type) {
+    public MobilityResponse getCallTaxiInfo(double lat, double lon, MobilityType type) {
         if (type == MobilityType.SUBSTITUTE) {
-            return SUBSTITUTE_NUMBER;
+            return new MobilityResponse(
+                    SUBSTITUTE_NUMBER,
+                    "전국 어디서나 이용 가능한 대리운전 번호로 연결합니다."
+            );
         }
         // 지역 조회나 매핑 실패 시 전국 공통 번호(1333) 반환
-        String areaCode = reverseGeoApiClient.findRegionName(lat, lon)
-                .flatMap(RegionAreaCode::findCodeByName)
-                .orElse("");
+        RegionInfo region = reverseGeoApiClient.findRegionInfo(lat, lon).orElse(null);
+        String phoneNumber;
+        String description;
 
-        return areaCode + TAXI_UNITED_NUMBER;
+        if (region == null) {
+            phoneNumber = TAXI_UNITED_NUMBER;
+            description = "전국 어디서나 이용 가능한 콜택시 번호로 연결합니다.";
+        } else {
+            String areaCode = RegionAreaCode
+                    .findCodeByName(region.city())
+                    .orElse("");
 
+            phoneNumber = areaCode + TAXI_UNITED_NUMBER;
+
+            String locationText = region.city();
+            if (region.district() != null && !region.district().isBlank()) {
+                locationText += " " + region.district();
+            }
+            if (region.dong() != null && !region.dong().isBlank()) {
+                locationText += " " + region.dong();
+            }
+
+            description =
+                    locationText + "에서 부를 수 있는 콜택시 번호로 연결합니다.";
+        }
+
+        return new MobilityResponse(phoneNumber, description);
     }
 }

src/main/java/backend/knowhow/domain/mobility/service/ReverseGeoApiClient.java

@@ -1,5 +1,6 @@
 package backend.knowhow.domain.mobility.service;
 
+import backend.knowhow.domain.mobility.dto.RegionInfo;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Value;
@@ -31,7 +32,7 @@ public class ReverseGeoApiClient {
 
     private static final String NAVER_GEOCODE_URL = "https://maps.apigw.ntruss.com/map-reversegeocode/v2/gc";
 
-    public Optional<String> findRegionName(double lat, double lon) {
+    public Optional<RegionInfo> findRegionInfo(double lat, double lon) {
         HttpHeaders headers = new HttpHeaders();
         headers.set("X-NCP-APIGW-API-KEY-ID", clientId);
         headers.set("X-NCP-APIGW-API-KEY", clientSecret);
@@ -57,20 +58,24 @@ public Optional<String> findRegionName(double lat, double lon) {
             }
             Map<?, ?> firstResult = (Map<?, ?>) results.get(0);
             Map<?, ?> region = (Map<?, ?>) firstResult.get("region");
+
             if (region == null) {
                 return Optional.empty();
             }
 
             Map<?, ?> area1 = (Map<?, ?>) region.get("area1");
+            Map<?, ?> area2 = (Map<?, ?>) region.get("area2");
+            Map<?, ?> area3 = (Map<?, ?>) region.get("area3");
             if (area1 == null) {
                 return Optional.empty();
             }
-            Object name = area1.get("name");
-            if (!(name instanceof String) || ((String) name).isBlank()) {
-                return Optional.empty();
-            }
+            String city = area1 != null ? (String) area1.get("name") : null;
+            String district = area2 != null ? (String) area2.get("name") : null;
+            String dong = area3 != null ? (String) area3.get("name") : null;
+
+            if (city == null) return Optional.empty();
 
-            return Optional.of((String) name);
+            return Optional.of(new RegionInfo(city, district, dong));
 
         } catch (HttpClientErrorException e) {
             log.error("[NaverMapClient] HTTP Error: status={}, body={}, lat={}, lon={}",