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
- Controleer of Ingeschakeld op Ja staat onder Winkels → Configuratie → Magmodules → Dealer Locator → Algemeen, voor de store view die je test.
- Leeg de cache onder Systeem → Cachebeheer.
- 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.
- Controleer de dealer-grid op Op kaart: Nee en Actief: Nee.
- Bekijk de logs:
var/log/dealer-locator-error.logen, met debugmodus aan,var/log/dealer-locator-debug.log.
Veelvoorkomende problemen
Probleem: de dealerpagina geeft "pagina niet gevonden"
Symptomen:
https://example.com/dealerstoont de 404-pagina van Magento
Oplossing:
- Controleer Ingeschakeld voor deze store view (sectie Algemeen).
- Controleer de URL-sleutel onder Pagina & SEO voor deze store view. De pagina staat alleen op dat adres, bijv.
service/dealersin plaats vandealers. - 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.)
- 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:
- Controleer of Actief op Ja staat.
- 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.
- Controleer Winkelweergave: de dealer moet gekoppeld zijn aan de store view waar de bezoeker op zit, of aan Alle winkelweergaven.
- 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:
- Controleer de spelling van straat, postcode en plaats, en of het land klopt.
- Zet het huisnummer in het straatveld:
Domplein 9. - Laat toevoegingen als "Unit 4" of "Bedrijventerrein" weg; die kennen de kaartdiensten vaak niet.
- 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:
- 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) ofApiNotActivatedMapError(de Maps JavaScript API staat niet aan in Google Cloud). - Controleer of facturering aan staat voor het Google Cloud-project.
- 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.
- Accepteer cookies in de cookiemelding, of klik op Toon kaart, om de kaart te zien.
- Gebruik je een andere toestemmingstool dan de cookiemelding van Magento of de banner van Hyvä? Laat die het event
dealer-locator:consent-grantedversturen als de bezoeker akkoord gaat (zie de best practices). - 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:
- 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.
- 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.
- 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:
- 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.
- Filter de grid op Op kaart: Nee, selecteer de dealers en gebruik Locatie zoeken. Herhaal tot ze allemaal klaar zijn.
- Of, op de server:
bin/magento dealerlocator:geocode, zonder tijdslimiet.
Voorkomen:
- Gebruik
bin/magento dealerlocator:importvoor 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,nameencountry. - 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:
- Stel Zoeken op adres beperken tot landen in op de landen waarin je verkoopt.
- 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:
- Wijzigingen aan dealers en categorieën verversen de pagina automatisch. Na wijzigingen in de configuratie moet je de cache legen onder Systeem → Cachebeheer.
- Met Varnish of een andere full page cache vóór Magento: leeg die cache ook.
- 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:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team
Voor een compleet overzicht van functies en configuratieopties, bekijk Dealer Locator.