8 min leestijd Store Locator

Google Maps API-fout herstellen of kaart zonder sleutel

Diagnosticeer de Google Maps API-fout, herstel sleutel of facturering, of stap over op een kaart zonder winkelierssleutel.

Een Google Maps API-fout ontstaat meestal door een ontbrekende of beperkte sleutel, een uitgeschakelde API of facturering die niet is ingeschakeld. Lees eerst de exacte code in de browserconsole en herstel daarna de configuratie of vervang de kaart door een provider die geen eigen API-sleutel vereist.

Vind de exacte Google Maps API-fout

Open de getroffen pagina, de ontwikkelaarstools van de browser en kies Console. Google documenteert het formaat als ‘Google Maps API error: [ERROR CODE]’ en geeft voor elke code een oorzaak en oplossing.

Stel geen diagnose op basis van alleen een lege kaart. Een kaartcontainer zonder hoogte, een geblokkeerd script, een ongeldige sleutel en uitgeschakelde facturering kunnen er hetzelfde uitzien, maar vragen andere oplossingen.

Veelvoorkomende fouten en de juiste controle

BillingNotEnabledMapError

Facturering is niet ingeschakeld voor het Google Cloud-project van de kaart. Schakel dit in en laad de pagina opnieuw. Google vereist facturering en een API-sleutel of OAuth-token voor Maps JavaScript API-aanvragen.

ApiNotActivatedMapError

De Maps JavaScript API is niet ingeschakeld in het project van de sleutel. Schakel deze API in via Google Cloud Console en controleer of de pagina de sleutel uit hetzelfde project laadt.

ApiTargetBlockedMapError

De sleutel mag de vereiste API niet gebruiken. Controleer API-beperkingen en sta Maps JavaScript API toe. Houd beperkingen smal om de sleutel te beschermen, maar neem elke werkelijk gebruikte API op.

RefererNotAllowedMapError

Het huidige websiteadres staat niet in de lijst met toegestane verwijzers. Voeg de productiehost en vereiste subdomeinen toe met het exacte HTTP-referrerpatroon.

InvalidKeyMapError of MissingKeyMapError

De pagina verstuurt een onbekende of geen sleutel. Controleer script-URL, implementatieomgeving, gekopieerde waarde en of een thema of plug-in nog een oudere sleutel invoegt.

Google Maps herstellen of de sleutelafhankelijkheid verwijderen?

Herstel de Google-configuratie als de site Google-specifieke diensten nodig heeft of de fout geïsoleerd en begrepen is. Vervang die wanneer de store locator alleen locatiezoeken, routebeschrijvingen, markeringen en een kaart nodig heeft en het team geen Google Cloud-project en sleutel wil beheren.

Zonder sleutel betekent niet dat elke provider sleutelloos is. In deze locator werken ingebouwde kaarten, twee OpenStreetMap-stijlen en drie Apple Maps-stijlen zonder sleutel van de winkelier. Google Maps en Mapbox blijven optioneel en vereisen diens eigen sleutel.

Kaartopties geverifieerd in de productcode

  • Ingebouwde kaarten: vijf stijlen zonder API-sleutel van de winkelier.
  • OpenStreetMap: twee stijlen zonder API-sleutel van de winkelier.
  • Apple Maps: drie beschikbare stijlen zonder API-sleutel van de winkelier.
  • Google Maps: vier stijlen plus de stijlencatalogus, met de sleutel van de winkelier.
  • Mapbox: zes stijlen, met de sleutel van de winkelier.

Dat zijn tien geverifieerde stijlen zonder sleutel van de winkelier. De eerdere claim van meer dan 23.000 stijlen werd niet door de code ondersteund en is verwijderd.

Een store locator migreren

1. Exporteer en ruim de locatielijst op

Bewaar één rij per locatie en controleer adres, naam, telefoon, openingstijden en website. Verwijder duplicaten vóór de import.

2. Importeer locaties

De productcode ondersteunt CSV, XLS, XLSX, Numbers en Google Sheets als locatiebronnen. Koppel elke bronkolom aan het juiste locatieveld en controleer mislukte rijen.

3. Kies een kaartprovider

Begin met een provider zonder sleutel als je API-beheer wilt verwijderen. Kies Google Maps of Mapbox alleen als hun specifieke kaartervaring nodig is en een sleutel is ingesteld.

4. Vervang de oude locator

Voeg op Shopify het themablok toe. Gebruik op WordPress de shortcode [progus-store-locator]. Wix heeft een eigen app, andere sites kunnen de gehoste insluitcode gebruiken.

5. Test voordat je de oude kaart verwijdert

Test adreszoeken, geolocatie-fallback, mobiele lay-out, routebeschrijvingen, klikken op markeringen en enkele bekende locaties. Houd de vorige locator beschikbaar totdat de vervanger slaagt.

Lees voor een bredere installatiegids de store locator zonder Google Maps API-sleutel.

Prijzen wanneer de kaart geen winkelierssleutel nodig heeft

Het Free-abonnement ondersteunt één locatie. Betaalde Shopify-abonnementen zijn Basic voor 9,99 USD per maand met 100 locaties, Standard voor 19,99 USD met 500 en Premium voor 29,99 USD met 2.000.

Betaalde abonnementen hebben een proefperiode van 14 dagen en jaarlijkse facturering is 10% goedkoper. WordPress en Wix hebben ook Starter voor 3,99 USD per maand met 10 locaties.

Dit zijn abonnementslimieten, geen quota voor kaartladingen. Voor grotere lijsten bestaan hogere abonnementen. Controleer de actuele platformpagina voordat je kiest.

Veelgestelde vragen

Waarom is mijn Google-kaart leeg?

Controleer de browserconsole. De oorzaak kan facturering, een API- of referrerbeperking, een ontbrekende sleutel, een geblokkeerd script of een kaartcontainer zonder hoogte zijn.

Kan ik een store locator zonder Google Maps API-sleutel gebruiken?

Ja. Kies een provider die geen eigen sleutel vereist. Ingebouwde opties, OpenStreetMap en Apple Maps bieden hier tien geverifieerde stijlen zonder sleutel.

Kan ik Google Maps als optie behouden?

Ja. Google Maps blijft beschikbaar, maar vereist je eigen Google Maps API-sleutel en correct ingestelde facturering en beperkingen.

Kan ik mijn huidige locaties importeren?

Ja. Geverifieerde importformaten zijn CSV, XLS, XLSX, Numbers en Google Sheets.

Werkt dezelfde locator buiten Shopify?

Ja. Geverifieerde routes omvatten Shopify, WordPress, Wix en een gehoste insluiting voor andere websites.

Tot slot

Identificeer eerst de exacte consolefout. Als Google Cloud niet nodig is voor de locator, biedt de Store Locator-app geverifieerde kaarten zonder sleutel en een gratis abonnement voor één locatie.

Toon je winkels op een kaart zonder Google Maps API. Meer over Store Locator ›