‘가까운 매장’을 묻는 전화가 CS로 올 때
카페24 쇼핑몰을 운영하다 보면 ‘어디 매장에서 받을 수 있나요’, ‘내 동네에 있는지’, ‘영업시간이 맞나요’ 같은 문의가 반복됩니다. 매장이 몇 곳이면 게시판·회사 소개 페이지에 주소를 적어 두는 것으로 버티기도 합니다. 가맹·체험 매장·픽업·AS 센터가 늘면, 목록만으로는 고객이 찾기 어렵고 운영자는 주소·휴무·연락처를 매번 수동으로 고칩니다.
가능 여부부터 말하면, 카페24 기본 상품·주문 기능만으로는 ‘지도에서 내 위치 기준 가까운 매장’을 제공하지 않습니다. 매장이 적고 고정이면 스킨 페이지에 주소·외부 지도 링크를 두거나, 지도 업체 Place 임베드로 1차를 열 수 있습니다. 매장이 많거나 브랜드·서비스별로 필터가 필요하면 매장 마스터(DB)와 네이버·카카오 등 지도 API를 붙이고, 카페24 스킨·별도 서버와 연결하는 커스텀이 일반적입니다. 온오프라인 재고·주문까지 한 흐름으로 맞추는 사례는 별도 글에서 다룹니다. 이 글은 지도·매장찾기 API를 카페24 몰에 붙이는 방법과 한계입니다.
한눈에 보는 핵심 답변
매장찾기·지도 연동을 검토할 때 경로만 먼저 보면 아래와 같습니다.
- 카페24 기본 기능에는 매장 좌표·지도 검색·거리순 정렬이 없습니다.
- 매장 5~10곳·고정 주소면 스킨 목록 + 외부 지도 링크로 시작할 수 있습니다.
- 매장이 많거나 필터·관리자 등록이 필요하면 매장 마스터 + 지도 API가 필요합니다.
- 지도 API 키·매장 원본 데이터는 스킨에만 두기 어렵고, 서버·관리 화면을 검토합니다.
- 주소만 있으면 지도에 안 나올 수 있어 좌표(위경도) 변환·검수가 따릅니다.
- 1차는 목록·지역 검색, 2차는 GPS·재고·픽업 연동으로 나누는 경우가 많습니다.
기본·스킨·앱·커스텀으로 나누고, 연동은 어떻게 흐르나
카페24 기본으로 가능한 범위는 ‘매장 정보를 보여 주는 페이지’입니다. 게시판·HTML 페이지·스킨에 주소·전화·영업시간을 적거나, 네이버·카카오 지도 Place URL로 넘기는 방식입니다. 거리순·내 주변·브랜드별 필터·휴무 반영은 없습니다. 앱스토어에 매장·지도 관련 앱이 있어도, 우리 매장 필드·카페24 주문·재고와 맞는지는 앱마다 다릅니다. 앱 DB만 원본이면 카페24 관리자와 숫자가 어긋날 수 있어, 설치 전에 ‘매장 목록을 누가 고치는지’를 확인하는 편이 안전합니다.
커스텀으로 가는 전형적인 구성은 네 단계입니다. 첫째, 매장 마스터(이름·주소·위경도·영업시간·연락처·브랜드·서비스·노출 여부)를 카페24 상품 옵션이 아니라 별도 DB나 관리 화면에 둡니다. 둘째, 주소를 좌표로 바꾸는 지오코딩을 등록·수정 시 돌리거나 배치로 맞춥니다. 셋째, 지도 업체(네이버·카카오 등) JavaScript SDK로 카페24 스킨의 ‘매장찾기’ 페이지에 지도·마커·목록 UI를 그립니다. 넷째, 매장이 많거나 검색·필터·관리자 CRUD가 필요하면 별도 서버 API가 매장 목록을 내려주고, 스킨은 그 결과만 지도에 올립니다. 카페24 API는 주문·회원·상품과 맞출 때 쓰며, ‘지도에 핀 찍기’ 자체는 지도 API와 매장 마스터 쪽입니다.
카페24 기본 기능만으로는 매장 좌표·지도 검색을 제공하지 않으므로, 매장 마스터와 지도 API를 스킨·별도 서버와 연결하는 커스텀이 일반적입니다. 지도 API 앱 키는 도메인 제한이 있어 카페24 쇼핑몰 도메인·테스트몰을 지도 업체 콘솔에 등록해야 합니다. 서버에서 지오코딩·목록 API를 제공할 때는 호출 제한·캐시·실패 재시도를 두는 편이 안전합니다.
스킨만으로 버틸 때와 서버가 필요할 때
매장 JSON을 스킨 JS에 박아 두고 지도 SDK만 쓰는 방식은 매장 수가 적고 자주 안 바뀔 때만 현실적입니다. 운영자가 관리자에서 매장을 고치거나, 가맹에서 데이터를 받아 반영하면 스킨 배포·캐시 이슈가 납니다. 매장 CRUD·권한·로그·외부 POS·가맹 시스템과 맞추려면 별도 서버와 관리 화면이 따라옵니다. 지도 API 비밀키는 프론트에 두지 않고, 공개용 읽기 API만 스킨에 노출하는 구조가 흔합니다.
검수할 때 보는 흐름
테스트몰에서 매장찾기 페이지를 열고, 목록·마커·상세(주소·전화·길찾기)가 같은 매장을 가리키는지 확인합니다. 휴무·임시 폐점 매장이 목록에서 빠지는지, 모바일에서 GPS 허용 시 ‘내 주변’이 동작하는지(1차에 넣었다면)를 봅니다. 주소를 바꾼 뒤 지도 위치가 갱신되는지, 길찾기 링크가 올바른 앱으로 열리는지도 같이 돌립니다.
핵심 체크리스트
지도·매장찾기 상담·개발 전에 아래로 표시해 보세요. ‘예’가 여러 개면 스킨 링크만으로는 부족한 경우가 많습니다.
- 매장 수가 10곳을 넘거나 분기마다 추가·폐점이 있는가
- 브랜드·지역·서비스(픽업·AS·체험)별로 필터가 필요한가
- 운영자·가맹이 스킨이 아니라 관리 화면에서 매장을 고치는가
- 주소만 있고 위경도·지오코딩 검수는 아직 안 했는가
- 지도 API 키·도메인 등록(실몰·테스트몰)을 누가 갖고 있는가
- ‘가까운 매장’에 재고·픽업 가능 여부까지 보여야 하는가
- 카페24 주문·회원과 매장을 묶는 규칙(어느 매장 기준인지)이 있는가
- 앱을 켜도 매장 원본이 카페24 관리자와 같은지 확인했는가
- 1차는 목록·지도만, 2차는 GPS·재고로 나눌 범위를 적었는가
- 지도 업체 이용약관·호출 한도·장애 시 목록만 보이게 할지 정했는가
제한·대안, 그리고 연동에서 자주 막히는 지점
제한은 크게 세 가지입니다. 지도 API는 이용약관·일일 호출·도메인·키 노출 정책이 있어, 스킨에 모든 비밀키를 넣을 수 없습니다. JavaScript용 공개 키와 서버용 키를 구분하고, 허용 도메인에 카페24 몰 URL을 넣지 않으면 지도가 빈 화면으로 나옵니다. 매장 데이터는 카페24 상품·옵션과 성격이 달라, ‘옵션 칸에 매장 이름을 넣는’ 방식은 CS·재고와 섞이기 쉽습니다. GPS·내 주변은 모바일 브라우저 권한·HTTPS·사용자 거부 시 동작이 달라, PC만 목록·지역 검색으로 두는 몰도 많습니다.
대안은 단계별로 있습니다. 1차는 지역(시·구) 목록 + 매장별 ‘길찾기’ 외부 링크만 두고, 2차에 지도·거리순을 넣습니다. Place ID·임베드로 매장별 지도를 붙이는 방식은 개발은 적지만 필터·일괄 관리는 어렵습니다. 매장 마스터를 엑셀로 두고 월 1회 반영하는 1차도 있으나, 주소 오타·휴무 누락이 CS로 이어지면 관리 화면·API 동기화를 검토합니다.
실무에서 이런 문제가 발생할 수 있습니다
가맹·체험 매장이 전국에 있는 브랜드에서, 회사 소개에 주소만 30곳 나열해 두었던 경우입니다. 고객은 ‘가까운 곳’을 못 찾고 CS는 ‘지도로 보여 달라’는 문의를 반복 받았습니다. 이런 요구라면 매장 마스터와 지도 페이지를 따로 두고, 1차는 지역·키워드 검색 + 지도 마커까지 열고, 재고·픽업은 온오프라인 통합 사례처럼 다음 단계로 미루는 편이 일정에 안전합니다.
안경원·뷰티처럼 매장별 담당·서비스가 다른 몰에서는, 지도에 ‘모든 매장’을 찍어 두고 상세에서 예약·재고를 링크만 거는 1차와, 매장 마스터를 POS·가맹 정산과 맞추는 2차가 갈립니다. 주소는 같아도 좌표가 어긋나 길찾기가 엉뚱한 곳으로 가면 신뢰 이슈가 됩니다. 오픈 전 샘플 매장 몇 곳을 실제 방문·지도 핀 위치로 맞춰 보는 검수가 필요합니다.
카페24에 매장찾기 기능이 기본으로 있나요
없습니다. 주문·배송·상품 중심이고, 매장 좌표·지도 UI·거리 검색은 스킨·앱·커스텀으로 붙입니다. 게시판에 주소를 적는 것은 ‘안내’이지 매장찾기 기능은 아닙니다.
네이버 지도와 카카오 지도 중 무엇을 쓰나요
고객이 주로 쓰는 길찾기 앱·계약·디자인 가이드·키 발급 조건에 따라 갑니다. 한 몰에 두 업체 SDK를 동시에 넣기보다, 하나를 정하고 길찾기 링크만 다른 앱으로 여는 방식도 많습니다. 업체마다 키·도메인 등록 절차가 다릅니다.
지도 API 키를 스킨에 넣어도 되나요
JavaScript용 공개(클라이언트) 키는 지도 표시에 쓰이지만, 도메인 제한과 노출 범위를 콘솔에서 좁혀야 합니다. 서버용·지오코딩용 키는 스킨에 두면 안 됩니다. 매장 목록 API·관리자 인증은 별도 서버가 맡는 편이 안전합니다.
주소만 있으면 지도에 바로 나오나요
아닙니다. 지도 SDK는 보통 위경도가 필요하고, 주소→좌표 변환(지오코딩)에서 오차·실패가 납니다. ‘서울시 강남구’처럼 모호한 주소는 핀 위치가 틀어질 수 있어, 등록 후 지도에서 확인하는 절차가 필요합니다.
매장 재고까지 지도에 보여줄 수 있나요
가능은 하나 지도 API만으로는 안 됩니다. 매장별 재고·픽업 가능 여부는 POS·ERP·카페24 재고와 맞추는 별도 연동이고, 지도는 ‘어느 매장인지’를 보여 주는 UI입니다. 실시간 재고는 동기화 지연·품절 CS를 함께 설계해야 합니다.
1차는 목록만, 2차에 지도를 넣어도 되나요
됩니다. 지역·키워드 목록과 길찾기 링크만으로 CS가 줄어드는 경우가 많고, 그다음 지도·GPS·재고를 올립니다. 매장 마스터를 1차에서 잡아 두면 2차 UI만 바꿔도 데이터를 재사용할 수 있습니다.
옴니어스가 지도·매장찾기 문의를 나누는 방식
옴니어스는 ‘지도 넣어 주세요’만 듣고 바로 전면 개발로 받지 않습니다. 매장 수·누가 등록하는지·필터·재고·픽업까지 필요한지, 1차에 목록만으로 되는지를 먼저 나눕니다. 스킨·외부 링크로 되면 그쪽을 쓰고, 매장 마스터·지도 API·관리 화면이 필요하면 범위를 문장으로 자릅니다.
자료가 없어도 매장 대략 개수·‘고객이 자주 묻는 한 줄’·쓰고 싶은 지도(네이버·카카오 등)만 알려 주셔도 방향이 보입니다. 온오프라인 재고까지 한 번에 맡기기보다, 매장찾기만 1차로 열지 같이 정리해 드립니다.
지도·매장찾기 다음에 보면 좋은 글·페이지
매장과 주문·재고를 한 흐름으로 맞춘 사례는 오프라인·온라인 통합 사례에서, API·별도 서버가 왜 따라오는지는 API 안내 글에서, 가맹·매장 단위 운영은 안경원 가맹 사례에서 이어서 볼 수 있습니다. 기본만으로 충분한지는 커스텀 vs 기본 가이드에 있습니다.
FAQ·서비스·진행 방식에서 범위를 확인할 수 있고, 문의에 매장 수와 ‘지도에 꼭 필요한 기능 한 줄’만 남겨 주셔도 됩니다. 1차·2차 기준으로 안내해 드립니다.