Zum Hauptinhalt springen

Google Maps API einrichten

Scrollengine verwendet Google Maps für die Routenvisualisierung, Adress-Geokodierung und Fahrernavigation. Um die vollständige Kartenfunktionalität zu aktivieren, müssen Sie Ihren Google Maps API-Schlüssel hinzufügen.

Warum Sie einen Google Maps API-Schlüssel benötigen

  • Routendarstellung — Routen auf einer interaktiven Karte visualisieren
  • Adress-Geokodierung — Kundenadressen in Koordinaten umwandeln
  • Entfernungsberechnung — Fahrstrecken für Liefergebühren und Routenoptimierung berechnen
  • Fahrernavigation — Schritt-für-Schritt-Wegbeschreibungen in der mobilen App bereitstellen

Einen Google Maps API-Schlüssel erhalten

  1. Gehen Sie zur Google Cloud Console
  2. Erstellen Sie ein neues Projekt oder wählen Sie ein bestehendes aus
  3. Navigieren Sie zu APIs & Services > Bibliothek
  4. Aktivieren Sie die folgenden APIs:
    • Maps JavaScript API
    • Geocoding API
    • Directions API
    • Distance Matrix API
  5. Gehen Sie zu APIs & Services > Anmeldedaten
  6. Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel
  7. Kopieren Sie den generierten API-Schlüssel

Ihren API-Schlüssel absichern

Beschränken Sie den Schlüssel, um unbefugte Nutzung zu verhindern:

  • Anwendungseinschränkungen — HTTP-Referrer-Einschränkungen auf Ihre Shopify-Domain setzen
  • API-Einschränkungen — Den Schlüssel auf die vier oben genannten APIs beschränken
  • Abrechnungswarnungen — Abrechnungswarnungen in Google Cloud einrichten, um die Nutzung zu überwachen

Den Schlüssel zu Scrollengine hinzufügen

  1. Gehen Sie zu Einstellungen > Integrationen im Scrollengine Dashboard
  2. Finden Sie den Abschnitt Google Maps API
  3. Fügen Sie Ihren API-Schlüssel ein
  4. Klicken Sie auf Überprüfen & Speichern

Scrollengine testet den Schlüssel, um sicherzustellen, dass er gültig ist und die erforderlichen APIs aktiviert sind.

Kosten

Google Maps APIs bieten ein kostenloses Kontingent (in der Regel 200 $/Monat als Guthaben). Für die meisten kleinen bis mittelgroßen Händler deckt dies den normalen Verbrauch ab. Überwachen Sie Ihr Google Cloud Abrechnungs-Dashboard, wenn Sie hohe Volumen verarbeiten.

Fehlerbehebung

ProblemUrsacheLösung
Karte wird nicht geladenUngültiger oder abgelaufener API-SchlüsselÜberprüfen Sie den Schlüssel in der Google Cloud Console
Fehler „API nicht aktiviert"Erforderliche API nicht aktiviertAktivieren Sie alle vier oben genannten APIs
Geokodierung schlägt fehlGeocoding API nicht aktiviert oder Kontingent überschrittenÜberprüfen Sie den API-Status und die Abrechnung in Google Cloud
Routen zeigen gerade LinienDirections API nicht aktiviertAktivieren Sie die Directions API