[SCRUM-293] 대한민국 판별 API 구현 (#140)

[moonxxpower]

✏️ 연관 이슈

#140

⛳ 작업 내용

• 카카오 지도 좌표로 행정구역정보 변환 API 연동
• 바운딩 박스 방식으로 필터링
• 필터링 통과한 것만 카카오 지도 API 호출
• 관련 테스트 코드 작성

💬리뷰 요구사항

• 좌표를 주소를 변환하는 API는 주소가 등록된 일부 지역에 한함으로 행정구역으로 구분해 주소가 등록되지 않는 지역에 대해서도 결과값을 도출하는 행정구역 정보 반환 API를 새로 연동했습니다. 추후 해당 API로 수정해도 좋을 것 같은데, 어떻게 생각하시나요?
• 총 2개(성공 2개)의 테스트 코드를 작성했습니다.

📍 참고사항

• 해당 API의 경우, 중국, 일본, 북한 등 우리나라와 맞닿아 있는 곳에 한해 address_name으로 제공합니다.

{
    "meta": {
        "total_count": 2
    },
    "documents": [
        {
            "region_type": "B",
            "code": "90004",
            "address_name": "중국",
            "region_1depth_name": "",
            "region_2depth_name": "",
            "region_3depth_name": "",
            "region_4depth_name": "",
            "x": 118.93423891258752,
            "y": 42.3401103392924
        },
        {
            "region_type": "H",
            "code": "90004",
            "address_name": "중국",
            "region_1depth_name": "",
            "region_2depth_name": "",
            "region_3depth_name": "",
            "region_4depth_name": "",
            "x": 118.93423891258752,
            "y": 42.3401103392924
        }
    ]
}

• 너무 먼 곳일 경우 아래와 같이 에러 메세지를 반환합니다. (예시로 러시아를 호출해보았을 떄)

{
    "code": -2,
    "msg": "The input parameter value is not in the service area"
}

• 행정구역으로 구분함으로 주소 등록되지 않은 지역에 대해서도 해당 행정구역 확인 가능합니다. 해당 응답은 좌표에서 주소 변환하기 API를 호출했을 때 결과값이 나오지 않은 좌표입니다.

{
    "meta": {
        "total_count": 2
    },
    "documents": [
        {
            "region_type": "B",
            "code": "2650010300",
            "address_name": "부산광역시 수영구 민락동",
            "region_1depth_name": "부산광역시",
            "region_2depth_name": "수영구",
            "region_3depth_name": "민락동",
            "region_4depth_name": "",
            "x": 129.1254459421262,
            "y": 35.15726484072749
        },
        {
            "region_type": "H",
            "code": "2650080000",
            "address_name": "부산광역시 수영구 민락동",
            "region_1depth_name": "부산광역시",
            "region_2depth_name": "수영구",
            "region_3depth_name": "민락동",
            "region_4depth_name": "",
            "x": 129.1254459421262,
            "y": 35.15726484072749
        }
    ]
}

[ssggii]

고생하셨습니다! 코멘트 확인 부탁드립니다😃

[ssggii]

좌표를 주소를 변환하는 API는 주소가 등록된 일부 지역에 한함으로 행정구역으로 구분해 주소가 등록되지 않는 지역에 대해서도 결과값을 도출하는 행정구역 정보 반환 API를 새로 연동했습니다. 추후 해당 API로 수정해도 좋을 것 같은데, 어떻게 생각하시나요?

getAddressFromCoordinate에서 사용되고 있는 좌표로 주소 변환 API를 행정구역 변환 API로 교체하자는 말씀이실까요?

[moonxxpower]

넵! 정확도가 행정구역 분리 API가 더 높은 것 같아 건의드렸습니다:) 사실 코스 지역, 테마 판별 로직이 추후에 수정될 수 있을거 같아서 그때 수정해도 될 거 같습니다!