키워드로 장소 검색 시 null값이나 빈 문자열이 응답으로 올 수 있나요?

문의 시, 사용하시는 개발환경과 디벨로퍼스 앱ID를 알려주세요.


개발환경: spring boot java 21
디벨로퍼스 앱ID : 1504820

안녕하세요 카카오 로컬 키워드로 장소 검색 시
query, category_group_code, x, y, radius 를 넣어 요청했을 때
documents 내부 필드(category_name, distance, road_address_name,url 등)에 빈문자열이나 null값이 응답으로 올 수 있나요?

안녕하세요,

  • 카테고리가 존재하는 경우 일반적으로 category_name 은 존재합니다.
  • 정상적인 x, y, radius 값이 입력되면 distance 계산이 가능하므로 해당 필드값이 존재합니다.
  • 장소에 따라 도로명주소가 존재하지 않고, 지번주소만 가진 경우가 있습니다. 따라서 road_address_name 은 비어있을 수 있습니다.
  • 카카오맵에 존재하는 장소를 제공하므로 place_url 값은 항상 존재합니다.

위 안내드린 내용은 정상 서비스 상황을 기준으로 말씀드린 것이라서
예외 상황은 발생할 수 있습니다.

따라서 해당 필드를 활용하여 서비스를 구현하시더라도 가급적 예외처리는 하시는 것을 권장드립니다.

감사합니다.

cc. @Maps