9 min lästid Store Locator

HTML-kod för en butikssökare: vad som krävs

En enkel genomgång av vad HTML-koden för en butikssökare faktiskt innehåller, hur geolokalisering och produktsökning passar in, och var du klistrar in den på varje plattform.

HTML-kod för en butikssökare är ett litet embed: ett container-element plus en skripttagg som laddar en karta, läser dina platsdata och sorterar resultaten efter avstånd. Kartleverantören, geolokaliseringsmetoden och om köpare kan söka efter produkt är separata val som läggs ovanpå den grunden.

En handlare skriver sällan den här koden för hand. Oftast genererar ett tillagg, en app eller en SaaS-widget den och ger dig ett enda utdrag att klistra in. Att veta vad den innehåller hjälper ändå, eftersom det visar vad du kan anpassa.

Vad utdraget faktiskt innehåller

Tre delar utgör en fungerande butikssökare. Ett kartbibliotek ritar upp rutor och nudlar, med Google Maps, Mapbox, Leaflet med OpenStreetMap-rutor, eller en leverantörs egna vektorrenderare.

En källa för platsdata levererar adresser och koordinater, som en statisk JSON-array, en CSV-fil omvandlad till JSON, eller ett API-anrop i realtid. En avståndsfunktion, nästan alltid haversineformeln på latitud och longitud, sorterar platser efter hur långt de ligger från köparen.

Geolokalisering behöver en reservplan, inte bara en fråga

En sökare kan hitta köparen på två sätt. Webbläsarens geolokalisering frågar om tillstånd och ger en exakt enhetsposition, medan en IP-baserad uppskattning hoppar över den frågan och ger en uppskattning på stadsnivå istället.

Köpare som avvisar den frågan förväntar sig trots allt en fungerande "nära mig"-sökning på mobilen. En praktisk lösning är att falla tillbaka på en IP-baserad uppskattning eller en manuell adresssökning när köparen avvisar frågan.

Var du faktiskt klistrar in koden, per plattform

På Shopify klistrar handlare sällan in HTML. Temaarkitekturen visar innehåll från tredjepartsappar via app blocks, som låter en app lägga till innehåll i ett tema utan att redigera temakoden, så en sökare installeras som ett block istället för ett kopierat utdrag.

WordPress fungerar istället via sin blockredigerare: en kortkod placerad i valfritt block visar sökaren på den sidan, utan HTML. Vår WordPress-guide går igenom den fullständiga installationen av ett tillägg.

Code Block i Squarespace är den dokumenterade platsen för egen HTML, även om JavaScript och iframes i den kräver Core-planen eller högre. Wix erbjuder istället ett Embed HTML-element för att klistra in ett utdrag, eller en sökar-app från sin App Market; vår Wix-guide täcker den vägen.

Många andra sidbyggare, inklusive Webflow, BigCommerce och Elementor, erbjuder ett liknande embed- eller HTML-element för samma syfte.

En checklista innan du bygger, egen kod eller widget

Valet mellan en egen lösning och en färdig widget kommer ner till fyra kontroller:

  1. Bekräfta var din plattform låter dig lägga till egen kod: ett block, ett element eller en app-installation.
  2. Kontrollera kartleverantörens nyckelbehov separat; Google Maps och Mapbox kräver båda en egen uppgift från handlaren, och Google Maps kräver dessutom ett faktureringskonto.
  3. Bestäm hur platsdata hålls aktuella: manuella ändringar, ett synkroniserat kalkylblad, eller ett liveflode från din handelsplattform.
  4. Testa geolokalisering på en riktig mobil med tillståndet nekat, inte bara beviljat, eftersom det är där "nära mig"-sökning oftast misslyckas.

Vad sökning på produktnivå faktiskt kräver

En butikssökare hittar en plats. En produktsökare svarar på en snävare fråga, vilken av dina platser som just nu har en specifik vara, och det kräver lagerdata knutna till varje plats, inte bara en karta.

KravVad det görShopify-källa
PlatspostButik eller uthämtningsställeLocation object
Lager per platsLager per produktinventoryLevels
ProduktfilterVisa vara i lagerstoreAvailability

Raderna om plats och lager kommer från Shopifys egen Location API och finns oavsett vilken app du installerar. Tillgänglighet per plats för en variant exponeras också inbyggt via fältet storeAvailability i Storefront API, byggt för uthämtning i butik, även om att omvandla det till ett kartfilter fortfarande är appens jobb.

Ställ två frågor till en leverantör innan du bestämmer dig:

  1. Uppdateras produkttillgänglighet automatiskt från lagret, eller underhåller någon det för hand?
  2. Vad visar sidan när varje närliggande plats är slutsåld?

Sammanfattning

En butikssökare är klar när kartan laddar rent, ett geolokaliseringstest med nekat tillstånd fortfarande ger närliggande resultat, och en produktsökning, om du byggt en, uteslutersäljer en plats du vet är slutsåld. Allt därutöver är finputsning.

Det mesta av det här beslutet handlar om data, inte design: var dina platser bor, hur aktuella de hålls, och om produkttillgänglighet spåras någonstans nära realtid. Gör det rätt först, så blir kartan under den lätta delen.

Vanliga frågor

Behöver HTML-kod för en butikssökare en Google Maps API-nyckel?

Bara om du väljer Google Maps, vilket kräver handlarens egen API-nyckel och ett faktureringskonto. Mapbox kräver istället sin egen åtkomsttoken, medan kartor byggda på OpenStreetMap-liknande data klarar sig helt utan nyckel.

Vad är skillnaden mellan en butikssökare och en produktsökare?

En butikssökare visar var dina platser finns. En produktsökare visar vilken av dessa platser som just nu har en specifik vara i lager, vilket kräver lagerdata bakom kartan.

Kan jag lägga till en butikssökare utan att skriva kod?

Ja: appar, tillägg och SaaS-widgetar genererar embedet för dig. Progus Store Locator är ett alternativ: ett temablock på Shopify, en kortkod på WordPress, en App Market-installation på Wix, hanterad från Shopify-appen eller webbpanelen; överallt annars är det ett enda embed-utdrag.

Frågar geolokalisering alltid köparen om tillstånd?

Nej. En IP-baserad uppskattning kan placera en köpare på stadsnivå utan någon fråga. Det gör den till en rimlig reservplan för köpare som avvisar webbläsarens fråga.

Lägg till en butikssökare på din webbplats. Mer om Store Locator ›