카카오맵 API(Kakao Map API)는 지도 회사가 열어 둔 지도 대여 창구 같은 것 — 내 사이트나 앱에 카카오 지도를 띄우고 장소 검색 결과를 가져올 수 있게 해 주는 연결 통로예요.
지도를 직접 그리려면 모든 길과 가게 정보를 모아야 해서 엄청난 일이죠. 대신 지도 회사가 우리 지도를 이 창구로 빌려 쓰라고 열어 둔 게 지도 API예요. 카카오맵 API를 쓰면 내 사이트에 지도를 띄우고, 위치에 핀을 꽂거나, 강남 카페처럼 장소를 검색해 이름·주소·좌표를 받아 올 수 있어요. 카카오 디벨로퍼스에서 앱을 만들고 키를 발급받아 연결해요.
강의에서는 풀스택 에이전트로 가게 검색 기능이 있는 사이트를 만들 때 카카오맵 API와 네이버 지역 검색 API를 연결해 결과를 합쳐 보여 줘요. 연결 전에는 에이전트가 화면만 먼저 만들어 가짜 데이터가 보이고, 키를 연결하면 실제 가게 데이터가 나오는 흐름이에요. 내 사이트에 지도나 지역 검색을 넣으려면 개발자 사이트에서 앱 등록, 키 발급, 사용할 도메인 등록을 한 뒤 에이전트에게 키를 환경 변수로 넣어 달라고 하면 돼요.
초보가 자주 막히는 곳은 도메인 등록이에요. 지도 API는 허용한 사이트 주소에서만 동작하는 경우가 많아서, localhost에선 되는데 배포한 사이트에서 지도가 안 뜨면 등록한 도메인부터 확인하세요. 호출량 제한과 이용 조건도 있으니 공식 문서를 확인하고, 키는 코드에 직접 쓰지 말고 환경 변수에 두는 게 안전해요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.