Dealer Locator

Versie v1.0.0
Platform Magento 2
Module uitgebracht 18 November 2026

Dealer Locator configureren in Magento 2

Op zoek naar Dealer Locator? Bekijk de volledige Dealer Locator pagina voor functies, configuratieopties en prijzen.

Hier vind je alle instellingen van de Dealer Locator, in gewone taal uitgelegd. We volgen de volgorde van het admin panel: de module aanzetten, kiezen tussen OpenStreetMap en Google Maps, het startpunt van de kaart, hoe resultaten worden getoond, het adres van de pagina en de teksten voor zoekmachines, en de privacy-instelling voor cookietoestemming. Per instelling lees je wat die doet en wanneer je hem aanpast, met aanbevelingen waar die echt verschil maken. De meeste winkels passen er maar een handvol aan; de standaardwaarden zijn zo gekozen dat de pagina zonder verdere instellingen werkt. Instellingen die per store view kunnen verschillen, zoals het adres of de titel van de pagina, stel je zoals gewoonlijk in op de scope van de store view.

Volledig overzicht van alle instellingen van de Dealer Locator.

Locatie: Winkels → Configuratie → Magmodules → Dealer Locator

Branding

Toont de geïnstalleerde versie en heeft knoppen voor de zelftest en de handleiding. Gebruik Zelftest uitvoeren nadat je de kaartinstellingen hebt aangepast: die controleert of de gekozen kaartaanbieder de sleutels heeft die hij nodig heeft, of het opzoeken van een adres werkt en hoeveel dealers de pagina moet tonen.

Algemeen

Ingeschakeld

Zet de dealerpagina in de webwinkel aan of uit. Zolang hij uit staat, geeft het adres van de pagina een "pagina niet gevonden", maar je kunt in de admin al wel dealers beheren en importeren.

Kaart & geocoding

"Geocoding" betekent een adres omzetten naar coördinaten op de kaart. De module doet dat op twee plekken: in de admin, als je een dealer opslaat of importeert, en in de browser van de bezoeker, als die een plaats zoekt.

Kaartaanbieder

Welke dienst de kaart tekent en adressen opzoekt.

  • OpenStreetMap (gratis, geen API-sleutel): werkt direct na installatie. Adressen worden opgezocht via de Nominatim-dienst van OpenStreetMap, die één opzoeking per seconde toestaat. Dat is ruim genoeg voor zoekende bezoekers, maar maakt grote imports trager (zie de importhandleiding).
  • Google Maps (API-sleutel nodig): de bekende Google-kaart en de zoekfunctie van Google. Je hebt een Google Cloud-project met facturering nodig en twee sleutels (hieronder). Google geeft een gratis gebruikstegoed per maand; bekijk de actuele prijzen van Google voor jouw verwachte bezoekersaantal.

Wanneer gebruiken:

  • OpenStreetMap: je wilt direct beginnen, geen kosten maken of liever geen Google gebruiken.
  • Google Maps: je wilt de kaartstijl en zoekkwaliteit van Google, of je klanten verwachten het.

Google Maps browser-API-sleutel

Alleen zichtbaar bij Google Maps. Wordt gebruikt door de kaart en het zoeken op plaats in de browser van de bezoeker. Omdat de browser hem nodig heeft, is deze sleutel zichtbaar in de broncode van je pagina; dat is normaal bij Google Maps, zolang je hem beperkt.

Aanbevolen:

  • Beperk hem in Google Cloud tot het domein van je winkel (HTTP-referrers, bijv. https://example.com/*)
  • Sta alleen de Maps JavaScript API en de Geocoding API toe
  • Vul hier nooit de serversleutel in: iedereen kan deze sleutel uit de broncode van je pagina kopiëren

API-sleutel testen: controleert de sleutel in het veld, ook voordat je opslaat. Je browser laadt de Maps JavaScript API en doet één zoekopdracht op adres met de sleutel, en de server controleert of de sleutel beperkt is tot websites. Elk onderdeel toont OK of de reden van Google, zoals een domein dat niet is toegestaan of een API die niet aanstaat. Draait je admin op een ander domein dan je winkel, dan mislukt het browserdeel hier voor een sleutel die beperkt is tot het winkeldomein; dat staat dan in het resultaat.

Google Geocoding server-API-sleutel

Alleen zichtbaar bij Google Maps. Wordt door Magento zelf gebruikt om de coördinaten van dealers op te zoeken als je dealers opslaat of importeert. Hij wordt versleuteld opgeslagen en nooit naar de browser gestuurd.

Aanbevolen:

  • Beperk hem tot het IP-adres van je server en alleen de Geocoding API
  • Gebruik een andere sleutel dan de browsersleutel: een sleutel die beperkt is tot je domein (HTTP-referrers) werkt niet vanaf de server

API-sleutel testen: stuurt vanaf je server één verzoek naar de Geocoding API met de sleutel in het veld (of de opgeslagen sleutel, zolang het veld sterretjes toont) en toont het antwoord van Google.

Contact-e-mailadres voor Nominatim

Alleen zichtbaar bij OpenStreetMap. Optioneel e-mailadres dat wordt meegestuurd met het opzoeken van adressen, zodat het OpenStreetMap-team contact met je kan opnemen als je winkel opvallend veel verzoeken stuurt, zoals hun gebruiksvoorwaarden vragen. Bezoekers zien het niet.

Standaard breedtegraad / lengtegraad van het kaartmidden

Waar het midden van de kaart ligt voordat een bezoeker zoekt, zodra de pagina opent. Standaard is dat het midden van Nederland. Zodra de dealers geladen zijn, zoomt de kaart in op de dealers in de lijst; dit is dus vooral van belang als er nog geen dealers zijn of de kaart er geen kan tonen.

Voorbeeld: België: 50.5039 en 4.4699. Duitsland: 51.1657 en 10.4515.

Standaard zoomniveau

Hoe ver de kaart op dat startpunt is ingezoomd, van 1 (hele wereld) tot 20 (straatniveau). Met 7 zie je een land zo groot als Nederland; gebruik 5 of 6 voor Duitsland of Frankrijk.

Zoeken op adres beperken tot landen

Beperkt het zoeken op plaats door bezoekers tot deze landen. Dat is belangrijk bij korte of dubbelzinnige invoer: "9711" is een postcode in Groningen, maar bestaat ook in andere landen.

Wanneer gebruiken:

  • Je verkoopt in een paar landen en wilt dat zoekopdrachten daarbinnen blijven.

Laat je het leeg, dan beperkt de pagina het zoeken tot de landen waar je dealers zitten (als dat er maximaal 5 zijn), en dat is meestal precies wat je wilt. Google Maps accepteert maximaal 5 landen; met meer landen wordt de instelling niet opgeslagen als Google gekozen is.

Resultaten

Resultaten per pagina

Hoeveel dealers de lijst toont vóór de knop Toon meer. Elke klik toont er weer zoveel bij.

Afstandseenheid

Kilometer of mijl voor de afstanden in de lijst. Je kunt dit per store view instellen, bijvoorbeeld mijl voor een Britse store view.

Pagina & SEO

URL-sleutel

Het adres van de dealerpagina na de URL van je winkel. Met dealers staat de pagina op https://example.com/dealers. Je kunt een genest adres gebruiken, zoals service/dealers, en per store view een andere sleutel, bijvoorbeeld dealers in het Engels en winkels in het Nederlands. Alleen kleine letters, cijfers, "-" en "_" zijn toegestaan, met "/" tussen de delen.

Tip: De pagina is ook bereikbaar op /dealerlocator; zoekmachines worden met een canonical link naar jouw URL-sleutel verwezen, dus er ontstaat geen dubbele content.

Paginatitel

De kop op de pagina. Als dit leeg is, toont de pagina "Vind een dealer", vertaald in de taal van de store view. Je hebt dit dus alleen nodig als je een andere tekst wilt.

Metatitel

De titel in het tabblad van de browser en in zoekresultaten. Als dit leeg is, wordt de paginatitel gebruikt.

Metabeschrijving

De korte tekst die zoekmachines onder de titel van je pagina tonen. Vertel wat bezoekers er vinden, bijvoorbeeld "Vind een [merk]-dealer bij jou in de buurt, met adres, telefoonnummer en route." Houd het onder ongeveer 160 tekens.

Privacy

Kaart pas laden na cookietoestemming

Als de kaart laadt, ontvangt de kaartaanbieder (Google of OpenStreetMap) het IP-adres van de bezoeker, en Google kan cookies plaatsen. Met deze instelling aan wacht de kaart tot de bezoeker toestemming geeft. Tot die tijd staat er een korte melding met een knop Toon kaart op de plek van de kaart, en kunnen bezoekers gewoon zoeken: de lijst zoekt dan op naam, plaats en postcode van de dealers.

De kaart start zodra een van deze dingen gebeurt:

  • De bezoeker accepteert cookies in de eigen cookiemelding van Magento (Cookie Restriction Mode)
  • De bezoeker accepteert cookies in de cookiebanner van Hyvä
  • De bezoeker klikt op Toon kaart
  • Een andere toestemmingstool verstuurt het event dealer-locator:consent-granted op window (je ontwikkelaar kan dat toevoegen aan de "geaccepteerd"-callback van je toestemmingstool)

Aanbevolen:

  • Aan, voor winkels in de EU die toestemming vragen voor diensten van derden
  • Uit, als je toestemmingstool de pagina al blokkeert of je geen toestemming vraagt voor kaarten

Debug & logging

Debugmodus

Schrijft extra details naar var/log/dealer-locator-debug.log, zoals adressen die de kaartaanbieder niet kon vinden. Fouten, zoals een geweigerde API-sleutel, worden altijd geschreven naar var/log/dealer-locator-error.log. Met de knoppen in deze sectie bekijk je de laatste regels van beide logs in de admin.

Meer Hulp Nodig?

Documentatie:

Support:

Voor een compleet overzicht van functies en configuratieopties, bekijk Dealer Locator.

Artikel bijgewerkt:
Download PDF
star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025