9 min czytania Store Locator

Kod HTML lokalizatora sklepów: co trzeba zbudować

Prosty rozkład tego, co faktycznie zawiera kod HTML lokalizatora sklepów, jak wpisują się w to geolokalizacja i wyszukiwanie produktów, oraz gdzie wklejasz go na każdej platformie.

Kod HTML lokalizatora sklepów to niewielki fragment do osadzenia: element kontener i tag skryptu, który wczytuje mapę, odczytuje dane o lokalizacji i sortuje wyniki według odległości. Dostawca mapy, metoda geolokalizacji oraz to, czy kupujący mogą szukać po produkcie, to osobne decyzje nakładane na tę podstawę.

Sprzedawca rzadko pisze ten kod ręcznie. Zwykle generuje go wtyczka, aplikacja albo widżet SaaS, który podaje jeden fragment do wklejenia. Znajomość jego zawartości wciąż się przydaje, bo pokazuje, co można dostosować.

Co faktycznie zawiera ten fragment kodu

Działający lokalizator sklepów składa się z trzech części. Biblioteka mapy renderuje kafelki i pinezki, korzystając z Google Maps, Mapbox, Leaflet z kafelkami OpenStreetMap albo własnego renderera wektorowego dostawcy.

Źródło danych o lokalizacjach podaje adresy i współrzędne jako statyczną tablicę JSON, plik CSV zamieniony na JSON albo żywe wywołanie API. Funkcja odległości, prawie zawsze wzór haversine na szerokości i długości geograficznej, sortuje lokalizacje według odległości od kupującego.

Geolokalizacja potrzebuje planu B, nie tylko pytania o zgodę

Lokalizator może znaleźć kupującego dwoma sposobami. Geolokalizacja przeglądarki pyta o zgodę i zwraca precyzyjną pozycję urządzenia, a szacowanie na podstawie adresu IP pomija to pytanie i zwraca zamiast tego przybliżenie na poziomie miasta.

Kupujący, którzy odmówią tej zgody, wciąż oczekują działającego wyszukiwania "w pobliżu" na telefonie. Praktycznym rozwiązaniem jest przejście na szacowanie po adresie IP albo ręczne wyszukiwanie adresu, gdy kupujący odmówi zgody.

Gdzie faktycznie wklejasz kod, według platformy

Na Shopify sprzedawcy rzadko wklejają HTML. Architektura motywu renderuje treści zewnętrznych aplikacji przez app blocks, które pozwalają aplikacji dodać treść do motywu bez edycji jego kodu, więc lokalizator instaluje się jako blok, a nie wklejony fragment.

WordPress działa przez swój Edytor blokowy: krótki kod umieszczony w dowolnym bloku renderuje lokalizator na danej stronie, bez HTML. Nasz poradnik o WordPressie krok po kroku pokazuje pełną konfigurację jednej wtyczki.

Blok kodu Squarespace to udokumentowane miejsce na własny HTML, choć JavaScript i ramki iframe wewnątrz niego wymagają planu Core lub wyższego. Wix z kolei oferuje element Embed HTML do wklejenia fragmentu albo aplikację lokalizatora z App Market; nasz poradnik o Wix opisuje tę ścieżkę.

Wiele innych kreatorów stron, w tym Webflow, BigCommerce i Elementor, ma podobny element do osadzania kodu lub HTML w tym samym celu.

Lista kontrolna przed budową, własny kod albo widżet

Wybór między własną budową a gotowym widżetem sprowadza się do czterech sprawdzeń:

  1. Sprawdź, gdzie Twoja platforma pozwala dodać własny kod: blok, element albo instalację aplikacji.
  2. Sprawdź osobno potrzeby dotyczące klucza dostawcy mapy; Google Maps i Mapbox wymagają własnych danych uwierzytelniających sprzedawcy, a Google Maps wymaga też konta rozliczeniowego.
  3. Zdecyduj, jak dane o lokalizacjach mają być aktualne: ręczne edycje, synchronizowany arkusz albo żywy kanał z Twojej platformy e-commerce.
  4. Przetestuj geolokalizację na prawdziwym telefonie z odmówioną zgodą, nie tylko z udzieloną, bo to tam wyszukiwanie "w pobliżu" zwykle zawodzi.

Czego faktycznie wymaga wyszukiwanie na poziomie produktu

Lokalizator sklepów znajduje miejsce. Lokalizator produktów odpowiada na węższe pytanie, które z Twoich lokalizacji ma teraz konkretny produkt, a to wymaga danych o zapasach przypisanych do każdej lokalizacji, nie tylko mapy.

WymaganieCo to robiŹródło w Shopify
Rekordy lokalizacjiSklep lub punkt odbioruLocation object
Zapasy per lokalizacjaStan na produktinventoryLevels
Filtr produktuPokaż produkt dostępnystoreAvailability

Wiersze lokalizacji i zapasów pochodzą z własnego Location API Shopify i istnieją niezależnie od tego, jaką aplikację zainstalujesz. Dostępność danego wariantu per lokalizacja jest też natywnie udostępniona przez pole storeAvailability w Storefront API, zbudowane dla odbioru w sklepie, choć zmiana tego w filtr mapy to wciąż zadanie aplikacji.

Zadaj dostawcy dwa pytania, zanim się zdecydujesz:

  1. Czy dostępność produktu aktualizuje się automatycznie na podstawie zapasów, czy ktoś to ręcznie utrzymuje?
  2. Co pokazuje strona, gdy każda bliska lokalizacja jest wyprzedana?

Podsumowanie

Lokalizator sklepów jest gotowy, gdy mapa wczytuje się czysto, test geolokalizacji z odmówioną zgodą wciąż zwraca pobliskie wyniki, a wyszukiwanie produktu, jeśli je zbudowałeś, wyklucza lokalizację, o której wiesz, że jest wyprzedana. Wszystko poza tym to dopracowywanie.

Większość tej decyzji dotyczy danych, nie wzornictwa: gdzie mieszkają Twoje lokalizacje, jak świeże pozostają i czy dostępność produktu jest śledzona gdzieś blisko czasu rzeczywistego. Zrób to dobrze najpierw, a mapa pod tym jest łatwą częścią.

Najczęściej zadawane pytania

Czy kod HTML lokalizatora sklepów wymaga klucza API Google Maps?

Tylko jeśli wybierzesz Google Maps, co wymaga własnego klucza API sprzedawcy i konta rozliczeniowego. Mapbox wymaga za to własnego tokenu dostępu, a mapy budowane na danych w stylu OpenStreetMap pomijają klucz całkowicie.

Jaka jest różnica między lokalizatorem sklepów a lokalizatorem produktów?

Lokalizator sklepów pokazuje, gdzie są Twoje lokalizacje. Lokalizator produktów pokazuje, która z tych lokalizacji ma teraz na stanie konkretny produkt, co wymaga danych o zapasach za mapą.

Czy mogę dodać lokalizator sklepów bez pisania kodu?

Tak: aplikacje, wtyczki i widżety SaaS generują ten fragment za Ciebie. Progus Store Locator to jedna z opcji: blok motywu na Shopify, krótki kod na WordPressie, instalacja z App Market na Wix, zarządzana z aplikacji Shopify albo panelu webowego; gdzie indziej to jeden fragment do osadzenia.

Czy geolokalizacja zawsze pyta kupującego o zgodę?

Nie. Szacowanie na podstawie adresu IP może umieścić kupującego na poziomie miasta bez żadnego pytania. To sprawia, że jest rozsądnym planem B dla kupujących, którzy odmawiają zgody w przeglądarce.

Dodaj lokalizator sklepów do swojej strony. Więcej o Store Locator ›