Zum Hauptinhalt springen

Google Location Portlet

Google Maps, Google Business-Profil & Bewertungen als Portlet für den JTL Shop​

Installation & 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 (s.u.)!

Erforderliche APIs:

  • Maps JavaScript API
  • Places API
  • Places API (New)

Hinzufügen von Standorten​

Fügen Sie einfach das Portlet "Google-Location" auf einer beliebigen Seite über den OPC (On Page Composer) ein. In den Einstellungen des Portlets können Sie dann nach dem gewünschten Standort suchen. Alle Einstellungen zu Größe, Darstellung etc. finden Sie ebenfalls direkt in den Portlet Einstellungen.

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.

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) – finden von Standorten
    • 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.

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.