9 min leestijd Store Locator
HTML-code voor een store locator: wat het kost
Een duidelijke uitleg van wat de HTML-code van een store locator echt bevat, hoe geolocatie en productzoeken daarin passen, en waar je hem plakt op elk platform.
HTML-code voor een store locator is een klein embed: een containerelement plus een scripttag die een kaart laadt, je locatiegegevens leest en de resultaten op afstand sorteert. De kaartaanbieder, de geolocatiemethode en of shoppers op product kunnen zoeken, zijn losse keuzes die op deze basis worden gestapeld.
Een winkelier schrijft deze code zelden met de hand. Meestal genereert een plugin, app of SaaS-widget hem en geeft je een enkel fragment om te plakken. Weten wat erin staat helpt toch, omdat het laat zien wat je kunt aanpassen.
Wat het fragment daadwerkelijk bevat
Drie onderdelen vormen een werkende store locator. Een kaartbibliotheek rendert tiles en pins, met Google Maps, Mapbox, Leaflet met OpenStreetMap-tiles, of de eigen vector-renderer van een aanbieder.
Een locatiegegevensbron levert adressen en coordinaten, als statische JSON-array, een naar JSON omgezet CSV-bestand, of een live API-aanroep. Een afstandsfunctie, bijna altijd de haversineformule op breedte- en lengtegraad, sorteert locaties op hoe ver ze van de shopper af liggen.
Geolocatie heeft een terugvalplan nodig, niet alleen een vraag
Een locator kan de shopper op twee manieren vinden. Browsergeolocatie vraagt toestemming en geeft een precieze apparaatpositie terug, terwijl een IP-gebaseerde schatting die vraag overslaat en in plaats daarvan een schatting op stadsniveau teruggeeft.
Shoppers die die vraag weigeren, verwachten toch een werkende "bij mij in de buurt"-zoekfunctie op mobiel. Een praktische oplossing is terug te vallen op een IP-gebaseerde schatting of een handmatige adreszoekopdracht wanneer de shopper de vraag weigert.
Waar je de code daadwerkelijk plakt, per platform
Op Shopify plakken winkeliers zelden HTML. De themearchitectuur rendert content van apps van derden via app blocks, waarmee een app content aan een thema kan toevoegen zonder de themecode te bewerken, zodat een locator als blok wordt geïnstalleerd in plaats van als gekopieerd fragment.
WordPress werkt in plaats daarvan via zijn Blokeditor: een shortcode die je in een willekeurig blok plaatst, rendert de locator op die pagina, zonder HTML. Onze WordPress-gids doorloopt de volledige installatie van een plugin.
Code Block van Squarespace is de gedocumenteerde plek voor eigen HTML, al hebben JavaScript en iframes daarbinnen het Core-abonnement of hoger nodig. Wix biedt in plaats daarvan een Embed HTML-element voor het plakken van een fragment, of een locator-app uit zijn App Market; onze Wix-gids behandelt die route.
Veel andere sitebouwers, waaronder Webflow, BigCommerce en Elementor, bieden voor hetzelfde doel een vergelijkbaar embed- of HTML-element.
Een checklist voor je begint, zelf bouwen of widget
De keuze tussen zelf bouwen en een kant-en-klare widget komt neer op vier controles:
- Bevestig waar je platform je toestaat eigen code toe te voegen: een blok, een element of een app-installatie.
- Controleer apart de sleutelbehoefte van de kaartaanbieder; Google Maps en Mapbox vragen allebei een eigen credential van de winkelier, en Google Maps vraagt ook een factureringsaccount.
- Besluit hoe locatiegegevens actueel blijven: handmatige bewerkingen, een gesynchroniseerd spreadsheet, of een live feed vanuit je commerceplatform.
- Test geolocatie op een echte telefoon met toestemming geweigerd, niet alleen verleend, want daar faalt "in de buurt"-zoeken meestal.
Wat zoeken op productniveau daadwerkelijk vereist
Een store locator vindt een plek. Een productlocator beantwoordt een nauwere vraag, welke van je locaties nu een specifiek artikel heeft, en dat vereist voorraadgegevens per locatie, niet alleen een kaart.
| Vereiste | Wat het doet | Shopify-bron |
|---|---|---|
| Locatierecords | Winkel of afhaalpunt | Location object |
| Voorraad per locatie | Voorraad per product | inventoryLevels |
| Productfilter | Toon artikel op voorraad | storeAvailability |
De rijen voor locatie en voorraad komen uit Shopify's eigen Location API en bestaan los van welke app je installeert. Beschikbaarheid per locatie voor een variant wordt ook nativief blootgesteld via het storeAvailability-veld van de Storefront API, gebouwd voor afhalen in de winkel, al blijft het omzetten ervan naar een kaartfilter de taak van de app.
Stel een leverancier twee vragen voor je je vastlegt:
- Wordt productbeschikbaarheid automatisch bijgewerkt vanuit de voorraad, of houdt iemand dat handmatig bij?
- Wat toont de pagina als elke nabije locatie uitverkocht is?
Tot slot
Een store locator is klaar als de kaart netjes laadt, een geolocatietest met geweigerde toestemming toch nabije resultaten teruggeeft, en een productzoekfunctie, als je er een hebt gebouwd, een locatie uitsluit waarvan je weet dat die uitverkocht is. Alles daarna is afwerking.
Het grootste deel van deze beslissing draait om data, niet om design: waar je locaties leven, hoe actueel ze blijven, en of productbeschikbaarheid ergens dicht bij realtime wordt bijgehouden. Doe dat eerst goed, en de kaart daaronder wordt het makkelijke deel.
Veelgestelde vragen
Heeft HTML-code voor een store locator een Google Maps API-sleutel nodig?
Alleen als je Google Maps kiest, wat de eigen API-sleutel van de winkelier en een factureringsaccount vereist. Mapbox vereist in plaats daarvan een eigen toegangstoken, terwijl kaarten gebouwd op OpenStreetMap-achtige data helemaal geen sleutel nodig hebben.
Wat is het verschil tussen een store locator en een productlocator?
Een store locator toont waar je locaties zijn. Een productlocator toont welke van die locaties nu een specifiek artikel op voorraad heeft, wat voorraadgegevens achter de kaart vereist.
Kan ik een store locator toevoegen zonder code te schrijven?
Ja: apps, plugins en SaaS-widgets genereren het embed voor je. Progus Store Locator is een optie: een themeblok op Shopify, een shortcode op WordPress, een App Market-installatie op Wix, beheerd vanuit de Shopify-app of het webdashboard; elders is het een enkel embed-fragment.
Vraagt geolocatie altijd toestemming aan de shopper?
Nee. Een IP-gebaseerde schatting kan een shopper op stadsniveau plaatsen zonder enige vraag. Dat maakt het een redelijk terugvalplan voor shoppers die de browservraag weigeren.
Voeg een winkelzoeker toe aan je website. Meer over Store Locator ›