Dealer Locator

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

Dealer Locator probleemoplossing: snelle oplossingen

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

Werkt er iets niet zoals verwacht met de Dealer Locator? Op deze pagina staan de problemen die we het vaakst zien, van een dealerpagina die "pagina niet gevonden" geeft tot dealers die niet op de kaart staan, een Google-sleutel die geweigerd wordt of een import die stopt met het opzoeken van coördinaten. Begin met de snelle controles om het probleem af te bakenen en ga dan naar het bijbehorende onderwerp voor de oorzaak en de oplossing. Onderaan lees je hoe je debuglogging aanzet en wat de logbestanden je vertellen. De meeste problemen komen neer op een instelling, een adres of een API-sleutel, en zijn zonder ontwikkelaar vanuit de admin op te lossen.

Veelvoorkomende problemen en oplossingen voor de Dealer Locator.

Snelle controles

  1. Controleer of Ingeschakeld op Ja staat onder Winkels → Configuratie → Magmodules → Dealer Locator → Algemeen, voor de store view die je test.
  2. Leeg de cache onder Systeem → Cachebeheer.
  3. Klik op Zelftest uitvoeren in de sectie Branding van de configuratie: die controleert de kaartaanbieder, de API-sleutels, het opzoeken van een testadres en het aantal dealers.
  4. Controleer de dealer-grid op Op kaart: Nee en Actief: Nee.
  5. Bekijk de logs: var/log/dealer-locator-error.log en, met debugmodus aan, var/log/dealer-locator-debug.log.

Veelvoorkomende problemen

Probleem: de dealerpagina geeft "pagina niet gevonden"

Symptomen:

  • https://example.com/dealers toont de 404-pagina van Magento

Oplossing:

  1. Controleer Ingeschakeld voor deze store view (sectie Algemeen).
  2. Controleer de URL-sleutel onder Pagina & SEO voor deze store view. De pagina staat alleen op dat adres, bijv. service/dealers in plaats van dealers.
  3. Kijk onder Marketing → URL-herschrijvingen of er een herschrijving op hetzelfde adres staat: URL-herschrijvingen worden vóór de dealerpagina afgehandeld en winnen. (Een CMS-pagina met hetzelfde adres is geen probleem: de dealerpagina gaat voor.)
  4. Leeg de cache.

Voorkomen:

  • Pas na het wijzigen van de URL-sleutel ook de links in je menu en footer aan.

Probleem: een dealer ontbreekt in de webwinkel

Symptomen:

  • De dealer staat in de grid in de admin, maar niet in de lijst of op de kaart

Oplossing:

  1. Controleer of Actief op Ja staat.
  2. Controleer Op kaart. Bij "Nee" heeft de dealer geen coördinaten en kan hij niet getoond worden. Open de dealer, controleer het adres en sla op, of gebruik Locatie zoeken in de grid.
  3. Controleer Winkelweergave: de dealer moet gekoppeld zijn aan de store view waar de bezoeker op zit, of aan Alle winkelweergaven.
  4. Is er een categoriefilter gekozen op de pagina? Kies "Alle productcategorieën".

Voorkomen:

  • Filter de grid na elke import op Op kaart: Nee.

Probleem: "Het adres ... is niet gevonden"

Symptomen:

  • Waarschuwing na het opslaan of importeren van een dealer
  • Met Google Maps: "is niet precies gevonden; de beste overeenkomst is ..."

Oplossing:

  1. Controleer de spelling van straat, postcode en plaats, en of het land klopt.
  2. Zet het huisnummer in het straatveld: Domplein 9.
  3. Laat toevoegingen als "Unit 4" of "Bedrijventerrein" weg; die kennen de kaartdiensten vaak niet.
  4. Nog steeds niet gevonden? Vul breedte- en lengtegraad zelf in. Die vind je in elke kaartdienst: klik met rechts op de locatie en kopieer de twee getallen.

Voorkomen:

  • Houd adressen aan in de vorm waarop je een brief zou versturen: straat en huisnummer, postcode, plaats.

Probleem: de kaart laadt niet ("De kaart kon niet worden geladen")

Symptomen:

  • De lijst werkt, maar op de plek van de kaart staat "De kaart kon niet worden geladen. De lijst met dealers werkt wel."

Oplossing:

  1. Met Google Maps: klik op API-sleutel testen onder de Google Maps browser-API-sleutel (Kaart & geocoding). Je ziet per API of de sleutel werkt, en anders de reden van Google. Ook in de ontwikkelaarsconsole van je browser zie je de reden van Google, zoals RefererNotAllowedMapError (de sleutel is niet toegestaan voor dit domein) of ApiNotActivatedMapError (de Maps JavaScript API staat niet aan in Google Cloud).
  2. Controleer of facturering aan staat voor het Google Cloud-project.
  3. Met een Content Security Policy in "restrict"-modus in de webwinkel: de module voegt de domeinen toe die hij nodig heeft, maar een eigen policy kan ze blokkeren. Zoek in de console naar fouten over "Content-Security-Policy".

Voorkomen:

  • Voer de zelftest uit nadat je sleutels hebt gewijzigd.

Probleem: in plaats van de kaart staat een melding met "Toon kaart"

Symptomen:

  • Een tekst over het laden van de kaart, met een knop Toon kaart

Oplossing: Dit is de instelling voor cookietoestemming die zijn werk doet: Kaart pas laden na cookietoestemming staat aan en de bezoeker heeft nog geen toestemming gegeven.

  1. Accepteer cookies in de cookiemelding, of klik op Toon kaart, om de kaart te zien.
  2. Gebruik je een andere toestemmingstool dan de cookiemelding van Magento of de banner van Hyvä? Laat die het event dealer-locator:consent-granted versturen als de bezoeker akkoord gaat (zie de best practices).
  3. Geen toestemming nodig voor de kaart? Zet de instelling uit.

Probleem: coördinaten worden niet opgezocht met Google Maps

Symptomen:

  • Bij het opslaan van een dealer verschijnt "Het adres kon niet worden opgezocht: Google Geocoding gaf REQUEST_DENIED: ..."
  • De zelftest faalt op "Check if the geocoding provider responds"

Oplossing:

  1. Klik op API-sleutel testen onder de Google Geocoding server-API-sleutel (Kaart & geocoding), of lees de melding van Google na "REQUEST_DENIED"; daarin staat wat er mis is.
  2. Controleer de Google Geocoding server-API-sleutel. Die moet toegestaan zijn voor het IP-adres van je server, niet beperkt tot je domein (HTTP-referrers): een sleutel die op domein is beperkt, werkt alleen in de browser.
  3. Controleer of de Geocoding API aan staat in het Google Cloud-project en of facturering actief is.

Voorkomen:

  • Gebruik aparte sleutels voor de browser en de server.

Probleem: de import stopte met het opzoeken van coördinaten

Symptomen:

  • Het rapport meldt "Het opzoeken van coördinaten is gestopt na 60 seconden"
  • Na een grote import staan veel dealers op Op kaart: Nee

Oplossing:

  1. Dit is verwacht met OpenStreetMap en grote bestanden: het staat één opzoeking per seconde toe, en de admin stopt na 60 seconden zodat de pagina niet vastloopt.
  2. Filter de grid op Op kaart: Nee, selecteer de dealers en gebruik Locatie zoeken. Herhaal tot ze allemaal klaar zijn.
  3. Of, op de server: bin/magento dealerlocator:geocode, zonder tijdslimiet.

Voorkomen:

  • Gebruik bin/magento dealerlocator:import voor de eerste grote import.

Probleem: importrijen mislukken

Symptomen:

  • Het rapport toont fouten per rij

Oplossing: Veelvoorkomende meldingen en de oplossing:

  • Verplichte kolommen ontbreken: ... - de eerste rij moet de kolomnamen bevatten, minstens code, name en country.
  • Land "..." is geen bekende landcode van twee letters - gebruik codes als NL, BE, DE, geen landnamen.
  • Code "..." staat ook in rij ... - elke dealer mag maar één keer in het bestand staan.
  • Onbekende winkelweergaven: ... - gebruik de codes van de store views uit Winkels → Alle winkels, of all.
  • Onbekende productcategorieën: ... - maak ze eerst aan, of zet Productcategorieën aanmaken die nog niet bestaan aan.
  • Dealercode "..." mag alleen letters, cijfers, "-", "_" en "." bevatten - haal spaties en andere tekens uit de code.

Voorkomen:

  • Voer nieuwe bestanden eerst uit met Alleen controleren, niets opslaan.

Probleem: een bezoeker vindt een plaats in een ander land

Symptomen:

  • Zoeken op een postcode toont dealers gesorteerd vanaf een plaats ver weg

Oplossing:

  1. Stel Zoeken op adres beperken tot landen in op de landen waarin je verkoopt.
  2. Controleer of je dealers het juiste land hebben: als de instelling leeg is, wordt het zoeken beperkt tot de landen van je dealers.

Probleem: wijzigingen zijn niet zichtbaar in de webwinkel

Symptomen:

  • Een opgeslagen dealer of instelling is niet te zien op de pagina

Oplossing:

  1. Wijzigingen aan dealers en categorieën verversen de pagina automatisch. Na wijzigingen in de configuratie moet je de cache legen onder Systeem → Cachebeheer.
  2. Met Varnish of een andere full page cache vóór Magento: leeg die cache ook.
  3. Herlaad de pagina zonder de browsercache (Ctrl+F5 / Cmd+Shift+R).

Debugmodus

Ga naar: Winkels → Configuratie → Magmodules → Dealer Locator → Debug & logging

  • Zet Debugmodus op Ja om extra details te loggen in var/log/dealer-locator-debug.log, zoals adressen die niet gevonden zijn.
  • Fouten worden altijd gelogd in var/log/dealer-locator-error.log, bijvoorbeeld een geweigerde API-sleutel of een kaartdienst die niet bereikbaar was.
  • Met de knoppen in deze sectie bekijk je de laatste regels van beide logs, zonder toegang tot de server.

Voorbeeld van een regel in de foutlog:

[2026-11-10T14:38:01] MagmodulesDealerLocatorError.ERROR: Geocoding D-1003: Google Geocoding returned REQUEST_DENIED: The provided API key is invalid.

De logbestanden zijn in het Engels. Zet debugmodus weer uit als je klaar bent; de log is voor normaal gebruik niet nodig.

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