카페24 쇼핑몰에 매장찾기, 지도 검색, 가까운 매장 찾기 기능을 추가할 수 있습니다.
다만 카페24 기본 기능만으로는 고객의 위치를 기준으로 가까운 매장을 찾거나, 지도에서 매장을 검색하고 거리순으로 정렬하는 기능을 제공하기 어렵습니다.
매장이 몇 곳 없는 경우에는 주소와 외부 지도 링크만으로도 충분할 수 있습니다.
반대로 매장이 많거나 지역·서비스별 필터, 관리자 관리, GPS 검색 등이 필요하다면 매장 데이터와 지도 API를 별도로 연결하는 커스텀 개발이 필요합니다.
카페24에 매장찾기 기능을 기본으로 만들 수 있나요?
카페24의 기본 상품·주문 기능은 온라인 쇼핑몰 운영을 중심으로 구성되어 있습니다.
따라서 다음과 같은 기능은 기본 기능만으로 구현하기 어렵습니다.
- 내 주변 매장 찾기
- 지도에서 매장 위치 확인
- 거리순 매장 정렬
- 지역별 매장 검색
- 매장 유형별 필터
- 매장별 영업시간·휴무일 관리
- GPS를 이용한 가까운 매장 검색
단순하게 매장 주소를 보여주는 것이라면 스킨이나 HTML 페이지에 매장 정보를 넣을 수 있습니다.
예를 들어 다음 정도의 기능은 비교적 간단합니다.
서울 강남점
서울 강남구 ○○로 00
02-000-0000
영업시간 10:00~20:00
[길찾기]
이 정도라면 별도의 복잡한 시스템까지 만들 필요가 없습니다.
하지만 매장이 전국적으로 늘어나면 이야기가 달라집니다.
매장이 많아지면 왜 매장찾기 시스템이 필요할까요?
매장이 5~10곳 정도라면 주소를 직접 관리하는 것도 가능합니다.
하지만 매장이 30곳, 50곳 이상으로 늘어나면 다음과 같은 문제가 생길 수 있습니다.
- 신규 매장이 추가될 때마다 페이지 수정
- 폐점한 매장을 직접 삭제
- 영업시간 변경 시 여러 페이지 수정
- 휴무일 정보 누락
- 매장 전화번호 변경
- 지역별 매장 검색이 어려움
- 고객이 가까운 매장을 찾기 어려움
- CS센터에서 매장 위치를 반복적으로 안내
특히 가맹점, 체험 매장, 픽업 매장, AS센터처럼 매장마다 제공하는 서비스가 다른 경우에는 단순한 주소 목록만으로 관리하기 어려워집니다.
이럴 때는 매장 정보를 하나의 기준 데이터로 관리하고, 쇼핑몰에서는 그 데이터를 불러와 보여주는 방식이 적합합니다.
카페24 지도·매장찾기는 어떻게 구성하나요?
일반적으로 다음과 같은 구조로 개발합니다.
매장 관리 → 매장 데이터 → 지도 API → 카페24 매장찾기 화면
조금 더 구체적으로 보면 다음과 같습니다.
1. 매장 마스터 데이터 관리
매장 정보를 별도로 관리합니다.
예를 들면 다음과 같습니다.
- 매장명
- 주소
- 위도·경도
- 전화번호
- 영업시간
- 휴무일
- 브랜드
- 매장 유형
- 제공 서비스
- 픽업 가능 여부
- AS 가능 여부
- 노출 여부
매장 수가 적다면 단순한 데이터 형태로 관리할 수도 있습니다.
매장이 많거나 운영자가 직접 수정해야 한다면 관리자 페이지와 DB를 별도로 구성하는 방법이 일반적입니다.
2. 주소를 좌표로 변환합니다
지도에서 매장을 정확한 위치에 표시하려면 주소만 가지고 있는 것보다 위도와 경도 정보가 필요합니다.
따라서 매장 주소가 등록되거나 변경될 때 주소를 좌표로 변환하는 지오코딩 과정이 필요할 수 있습니다.
예를 들어,
서울특별시 강남구 테헤란로 00
이라는 주소를 지도에서 사용할 수 있는
위도 + 경도
형태로 변환하는 것입니다.
다만 주소가 잘못 입력되었거나 건물명이 모호하면 좌표가 잘못 잡힐 수 있습니다.
따라서 매장 등록 후 실제 지도에서 위치가 맞는지 확인하는 과정도 중요합니다.
네이버 지도와 카카오 지도 API를 사용할 수 있나요?
가능합니다.
카페24 쇼핑몰의 매장찾기 페이지에 네이버 지도 API 또는 카카오 지도 API를 연결할 수 있습니다.
예를 들어 고객이 매장찾기 페이지에 들어오면 다음과 같은 화면을 만들 수 있습니다.
[지역 선택] [매장 유형 선택] [검색]
┌─────────────────────────────┐
│ 지도 │
│ ● ● │
│ ● │
│ ● ● │
└─────────────────────────────┘
서울 강남점
서울 강남구 ○○로
영업시간 10:00~20:00
[길찾기]
서울 서초점
서울 서초구 ○○로
영업시간 10:00~20:00
[길찾기]
여기에 필요하다면 다음 기능도 추가할 수 있습니다.
- 지역 검색
- 매장명 검색
- 매장 유형 필터
- 서비스별 필터
- 지도 마커
- 매장 상세정보
- 길찾기
- 현재 위치 기준 검색
- 가까운 매장 거리순 정렬
GPS로 가까운 매장을 찾을 수도 있나요?
가능합니다.
고객이 모바일에서 위치 정보 사용을 허용하면 현재 위치를 기준으로 가까운 매장을 찾도록 만들 수 있습니다.
예를 들어 고객이
“내 주변 매장 찾기”
버튼을 누르면 현재 위치와 매장의 좌표를 비교해 가까운 매장부터 보여줄 수 있습니다.
다만 GPS 기능은 일반적인 매장 목록보다 고려할 사항이 많습니다.
- 모바일 브라우저 위치 권한
- HTTPS 환경
- 사용자가 위치 권한을 거부한 경우
- PC와 모바일의 차이
- 위치 정확도
- 지도 API 호출량
따라서 처음부터 GPS까지 모두 개발하기보다는 1차에는 지역·키워드 검색을 만들고, 2차에 GPS를 추가하는 방식도 많이 사용합니다.
스킨만으로 개발할 수 있나요?
매장 수가 적고 매장 정보가 자주 바뀌지 않는다면 가능합니다.
예를 들어 매장 5곳의 정보를 JSON이나 HTML 형태로 관리하고 지도 API를 연결하는 방법입니다.
하지만 다음과 같은 상황이라면 스킨만으로 관리하기에는 불편할 수 있습니다.
- 매장이 계속 추가됨
- 폐점 매장이 자주 발생함
- 운영자가 직접 매장을 수정해야 함
- 가맹점에서 정보를 전달받아야 함
- 매장별 서비스가 다름
- 매장 검색 조건이 많음
- 외부 시스템과 연동해야 함
이 경우에는 별도 서버 + DB + 관리자 페이지를 구성하는 것이 관리하기 편합니다.
카페24 API와 지도 API는 같은 기능인가요?
아닙니다.
두 API의 역할이 다릅니다.
카페24 API
주로 다음과 같은 쇼핑몰 데이터를 연동할 때 사용합니다.
- 상품
- 주문
- 회원
- 재고
- 배송
- 기타 쇼핑몰 데이터
지도 API
주로 다음과 같은 기능에 사용합니다.
- 지도 표시
- 주소 검색
- 좌표 변환
- 매장 위치 표시
- 지도 마커
- 위치 기반 검색
따라서 매장찾기 기능을 만든다고 해서 카페24 API만 사용하는 것은 아닙니다.
카페24 데이터가 필요한 부분은 카페24 API를 사용하고, 지도와 위치 기능은 지도 API를 사용하는 구조로 이해하면 쉽습니다.
매장 데이터는 어디에서 관리해야 하나요?
매장 정보가 중요한 시스템이라면 매장 데이터를 하나의 기준으로 관리하는 것이 중요합니다.
예를 들어 카페24 관리자에는 50개 매장이 있고, 별도 지도 시스템에는 48개만 있다면 고객에게 잘못된 정보가 노출될 수 있습니다.
따라서 개발할 때 다음 중 어느 곳을 원본으로 사용할지 먼저 정해야 합니다.
- 카페24
- 별도 DB
- ERP
- POS
- 가맹점 관리 시스템
- 엑셀
- 기타 외부 시스템
매장찾기만 필요한 경우에는 별도 매장 DB를 하나의 기준으로 만들어 관리하는 방법도 있습니다.
지도 API 키는 어떻게 관리해야 하나요?
지도 API를 사용할 때는 API 키 관리도 확인해야 합니다.
JavaScript에서 사용하는 공개 키와 서버에서 사용하는 키의 역할이 다를 수 있기 때문에 모든 키를 카페24 스킨에 그대로 넣는 방식은 적절하지 않습니다.
특히 서버에서 사용하는 지오코딩이나 매장 데이터 처리용 인증 정보는 프론트 화면에 노출하지 않는 것이 좋습니다.
또한 지도 서비스 제공업체의 관리 화면에서 다음과 같은 설정을 확인해야 합니다.
- 사용 도메인
- 테스트몰 도메인
- 실제 쇼핑몰 도메인
- API 사용 범위
- 호출량 제한
- 키 사용 정책
도메인 설정이 잘못되면 개발한 지도 화면이 정상적으로 표시되지 않을 수도 있습니다.
매장찾기 기능을 개발할 때 어떤 부분을 테스트하나요?
개발이 끝났다고 바로 운영 사이트에 적용하기보다는 실제 매장 데이터를 기준으로 테스트하는 것이 좋습니다.
매장 목록
- 등록된 매장이 모두 표시되는가?
- 폐점 매장이 노출되지 않는가?
- 지역 검색이 정상적으로 되는가?
- 필터 결과가 정확한가?
지도
- 목록과 지도 마커가 같은 매장을 가리키는가?
- 주소와 실제 위치가 일치하는가?
- 잘못된 좌표가 없는가?
- 길찾기 링크가 정확한가?
모바일
- 모바일에서 지도가 정상적으로 표시되는가?
- GPS 권한을 허용했을 때 정상적으로 작동하는가?
- GPS 권한을 거부해도 지역 검색을 사용할 수 있는가?
운영
- 매장 주소를 변경하면 지도 위치도 변경되는가?
- 영업시간 변경이 정상적으로 반영되는가?
- 임시 휴무 처리가 가능한가?
- 신규 매장을 추가하기 쉬운가?
카페24 매장찾기 개발 전 체크해야 할 사항
다음 항목 중 해당되는 것이 많다면 단순한 스킨 페이지보다 별도 시스템을 검토할 필요가 있습니다.
- 매장이 10곳 이상이다.
- 매장이 계속 추가되거나 폐점한다.
- 지역별 검색이 필요하다.
- 매장 유형별 필터가 필요하다.
- 픽업·AS·체험 등 매장별 서비스가 다르다.
- 운영자가 관리자 화면에서 매장 정보를 수정해야 한다.
- 매장 주소와 위경도를 함께 관리해야 한다.
- 고객의 현재 위치를 기준으로 매장을 찾아야 한다.
- 매장별 재고나 픽업 가능 여부까지 보여줘야 한다.
- POS·ERP·가맹 시스템과 연결해야 한다.
- 카페24 주문과 특정 매장을 연결해야 한다.
- 매장 정보를 엑셀로 수동 관리하는 것이 부담스럽다.
특히 매장 재고나 픽업 가능 여부까지 연결하려는 경우에는 지도 API만 추가하는 것으로 끝나지 않습니다.
POS·ERP·카페24 재고 데이터를 어떻게 연결할 것인지 별도로 설계해야 합니다.
매장찾기 기능을 한 번에 모두 개발해야 하나요?
반드시 그럴 필요는 없습니다.
오히려 단계적으로 개발하는 것이 관리하기 쉬운 경우가 많습니다.
1차 개발
- 매장 목록
- 지역 검색
- 매장 상세정보
- 지도 표시
- 지도 마커
- 길찾기 링크
2차 개발
- GPS 기반 내 주변 매장
- 거리순 정렬
- 서비스별 필터
- 매장별 픽업 가능 여부
- 매장 재고 연동
3차 개발
- POS 연동
- ERP 연동
- 카페24 주문 연동
- 매장별 예약
- 가맹점 관리
- 매장별 운영 데이터 관리
처음부터 모든 기능을 넣기보다 실제 고객이 가장 많이 사용하는 기능부터 적용하면 개발 범위와 운영 부담을 줄일 수 있습니다.
매장이 적다면 꼭 커스텀 개발이 필요한 것은 아닙니다
매장이 5~10곳 정도이고 주소가 거의 바뀌지 않는다면 복잡한 시스템을 만들 필요가 없습니다.
예를 들어 다음과 같이 구성할 수 있습니다.
매장 목록 + 주소 + 전화번호 + 외부 지도 길찾기
또는 매장별 지도 링크를 제공하는 방법도 있습니다.
반대로 매장이 많고 정보가 자주 변경된다면 관리자에서 매장 정보를 수정할 수 있도록 만드는 것이 효율적입니다.
즉, 매장 수보다 중요한 것은 매장 정보가 얼마나 자주 바뀌고 어떤 검색 기능이 필요한지입니다.
실제 개발에서는 어떤 문제가 자주 발생하나요?
전국에 가맹점이나 체험 매장이 많은 브랜드라면 회사 소개 페이지에 주소만 나열하는 방식으로는 고객이 원하는 매장을 찾기 어려울 수 있습니다.
이런 경우에는 다음과 같은 구조가 실용적입니다.
매장 DB → 지역·키워드 검색 → 지도 마커 → 매장 상세 → 길찾기
여기에 재고나 픽업을 추가해야 한다면 별도의 재고 연동 구조를 붙입니다.
또 하나 중요한 부분은 주소와 지도 위치의 일치 여부입니다.
주소가 정상적으로 등록되어 있어도 지오코딩 결과가 잘못될 수 있습니다. 따라서 실제 운영 전에 주요 매장을 샘플로 선정해 지도 핀 위치와 길찾기 결과를 직접 확인하는 것이 좋습니다.
카페24 매장찾기 개발은 어떻게 진행하나요?
카페24 쇼핑몰의 매장찾기 기능은 먼저 필요한 범위를 정하는 것이 중요합니다.
옴니어스24에서는 다음 항목부터 확인할 수 있습니다.
1. 매장이 몇 곳인지
2. 매장 정보는 누가 관리하는지
3. 매장이 얼마나 자주 추가·수정되는지
4. 지역 검색이 필요한지
5. 지도 검색이 필요한지
6. GPS가 필요한지
7. 매장별 서비스가 다른지
8. 픽업이나 재고까지 필요한지
9. POS·ERP와 연결해야 하는지
10. 카페24 주문과 매장을 연결해야 하는지
단순히 주소를 보여주는 수준이라면 스킨이나 외부 지도 링크로 해결할 수 있습니다.
반대로 매장 데이터 관리와 지도 검색을 함께 운영해야 한다면 매장 마스터 + DB + 지도 API + 카페24 스킨 + 별도 서버를 연결하는 방식으로 개발할 수 있습니다.
자주 묻는 질문
카페24에 매장찾기 기능이 기본으로 있나요?
카페24 기본 기능만으로 지도 기반 매장 검색이나 내 주변 매장 검색을 제공하기는 어렵습니다. 매장 목록과 주소 안내는 스킨이나 페이지로 구성할 수 있지만, 지도·거리 검색·GPS 등의 기능은 별도 개발이나 앱 연동을 검토해야 합니다.
네이버 지도와 카카오 지도 중 어떤 것을 사용해야 하나요?
고객이 주로 사용하는 지도 서비스, 디자인, API 정책, 키 발급 조건 등을 기준으로 결정합니다. 하나의 지도 SDK를 선택하고 매장 상세에서 다른 지도 서비스의 길찾기 링크를 제공하는 방식도 가능합니다.
주소만 있으면 지도에 매장을 표시할 수 있나요?
주소를 좌표로 변환하는 과정이 필요할 수 있습니다. 주소가 모호하거나 잘못 입력되면 위치가 정확하지 않을 수 있기 때문에 등록 후 실제 지도 위치를 확인하는 것이 좋습니다.
고객의 현재 위치에서 가까운 매장을 찾을 수 있나요?
가능합니다. 모바일 브라우저에서 위치 권한을 허용하면 현재 위치와 매장의 좌표를 비교해 가까운 매장을 찾는 기능을 구현할 수 있습니다.
매장별 재고도 지도에서 확인할 수 있나요?
가능하지만 지도 API만으로는 구현할 수 없습니다. 카페24 재고나 POS·ERP의 매장별 재고 데이터를 별도로 연동해야 합니다.
매장 수가 적어도 별도 서버가 필요한가요?
항상 필요한 것은 아닙니다. 매장 수가 적고 정보가 거의 변경되지 않는다면 스킨과 지도 API만으로도 구성할 수 있습니다. 관리 화면이나 외부 시스템 연동이 필요해지면 별도 서버를 검토합니다.
매장찾기와 픽업 기능을 같이 만들 수 있나요?
가능합니다. 다만 매장 위치를 보여주는 기능과 실제 픽업 가능 여부를 확인하는 기능은 데이터 구조가 다릅니다. 매장 정보와 카페24 상품·재고·주문 데이터를 어떤 기준으로 연결할지 먼저 정해야 합니다.
처음부터 GPS와 재고까지 모두 개발해야 하나요?
필요하지 않습니다. 먼저 매장 목록·지역 검색·지도·길찾기처럼 고객이 바로 사용하는 기능을 만들고, 이후 GPS·재고·픽업·POS 연동으로 확장하는 방법도 가능합니다.
카페24 매장찾기 개발에서 가장 중요한 것은?
매장찾기 기능은 단순히 지도 하나를 쇼핑몰에 넣는 작업이 아닙니다.
매장 정보를 어디에서 관리할지, 고객에게 어떤 검색 기능을 제공할지, 지도와 실제 매장 위치를 어떻게 맞출지를 먼저 결정해야 합니다.
매장이 적다면 간단한 목록과 지도 링크만으로 충분할 수 있습니다.
반대로 매장이 많거나 지속적으로 변경된다면 매장 마스터를 기준으로 DB와 관리 화면을 구성하고 지도 API를 연결하는 것이 효율적입니다.
특히 재고·픽업·예약·POS까지 연결하려는 경우에는 처음부터 모든 기능을 하나로 만들기보다 단계별 범위를 나누어 개발하는 것이 안정적입니다.