8분 읽기 Store Locator
매장 찾기 HTML 코드: 무엇이 필요한가
매장 찾기 HTML 코드에 실제로 들어가는 내용, 위치 정보와 상품 검색이 어떻게 연결되는지, 각 플랫폼에서 어디에 붙여야 하는지를 간단히 설명합니다.
매장 찾기 HTML 코드는 작은 임베드 코드입니다. 컨테이너 요소와 지도를 불러오고 위치 데이터를 읽어 거리순으로 결과를 정렬하는 스크립트 태그로 이루어집니다. 지도 제공업체, 위치 확인 방식, 쇼핑객이 상품으로 검색할 수 있는지는 이 기본 구조 위에 따로 내리는 선택입니다.
매장 주인이 이 코드를 직접 작성하는 경우는 거의 없습니다. 보통 플러그인, 앱, 또는 SaaS 위젯이 이를 생성해 붙여넣을 수 있는 코드 한 줄을 건네줍니다. 그래도 그 안에 무엇이 들어 있는지 아는 것은 도움이 됩니다. 무엇을 바꿀 수 있는지 보여주기 때문입니다.
이 코드에 실제로 들어 있는 것
작동하는 매장 찾기는 세 부분으로 이루어집니다. 지도 라이브러리가 타일과 핀을 그리며, Google Maps, Mapbox, OpenStreetMap 타일을 쓰는 Leaflet, 또는 제공업체 자체의 벡터 렌더러를 사용합니다.
위치 데이터 소스가 주소와 좌표를 제공합니다. 정적인 JSON 배열, CSV를 JSON으로 바꾼 것, 또는 실시간 API 호출 중 하나입니다. 거리 함수는 거의 항상 위도와 경도에 대한 haversine 공식을 사용해 쇼핑객과의 거리로 위치를 정렬합니다.
위치 확인에는 요청 하나가 아니라 대체 방법이 필요합니다
찾기 기능은 두 가지 방식으로 쇼핑객을 찾을 수 있습니다. 브라우저 위치 확인은 권한을 요청하고 정확한 기기 위치를 반환하지만, IP 기반 추정은 그 요청을 건너뛰고 대신 도시 단위의 추정 위치를 반환합니다.
그 요청을 거부한 쇼핑객도 모바일에서 작동하는 근처 검색을 기대합니다. 실용적인 해결책은 쇼핑객이 요청을 거부했을 때 IP 기반 추정이나 수동 주소 검색으로 전환하는 것입니다.
플랫폼별로 실제 코드를 붙여넣는 위치
Shopify에서는 매장 주인이 HTML을 직접 붙여넣는 경우가 거의 없습니다. 테마 아키텍처는 app blocks를 통해 타사 앱의 콘텐츠를 렌더링하며, 이를 통해 앱이 테마 코드를 수정하지 않고도 콘텐츠를 추가할 수 있어, 찾기 기능은 복사한 코드가 아니라 블록 형태로 설치됩니다.
WordPress는 대신 블록 편집기를 통해 작동합니다. 어떤 블록에든 쇼트코드를 넣으면 HTML 없이 해당 페이지에 찾기 기능이 표시됩니다. 저희 WordPress 가이드에서 한 플러그인의 전체 설정 과정을 다룹니다.
Squarespace의 Code Block은 자체 HTML을 위한 공식 문서화된 위치이지만, 그 안의 JavaScript와 iframe은 Core 플랜 이상이 필요합니다. Wix는 대신 코드를 붙여넣을 수 있는 Embed HTML 요소나 자사 App Market의 찾기 앱을 제공합니다. 저희 Wix 가이드에서 이 방식을 다룹니다.
Webflow, BigCommerce, Elementor를 포함한 다른 많은 사이트 빌더들도 같은 목적을 위한 비슷한 임베드나 HTML 요소를 제공합니다.
구축 전 점검 목록, 직접 코딩이든 위젯이든
직접 구축할지 완성된 위젯을 쓸지 결정하는 일은 네 가지 점검으로 좁혀집니다.
- 플랫폼이 어디에서 자체 코드 추가를 허용하는지 확인하세요. 블록, 요소, 또는 앱 설치 중 하나입니다.
- 지도 제공업체의 키 요구사항을 따로 확인하세요. Google Maps와 Mapbox 둘 다 매장 주인 자신의 인증 정보가 필요하며, Google Maps는 결제 계정도 필요합니다.
- 위치 데이터를 어떻게 최신으로 유지할지 결정하세요. 수동 편집, 동기화되는 스프레드시트, 또는 커머스 플랫폼에서 오는 실시간 피드 중 하나입니다.
- 권한을 거부한 상태의 실제 휴대폰에서 위치 확인을 테스트하세요. 허용한 상태만 테스트하면 안 됩니다. 바로 그 지점에서 근처 검색이 보통 실패합니다.
상품 단위 검색이 실제로 요구하는 것
매장 찾기는 장소를 찾습니다. 상품 찾기는 더 좁은 질문에 답합니다. 지금 특정 상품을 보유한 매장이 어디인지이며, 이를 위해서는 지도뿐 아니라 매장별 재고 데이터가 필요합니다.
| 요구사항 | 하는 일 | Shopify 소스 |
|---|---|---|
| 매장 레코드 | 매장 또는 픽업 지점 | Location object |
| 매장별 재고 | 상품별 재고 | inventoryLevels |
| 상품 필터 | 재고 있는 상품 표시 | storeAvailability |
매장과 재고에 관한 행은 Shopify 자체의 Location API에서 나오며, 어떤 앱을 설치하든 존재합니다. 특정 옵션의 매장별 재고 여부도 매장 픽업을 위해 만들어진 Storefront API의 storeAvailability 필드를 통해 네이티브로 제공되지만, 이를 지도 필터로 바꾸는 일은 여전히 앱의 몫입니다.
결정하기 전에 공급업체에 두 가지를 물어보세요.
- 상품 재고 여부가 재고에서 자동으로 업데이트되나요, 아니면 누군가 수동으로 유지하나요?
- 근처 매장이 모두 재고가 없을 때 페이지에는 무엇이 표시되나요?
마무리
매장 찾기가 완성되었다고 할 수 있는 시점은, 지도가 깨끗하게 로드되고, 권한을 거부한 상태의 위치 확인 테스트에서도 근처 결과가 나오며, 상품 검색을 구축했다면 재고가 없다고 알고 있는 매장을 제외하는 시점입니다. 그 이후는 모두 다듬는 작업입니다.
이 결정의 대부분은 디자인이 아니라 데이터에 관한 것입니다. 매장 데이터가 어디에 있는지, 얼마나 최신으로 유지되는지, 상품 재고 여부가 실시간에 가깝게 추적되는지입니다. 이것을 먼저 제대로 해두면, 그 아래의 지도는 쉬운 부분이 됩니다.
자주 묻는 질문
매장 찾기 HTML 코드에는 Google Maps API 키가 필요한가요?
Google Maps를 선택한 경우에만 필요하며, 이때는 매장 주인 자신의 API 키와 결제 계정이 필요합니다. Mapbox는 대신 자체 액세스 토큰이 필요하며, OpenStreetMap 방식의 데이터로 만든 지도는 키가 전혀 필요 없습니다.
매장 찾기와 상품 찾기의 차이는 무엇인가요?
매장 찾기는 매장이 어디에 있는지 보여줍니다. 상품 찾기는 그 매장 중 어디가 지금 특정 상품을 재고로 보유하고 있는지 보여주며, 이를 위해서는 지도 뒤에 재고 데이터가 필요합니다.
코드를 작성하지 않고도 매장 찾기를 추가할 수 있나요?
네. 앱, 플러그인, SaaS 위젯이 이 임베드 코드를 대신 생성해 줍니다. Progus Store Locator도 그런 선택지 중 하나로, Shopify에서는 테마 블록, WordPress에서는 쇼트코드, Wix에서는 App Market 설치 형태로 제공되며 Shopify 앱이나 웹 대시보드에서 관리할 수 있습니다. 그 외의 곳에서는 임베드 코드 한 줄입니다.
위치 확인은 항상 쇼핑객에게 권한을 요청하나요?
아닙니다. IP 기반 추정은 아무 요청 없이도 쇼핑객을 도시 단위로 배치할 수 있습니다. 그래서 브라우저 요청을 거부하는 쇼핑객에게 합리적인 대체 방법이 됩니다.
웹사이트에 매장 찾기 추가. Store Locator 알아보기 ›