[Kakao 주소] 위,경도 좌표로 주소 얻기

회사에서 위,경도 좌표를 가지고 주소를 얻어내는 API를 개발할 일이 생겼습니다. 주소를 얻는 방법은 여러가지가 있겠지만 이번에는 Kakao 주소 API를 활용해 보려고 합니다.

 

https://developers.kakao.com/docs/latest/ko/local/dev-guide#coord-to-district

Kakao Developers

 

1. 카카오 developer 사이트에 접속해서 애플리케이션을 만들고 앱 키 중 RESTful API 키를 복사해둡니다.

 

2. 아래와 같이 코드를 작성합니다.

@Service
public class AddressSearchByKakaoService {

    @Value("${kakao.api-url}")
    private String apiUrl;  // https://dapi.kakao.com/v2/local/geo/coord2regioncode.json

    @Value("${kakao.api-key}")
    private String apikey;  // 1에서 복사한 key 값

    public String findByLatLon(String lat, String lon) {
        try {
            return makeAddress(coordToAddr(lat, lon));
        } catch (Exception e) {
            throw new BusinessException("해당 위치의 주소를 찾을 수 없습니다.", StatusCodeConstants.RESULT_NOT_FOUND);
        }
    }

    private String coordToAddr(String lat, String lon) throws Exception {
        StringBuilder jsonString = new StringBuilder();
        String buf;

        String query = "?x=" + lon + "&y=" + lat;
        URL url = new URL(apiUrl + query);
        HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
        String auth = "KakaoAK " + apikey;
        conn.setRequestMethod("GET");
        conn.setRequestProperty("X-Requested-With", "curl");
        conn.setRequestProperty("Authorization", auth);

        BufferedReader br = new BufferedReader(new InputStreamReader(
                conn.getInputStream(), StandardCharsets.UTF_8));

        while ((buf = br.readLine()) != null) {
            jsonString.append(buf);
        }

        return jsonString.toString();
    }

    private String makeAddress(String jsonString) {
        StringBuffer buffer = new StringBuffer();

        JSONObject jObj = (JSONObject) JSONValue.parse(jsonString);
        JSONObject meta = (JSONObject) jObj.get("meta");
        long size = (long) meta.get("total_count");
        if (size > 0) {
            JSONArray jArray = (JSONArray) jObj.get("documents");
            JSONObject subJobj = (JSONObject) jArray.get(0);

            buffer.append((String) subJobj.get("region_1depth_name"))
                    .append(" ")
                    .append((String) subJobj.get("region_2depth_name"));

            if (StringUtils.isEmpty(subJobj.get("region_2depth_name"))) {
                buffer.append((String) subJobj.get("region_3depth_name"));
            }
        }

        return buffer.toString();  // "시도 + 시군구" 데이터를 한 문자열로 반환
    }
}

---

카카오 API에 요청을 하면 처음 오게되는 응답은 다음과 같습니다.

{
    "meta": {
        "total_count": 2
    },
    "documents": [
        {
            "region_type": "B",
            "code": "4128510400",
            "address_name": "경기도 고양시 일산동구 장항동",
            "region_1depth_name": "경기도",
            "region_2depth_name": "고양시 일산동구",
            "region_3depth_name": "장항동",
            "region_4depth_name": "",
            "x": 126.77029180295048,
            "y": 37.6417649098674
        },
        {
            "region_type": "H",
            "code": "4128559000",
            "address_name": "경기도 고양시 일산동구 장항2동",
            "region_1depth_name": "경기도",
            "region_2depth_name": "고양시 일산동구",
            "region_3depth_name": "장항2동",
            "region_4depth_name": "",
            "x": 126.77833476308646,
            "y": 37.64993598532597
        }
    ]
}

 

이 중 필요한 내용만 다시 추출하여 응답 문자열로 변경하여 제공하였습니다.

 

참고

• https://aljjabaegi.tistory.com/418
• https://developerjal.tistory.com/entry/Java-Kakao-map-%EC%B9%B4%EC%B9%B4%EC%98%A4%EB%A7%B5-%EB%A1%9C%EC%BB%AC-API-%EC%A2%8C%ED%91%9C%EA%B2%BD%EB%8F%84-%EC%9C%84%EB%8F%84%EB%A1%9C-%EC%A3%BC%EC%86%8C-%EB%B3%80%ED%99%98%ED%95%98%EA%B8%B0REST-API