자료실
지도·위치APIofficial

Kakao Local API

주소·좌표·키워드 기반 장소 검색을 제공하는 Kakao 공식 로컬 API

자료 등록 2026년 6월 3일

한눈에 보기

공식 검증 2026년 8월 29일

프로토콜
REST · JSON
인증
Kakao REST API 키
비용
무료 쿼터 · 초과·제휴 조건 확인
제공 상태
정식 제공
공식 빠른 시작공식 빠른 시작 · https://developers.kakao.com/docs/ko/local/dev-guide

Use cases

이럴 때 이렇게 연결합니다

먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.

추천 구성 · Situation 01

상호명과 도로명 주소가 섞여 같은 장소를 중복 등록하거나 좌표를 잘못 붙이는 업무

어떤 어려움인가
국내 매장과 시설 위치를 정리하는 서비스팀이 자주 마주치는 문제입니다. 구체적으로는 '상호명과 도로명 주소가 섞여 같은 장소를 중복 등록하거나 좌표를 잘못 붙이는 업무' 상황입니다.
이렇게 해결합니다
Kakao Local API 단계에서는 요청과 응답 필드를 작은 범위로 맞춥니다. 입력 범위는 '키워드, 주소, 중심 좌표, 검색 반경'입니다. 필요한 필드만 골라 '장소 ID와 주소·좌표가 정규화된 후보 목록' 형태로 정리합니다.
왜 연결하는가
처음에는 Kakao Local API 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
마지막 확인
검토 대상은 '장소 ID와 주소·좌표가 정규화된 후보 목록'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
Sequence입력부터 검토 결과까지
  1. 01 · 입력작은 입력 범위키워드, 주소, 중심 좌표, 검색 반경
    업무 조건
  2. 02 · 현재 자료Kakao Local APIAPI 요청: 입력 범위는 '키워드, 주소, 중심 좌표, 검색 반경'입니다. 필요한 필드만 골라 '장소 ID와 주소·좌표가 정규화된 후보 목록' 형태로 정리합니다.
    처리 결과
  3. 03 · 사람 확인담당자 검토검토 대상은 '장소 ID와 주소·좌표가 정규화된 후보 목록'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.
    확인 완료
  4. 04 · 결과검토용 결과장소 ID와 주소·좌표가 정규화된 후보 목록

Result

이 흐름으로 남는 값

첫 요청

curl "https://dapi.kakao.com/v2/local/search/keyword.json?query=서울역" -H "Authorization: KakaoAK YOUR_KAKAO_REST_API_KEY"

무엇이고 왜 필요한가

Kakao Local API는 주소를 좌표로 바꾸고 좌표를 주소로 변환하며 키워드·카테고리 기반 장소를 검색하는 공식 위치 API입니다. 국내 주소와 장소를 지도 화면·상권 분석·방문 서비스의 내부 데이터에 연결할 때 사용합니다.

할 수 있는 일

  • 주소와 좌표를 상호 변환합니다.
  • 키워드·카테고리로 주변 장소를 검색합니다.

시작 전 확인

  • Kakao Developers 앱과 REST API 키를 준비합니다.
  • 인증·비용 조건은 Kakao REST API 키, 무료 쿼터 · 초과·제휴 조건 확인이며 제공 상태는 정식 제공입니다.
  • 첫 요청은 공식 샘플과 테스트 자격으로 실행해 정상 응답·오류·호출 제한을 함께 확인합니다.

잘 맞는 경우

  • 국내 매장 찾기, 지역 검색, 주소 정규화 기능을 만드는 팀.

주의점

  • 쿼터와 지도 표시·데이터 저장 정책을 확인하고 키의 허용 도메인을 제한합니다.
  • API 키는 브라우저 코드나 공개 예제에 넣지 않고 서버 비밀값으로 보관하며, 호출 실패·재시도·사용량을 기록합니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.

문의하기