NutzungsvoraussetzungenFür die Nutzung dieses Plugins ist ein Google Cloud-Konto erforderlich, um die Google Maps API verwenden zu können.
Bitte beachten Sie, dass die Nutzung der Google Maps API Kosten verursachen kann - wir empfehlen daher, Budgets festzulegen, um unerwartete Ausgaben zu vermeiden.
Für die Einrichtung des Plugins ist ein Google Maps API Key erforderlich: API-Schlüssel erstellen
Systemvoraussetzungen
- JTL Shop 5.2 oder höher
- PHP 8.1 oder höher
Installation & EinrichtungInstallation & Einrichtung
Die Installation des Plugins erfolgt einfach über den JTL Extension Store bzw. die Plugin Verwaltung im Shop Backend.
Google Maps API Key Konfiguration
Nach der Installation des Plugins müssen Sie Ihren Google Maps API Key in den Einstellungen des Plugins hinterlegen. Anleitung von Google: API-Schlüssel erstellen
Beachten Sie bitte den Hinweis zur Sicherheit Ihres API Keys!
Erforderliche APIs:
- Directions API
- Distance Matrix API
- Maps JavaScript API
- Places API
- Places API (New)
Hinzufügen und Verwalten von Standorten
Neue Standorte hinzufügen
Um neue Standorte zu Ihrem Store Locator hinzuzufügen, navigieren Sie zum Reiter Locations und verwenden Sie das Textfeld. Sie können dort manuell Einträge eingeben oder auch die Inhalte einer CSV-Datei direkt in das Textfeld einfügen, um die Standorte darüber zu suchen. Geben Sie pro Zeile einen Eintrag ein.
Möchten Sie Daten aus einer CSV Datei einfügen, die Sie bspw. über die JTL Ameise erstellt haben, empfehlen wir die Felder Firmenname, Stadt, Land, und optional Straße zu verwenden. Verzichten Sie auf überflüssige Informationen, damit die Google Maps API den Eintrag eindeutig zuordnen kann.
Überprüfung der Standorte
Sollte bei der Suche kein eindeutiger Eintrag gefunden werden können, überprüfen Sie die Eingaben durch eine Suche auf Google Maps. Stellen Sie sicher, dass ein eindeutiges Ergebnis erscheint - eine "Teilübereinstimmung" ist nicht ausreichend.
Exportieren und Importieren von Standorten
Über den Reiter Import/Export können Sie vorhandene Standorte exportieren und die Daten in Excel oder einem ähnlichen Programm bearbeiten. Die bearbeiteten Daten können dann durch die Importfunktion im selben Reiter Import/Export wieder in das System importiert werden. Achten Sie darauf, dass jeder Eintrag eine Place ID und Koordinaten enthalten muss, um erfolgreich importiert werden zu können.
Eigene Links zu Standorten hinzufügen
Um einen eigenen Link zu einem Standort hinzuzufügen, bearbeiten Sie den Eintrag im Locations Tab. Füllen Sie hier die Felder Titel und URL aus. Dies ermöglicht es Ihnen, einen Link zusätzlich zu den Daten aus Google Maps zu hinterlegen, bspw. zu einer Unterseite des Shops.
Anpassen des Kartenstils mit einer Map ID
Die Map ID ermöglicht es Ihnen, benutzerdefinierte Stile für Ihre Google Maps-Integration festzulegen. In der folgenden Anleitung finden Sie die notwendigen Schritte und Links: Map ID erstellen
Legen Sie dazu noch einen Kartenstil an, den Sie mit Ihrer Map ID verknüpfen: Kartenstil anlegen
FAQ
Warum hat meine Karte den alten Stil von Google Maps?
Standardmäßig verwendet Google Maps aktuell noch den klassischen Stil in seiner API. Wenn Sie schon jetzt den neuen Stil verwenden möchten, können Sie dies durch Erstellen eines eigenen Kartenstils und die Verwendung einer Map ID erreichen.
Beim Hinzufügen von Locations bleibt der Fortschritt bei 0%
Der Google Maps API Key ist ungültig oder für die Verwendung mit der Backend-URL nicht freigegeben. Eine konkrete Fehlermeldung der Google Maps API finden Sie in der Fehlerkonsole Ihres Browsers.
Hinweise zur Verwendung der Google Maps API
Wichtiger Hinweis zur Sicherheit Ihres API Keys:
Der API Key ist öffentlich einsehbar, sobald er auf Ihrer Webseite integriert ist. Daher ist es unbedingt erforderlich, dass Sie den Zugriff auf den API Key einschränken. Stellen Sie sicher, dass der Key nur für die APIs aktiviert ist, die Sie tatsächlich nutzen, und beschränken Sie den Zugriff auf URLs, die Ihrer Website zugeordnet sind. Diese Sicherheitsmaßnahme verhindert den Missbrauch Ihres API Keys durch Dritte.
Kostenhinweis:
Die Verwendung der Google Maps APIs kann Kosten verursachen. Diese Kosten variieren je nach Anzahl der API-Anfragen und der spezifischen Nutzung der verschiedenen Dienste. Wir raten Ihnen dringend, die entstehenden Kosten regelmäßig zu überwachen und geeignete Budgetgrenzen festzulegen. Dies kann durch die Konfiguration von Budgetwarnungen und -limits in Ihrem Google Cloud Console Konto erfolgen. Informieren Sie sich regelmäßig über die aktuellen Preise und Konditionen auf der offiziellen Google Maps Plattform Preisseite, um unerwartete Kosten zu vermeiden. Hier sind einige der wichtigsten APIs und deren Kostenfaktoren:
- Maps JavaScript API:
- SKU: Dynamic Maps – Wird verwendet, um eine Karte anzuzeigen.
- Places API:
- SKU: Autocomplete (inklusive Place Details) – Pro Sitzung – Autocomplete hilft Nutzern, ihren Standort zu spezifizieren.
- SKU: Place Details – Zeigt detaillierte Informationen zu einem ausgewählten Standort.
- SKU: Find Place – Fallback-Abfrage.
- SKU: Basic Data, Contact Data, Atmosphere Data, Place Photo – Verschiedene Datenaspekte und Fotos von Orten.
- Directions API:
- SKU: Directions – Zeigt eine Route von der Position des Nutzers zu einem ausgewählten Standort.
- Distance Matrix API:
- SKU: Distance Matrix – Wird verwendet, um Reisezeiten von der Position des Nutzers zu sortieren und anzuzeigen.
Eine detaillierte Aufstellung der Preise pro SKU finden Sie unter Google Maps Preise
Haftungsausschluss
Bitte beachten Sie, dass die Nutzung dieses Plugins mit der Verarbeitung personenbezogener Daten verbunden sein kann, insbesondere wenn Standortdaten Ihrer Nutzer erfasst werden. Es ist Ihre Verantwortung, die Nutzung des Plugins im Einklang mit der Datenschutz-Grundverordnung (DSGVO) zu gewährleisten. Wir empfehlen, eine Datenschutz-Folgenabschätzung durchzuführen und gegebenenfalls Ihren Datenschutzbeauftragten zu konsultieren.
Darüber hinaus können durch die Nutzung der Google Maps APIs Kosten entstehen. Diese Kosten variieren je nach Anzahl der API-Anfragen und der spezifischen Nutzung der verschiedenen Dienste. Wir raten Ihnen dringend, die entstehenden Kosten regelmäßig zu überwachen und geeignete Budgetgrenzen festzulegen. Dies kann durch die Konfiguration von Budgetwarnungen und -limits in Ihrem Google Cloud Console Konto erfolgen. Informieren Sie sich regelmäßig über die aktuellen Preise und Konditionen auf der offiziellen Google Maps Plattform Preisseite, um unerwartete Kosten zu vermeiden.
Wir setzen alles daran, Ihnen mit unserem Plugin eine wertvolle Unterstützung zu bieten, und hoffen, dass es Ihren Anforderungen gerecht wird. Bei Fragen oder Unsicherheiten bezüglich der DSGVO-Konformität oder der Kostenverwaltung stehen wir Ihnen gerne zur Verfügung.
