8 Min. Lesezeit Store Locator
Google Maps API-Fehler beheben oder Karte ohne Schlüssel
Diagnostiziere den Google Maps API-Fehler, korrigiere Schlüssel oder Abrechnung oder wechsle zu einer Karte ohne Händlerschlüssel.
Ein Google Maps API-Fehler entsteht meist durch einen fehlenden oder eingeschränkten Schlüssel, eine deaktivierte API oder eine nicht aktivierte Abrechnung. Lies zuerst den genauen Code in der Browserkonsole und korrigiere dann die Konfiguration oder nutze einen Kartenanbieter, der keinen eigenen API-Schlüssel verlangt.
Den genauen Google Maps API-Fehler finden
Diagnostiziere nicht nur anhand einer leeren Karte. Ein Kartencontainer ohne Höhe, ein blockiertes Skript, ein ungültiger Schlüssel und eine deaktivierte Abrechnung können gleich aussehen, erfordern aber andere Lösungen.
Häufige Fehler und die richtige Prüfung
BillingNotEnabledMapError
ApiNotActivatedMapError
Die Maps JavaScript API ist im Projekt des Schlüssels nicht aktiviert. Aktiviere sie in der Google Cloud Console und prüfe, ob die Seite den Schlüssel desselben Projekts lädt.
ApiTargetBlockedMapError
Der Schlüssel darf die benötigte API nicht verwenden. Prüfe die API-Einschränkungen und erlaube die Maps JavaScript API. Halte die Einschränkungen zum Schutz des Schlüssels eng, aber schließe jede tatsächlich aufgerufene API ein.
RefererNotAllowedMapError
Die aktuelle Website-Adresse steht nicht in der Liste erlaubter Referrer. Füge den Produktionshostnamen und nötige Subdomains mit dem genauen HTTP-Referrer-Muster hinzu.
InvalidKeyMapError oder MissingKeyMapError
Die Seite sendet einen unbekannten oder keinen Schlüssel. Prüfe Skript-URL, Bereitstellungsumgebung, kopierten Wert und ob ein Theme oder Plugin noch einen alten Schlüssel einfügt.
Google Maps reparieren oder die Schlüsselabhängigkeit entfernen?
Repariere die bestehende Google-Konfiguration, wenn die Website Google-spezifische Dienste braucht oder der Fehler isoliert und verstanden ist. Ersetze sie, wenn der Store Locator nur Standortsuche, Routen, Marker und eine Karte braucht und das Team kein Google Cloud-Projekt samt Schlüssel verwalten will.
Eine Einrichtung ohne Schlüssel bedeutet nicht, dass jeder Anbieter schlüssellos ist. In diesem Locator funktionieren integrierte Karten, zwei OpenStreetMap-Stile und drei Apple Maps-Stile ohne Händlerschlüssel. Google Maps und Mapbox bleiben optional und benötigen den eigenen Schlüssel des Händlers.
Im Produktcode geprüfte Kartenoptionen
- Integrierte Karten: fünf Stile ohne Händler-API-Schlüssel.
- OpenStreetMap: zwei Stile ohne Händler-API-Schlüssel.
- Apple Maps: drei derzeit verfügbare Stile ohne Händler-API-Schlüssel.
- Google Maps: vier Stile plus Stilkatalog mit Händlerschlüssel.
- Mapbox: sechs Stile mit Händlerschlüssel.
Das sind zehn geprüfte Stile ohne Händlerschlüssel. Die frühere Angabe von über 23.000 Stilen war nicht durch den Code belegt und wurde entfernt.
Einen Store Locator migrieren
1. Standortliste exportieren und bereinigen
Behalte eine Zeile je Standort und prüfe Adresse, Name, Telefon, Öffnungszeiten und Website. Entferne Duplikate vor dem Import.
2. Standorte importieren
Der Produktcode unterstützt CSV-, XLS-, XLSX- und Numbers-Dateien sowie Google Sheets als Standortquellen. Ordne jede Quellspalte dem passenden Standortfeld zu und prüfe fehlgeschlagene Zeilen.
3. Kartenanbieter wählen
Beginne mit einem Anbieter ohne Schlüssel, wenn du die API-Verwaltung abschaffen willst. Wähle Google Maps oder Mapbox nur, wenn deren spezielle Kartendarstellung nötig und ein Schlüssel eingerichtet ist.
4. Alten Locator ersetzen
Füge bei Shopify den Theme-Block hinzu. Nutze bei WordPress den Shortcode [progus-store-locator]. Wix hat eine eigene App, andere Websites können den gehosteten Einbettungscode verwenden.
5. Vor dem Entfernen der alten Karte testen
Teste Adresssuche, Geolokalisierungs-Fallback, mobile Darstellung, Routen, Markerklicks und mehrere bekannte Standorte. Lass den bisherigen Locator verfügbar, bis der Ersatz diese Prüfungen besteht.
Eine umfassendere Anleitung bietet der Store Locator ohne Google Maps API-Schlüssel.
Preise, wenn die Karte keinen Händlerschlüssel braucht
Der Free-Tarif unterstützt einen Standort. Bezahlte Shopify-Tarife sind Basic für 9,99 USD monatlich mit 100 Standorten, Standard für 19,99 USD mit 500 und Premium für 29,99 USD mit 2.000.
Bezahlte Tarife haben eine 14-tägige Testphase, die jährliche Abrechnung ist 10 % günstiger. WordPress und Wix bieten außerdem Starter für 3,99 USD monatlich mit 10 Standorten.
Dies sind Tarifgrenzen der Anwendung, keine Kartenlade-Kontingente. Für größere Standortlisten gibt es höhere Tarife. Prüfe vor der Wahl die aktuelle Plattformseite.
FAQ
Warum ist meine Google-Karte leer?
Prüfe die Browserkonsole. Ursache können Abrechnung, API- oder Referrer-Einschränkungen, ein fehlender Schlüssel, ein blockiertes Skript oder ein Kartencontainer ohne Höhe sein.
Kann ich einen Store Locator ohne Google Maps API-Schlüssel nutzen?
Ja. Wähle einen Anbieter, der keinen eigenen Schlüssel verlangt. Die integrierten Optionen, OpenStreetMap und Apple Maps bieten hier zehn geprüfte schlüssellose Stile.
Kann Google Maps eine Option bleiben?
Ja. Google Maps bleibt verfügbar, benötigt aber einen eigenen Google Maps API-Schlüssel sowie korrekt konfigurierte Abrechnung und Einschränkungen.
Kann ich meine bestehenden Standorte importieren?
Ja. Geprüfte Importformate sind CSV, XLS, XLSX, Numbers und Google Sheets.
Funktioniert derselbe Locator außerhalb von Shopify?
Ja. Geprüfte Wege umfassen Shopify, WordPress, Wix und eine gehostete Einbettung für andere Websites.
Fazit
Filialen auf der Karte zeigen, ohne Google Maps API. Mehr zu Store Locator ›