바이브코딩으로 지도 앱 만들기: 카카오 지도 키 받고 앱 주소 등록하기

바이브코딩으로 만든 BackendX 앱에 카카오 지도와 장소 검색을 연결하는 방법. 카카오 앱 만들기부터 키 두 개, 카카오맵 켜기, 많이들 놓치는 도메인 등록까지 화면과 함께 정리했어요.

바이브코딩으로 지도 앱 만들기: 카카오 지도 키 받고 앱 주소 등록하기

바이브코딩으로 BackendX에서 지도 앱을 만들 수 있어요. 키워드로 장소를 찾고, 결과를 지도에 핀으로 보여 주고, 마음에 드는 곳을 즐겨찾기에 담는 앱이요.

이번 글에서는 백엔드엑스로 실제로 만든 동네 장소 찾기 앱을 먼저 보여 드리고, 여기에 필요한 카카오 키 두 개를 받아 넣는 방법과 많이들 놓치는 도메인 등록까지 화면과 함께 따라가 볼게요.

✅
아래 화면은 디자인 시안이 아니에요. 백엔드엑스 채팅창에 말로 설명해서 만든 실제 앱을 배포해서 찍은 화면이에요. 화면, 서버, 장소 검색과 지도 연결까지 모두 백엔드엑스가 만들었어요.
카카오 지도에 검색 결과가 핀으로 표시된 동네 장소 찾기 앱
실제 앱 화면: “성수동 카페”를 검색하면 결과가 지도에 핀으로 나와요 (가게 이름과 전화번호는 가렸어요)

이 앱은 백엔드엑스 채팅창에 이렇게 말해서 시작했어요. "장소 검색과 지도는 카카오맵을 쓸게"라고 적으면, 백엔드엑스가 카카오맵으로 장소 검색과 지도 표시를 만들겠다고 확인해 줘요.

백엔드엑스 채팅창의 첫 대화
백엔드엑스 채팅창: 만들고 싶은 앱을 말로 설명하면 돼요

🔑 카카오 키는 두 개가 필요해요

카카오 지도를 쓰는 앱은 배포할 때 두 값을 넣게 돼요. 하는 일이 달라요.

  • KAKAO_CLIENT_ID ← 카카오의 REST API 키: 서버가 장소 검색을 할 때 써요. 서버에만 보관되고 화면에는 드러나지 않아요.
  • KAKAO_MAPS_JS_KEY ← 카카오의 JavaScript 키: 사용자의 브라우저가 지도를 그릴 때 써요. 이 키는 등록한 도메인에서만 작동해서, 앱 주소를 카카오에 등록해야 지도가 보여요.
💡
이름이 서로 달라서 헷갈리기 쉬워요. 카카오에서는 플랫폼 키라는 메뉴 아래에 키가 모여 있어요. REST API 키는 KAKAO_CLIENT_ID, JavaScript 키는 KAKAO_MAPS_JS_KEY 예요.

① 카카오 디벨로퍼스에서 앱 만들기

카카오 디벨로퍼스에 카카오 계정으로 로그인하고, 앱 메뉴에서 + 앱 생성을 눌러요.

카카오 디벨로퍼스 앱 목록
앱 목록: 오른쪽 위 + 앱 생성을 눌러요

앱 이름, 회사명, 카테고리를 채우고, 운영정책 확인란에 체크한 뒤 저장을 눌러요.

앱 생성 양식 위쪽
앱 생성: 앱 이름과 회사명을 넣어요
앱 생성 양식 아래쪽
카테고리를 고르고 운영정책 확인란에 체크해요
⚠️
앱 이름에 ‘카카오맵’, ‘카카오’ 같은 카카오의 상표는 넣을 수 없어요. 저장이 되지 않아요. 백엔드엑스 프로젝트 이름을 그대로 옮기면 걸릴 수 있으니, 앱 이름은 서비스 이름으로 지어 주세요.
만들어진 앱
앱이 만들어졌어요. 앱을 눌러 들어가요

② 키 두 개 복사하기

왼쪽 위 메뉴 → 앱 → 플랫폼 키로 들어가요.

플랫폼 키 메뉴
메뉴 → 앱 → 플랫폼 키

여기에 키가 카드로 나와 있어요. 각 카드의 복사 아이콘(⧉)을 눌러 복사해요.

  • REST API 키 (Default Rest API Key) → KAKAO_CLIENT_ID
  • JavaScript 키 (Default JS Key) → KAKAO_MAPS_JS_KEY
플랫폼 키 화면
플랫폼 키: REST API 키와 JavaScript 키를 복사해요 (이미지에서는 키를 가렸어요)
💡
네이티브 앱 키, 어드민 키, REST API 키 아래의 클라이언트 시크릿은 지도 앱에는 필요 없어요. 특히 어드민 키는 어디에도 넣지 마세요.

③ 카카오맵 사용 켜기

키만 있다고 끝이 아니에요. 지도와 장소 검색을 쓰려면 앱에서 카카오맵을 켜야 해요. 메뉴 → 제품 설정 → 카카오맵으로 들어가요.

카카오맵 메뉴
메뉴 → 제품 설정 → 카카오맵
카카오맵 사용 설정 OFF
사용 설정의 상태가 OFF 예요. 눌러서 켜요

켤 때 확인 창이 떠요. 내용을 꼭 읽어 주세요.

카카오맵 활성화 확인 창
카카오맵 활성화: 무료 쿼터는 처음 켠 앱에만 줘요
⚠️
카카오 계정 하나에서 카카오맵을 처음 켠 앱만 일간 무료 쿼터를 받아요. 나중에 바꿀 수 없어요. 연습용 앱 말고 실제로 쓸 앱에서 켜 주세요. 쿼터는 카카오 쿼터 안내에서 확인할 수 있어요.
카카오맵 사용 설정 ON
켜졌어요. 앱에 ‘카카오맵 무료 쿼터’ 표시가 붙어요

④ BackendX 앱에 키 넣고 배포하기

배포 단계에서 BackendX 가 필요한 값을 물어봐요. 카카오 칸에 복사한 키를 넣고 저장을 누른 뒤 배포를 이어 가요.

BackendX 배포 화면의 카카오 키 입력 칸
배포 화면: 카카오 칸에 키 두 개를 넣어요
키를 넣은 배포 화면
값은 가려져서 보여요. 저장을 눌러요
키 저장 완료
저장하면 초록색 체크가 붙어요. 다음을 눌러 배포를 이어 가요

배포가 끝나면 배포하기 화면의 서비스 주소에 앱 주소가 나와요. https://(영문과 숫자로 된 긴 문자열).app.pool1.backendx.cloud 모양이에요. 다음 단계에서 이 주소를 써요.

⑤ 앱 주소를 카카오에 등록하기 (가장 많이 놓쳐요)

JavaScript 키는 등록한 도메인에서만 지도를 그려요. 앱 주소를 등록하지 않으면 장소 검색은 되는데 지도만 안 나와요.

메뉴가 깊숙이 있어서 찾기 어려워요. 메뉴 → 앱 → 플랫폼 키 → JavaScript 키 카드의 Default JS Key(제목)를 누르면 JavaScript SDK 도메인 칸이 나와요.

비어 있는 JavaScript SDK 도메인
도메인을 등록하지 않으면 “JavaScript 키를 사용할 수 없습니다”라고 경고가 떠요

여기에 앱 주소를 넣고 페이지 아래 저장을 눌러요.

앱 주소를 넣은 JavaScript SDK 도메인
JavaScript SDK 도메인에 앱 주소를 넣어요 (이미지에서는 주소 일부를 가렸어요)
💡
도메인만 넣어요. https://(영문과 숫자로 된 긴 문자열).app.pool1.backendx.cloud 까지만 쓰고, 뒤에 /apps/… 같은 경로는 붙이지 않아요. 개인정보처리방침 주소(pool1.backendx.cloud/apps/…)는 앱 주소가 아니에요.

등록은 카카오 쪽 설정이라 다시 배포할 필요가 없어요. 앱 화면을 새로고침하면 지도가 나와요 🎉


🧯 이런 화면이 나오면

장소 검색은 되는데 지도만 안 나와요

  • 앱 주소를 JavaScript SDK 도메인에 등록하지 않았거나, 주소가 달라요. 브라우저 개발자 도구에는 domain mismatched 라고 나와요. ⑤를 다시 확인해 주세요.
  • KAKAO_MAPS_JS_KEY 에 JavaScript 키가 아닌 다른 키를 넣었는지 확인해 주세요.

장소 검색부터 안 돼요

  • KAKAO_CLIENT_ID 에 REST API 키를 넣었는지 확인해 주세요. JavaScript 키와 자리가 바뀌는 경우가 많아요.
  • ③의 카카오맵 사용 설정이 ON 인지 확인해 주세요.

키를 고쳤다면 배포하기 화면에서 값을 바꾸고 다시 배포해 주세요. 도메인 등록만 고쳤다면 다시 배포할 필요는 없어요.

🔒 키는 이렇게 다뤄 주세요

  • REST API 키는 서버에만 보관돼요. 채팅, 메일, 화면 코드나 저장소에 넣지 마세요.
  • JavaScript 키는 원래 웹 페이지에 드러나는 키예요. 그래서 등록한 도메인에서만 쓸 수 있게 막혀 있어요. 도메인 등록이 곧 이 키의 보안이에요.
  • 키가 드러났다면 카카오 디벨로퍼스에서 키를 새로 만들고, 배포하기 화면에 새 키를 넣어 주세요.

같은 키로 매장 찾기, 모임 장소 정하기, 동네 맛집 지도 같은 앱도 만들 수 있어요. 무엇을 만들지 백엔드엑스 채팅창에 말로 설명해 주세요 🙂