Google-Maps-API-Schlüssel

Aktivieren Sie die Google-Karte und die Google-Adressvervollständigung in Ihrem Modul: Google-Cloud-Konto erstellen, APIs aktivieren, Schlüssel anlegen und einschränken.

Aktualisiert August 2026

Ihr Buchungsmodul funktioniert ganz ohne Schlüssel: Die Adressen werden von einem integrierten Suchdienst vorgeschlagen, und die Karte nutzt einen OpenStreetMap-Hintergrund. Wenn Sie Ihren eigenen Google-Maps-API-Schlüssel hinterlegen, ersetzen Sie diese Dienste durch die von Google: Google-Adressvorschläge, Google-Maps-Karte und Google-Routenberechnung. Das ist optional – aber es ist die Variante, die Ihren Kunden die vertrauteste Adresseingabe bietet.

Was der Schlüssel in Ihrem Modul verändert

  • Adresssuche — die Felder Startadresse und Zieladresse zeigen die Vorschläge von Google Places, dieselben wie in Google Maps.
  • Karte — ist die Option Karte anzeigen aktiviert, zeigt das Modul eine Google-Maps-Karte anstelle des OpenStreetMap-Hintergrunds.
  • Route, Entfernung und Dauer — die Strecke wird von Google Directions berechnet: Der Streckenverlauf erscheint auf der Karte, mit Entfernung und Fahrzeit.
  • Von Hand angelegte Buchungen — auch in Ihrem Verwaltungsbereich profitiert die Adresseingabe einer manuell angelegten Buchung von der Google-Autovervollständigung.
  • Länderbeschränkung — haben Sie die Adresssuche in den Einstellungen auf ein Land begrenzt, gilt diese Beschränkung auch für die Google-Vorschläge.

Schritt 1 — Ein Google-Cloud-Konto erstellen

  1. Rufen Sie cloud.google.com auf.
  2. Klicken Sie auf Kostenlos starten (oder Jetzt loslegen) und melden Sie sich mit einem Google-Konto an – bevorzugt mit dem Ihres Betriebs.
  3. Geben Sie die Registrierungsdaten an: Daten Ihres Unternehmens und Kreditkarte. Die Karte dient nur der Prüfung, dass Sie kein Roboter sind; während des Testzeitraums bucht Google nichts ab.
  4. Ist die Registrierung bestätigt, gelangen Sie in die Google-Cloud-Konsole.

Prüfen Sie zum Schluss, dass oben in der Konsole ein Projekt ausgewählt ist (Google legt automatisch eines an, oft „My First Project“ genannt). Alle folgenden Schritte gelten für das angezeigte Projekt.

Schritt 2 — Die vier APIs aktivieren

Das Modul nutzt vier Google-APIs. Alle vier müssen aktiviert sein, sonst bleiben Adresssuche oder Karte stumm. Öffnen Sie jeden Link, prüfen Sie, dass oben das richtige Projekt steht, und klicken Sie dann auf Aktivieren:

Erscheint statt Aktivieren eine Schaltfläche Verwalten, ist die API bereits aktiv: Gehen Sie zur nächsten weiter.

Schritt 3 — Den API-Schlüssel erstellen

  1. Öffnen Sie in der Konsole APIs und Dienste › Anmeldedaten.
  2. Klicken Sie auf Anmeldedaten erstellen und dann auf API-Schlüssel.
  3. Google zeigt Ihren Schlüssel an – eine lange Zeichenfolge, die in der Regel mit AIza beginnt. Kopieren Sie ihn: Sie fügen ihn gleich in ClickChauffeur ein.

Schritt 4 — Den Schlüssel einschränken

Ein Schlüssel ohne Beschränkung kann von beliebigen Dritten weiterverwendet und auf Ihrem Konto abgerechnet werden. Nehmen Sie sich zwei Minuten, um ihn einzugrenzen. Klicken Sie auf der Seite Anmeldedaten auf den Namen Ihres Schlüssels und dann:

  • Anwendungsbeschränkungen — wählen Sie Websites und fügen Sie die Adresse https://app.clickchauffeur.com/* hinzu.
  • API-Beschränkungen — wählen Sie Schlüssel einschränken und haken Sie ausschließlich die vier APIs aus Schritt 2 an.

Speichern Sie. Die Änderungen können auf Google-Seite einige Minuten brauchen, bis sie greifen.

Schritt 5 — Den Schlüssel in ClickChauffeur hinterlegen

  1. Öffnen Sie in Ihrem ClickChauffeur-Konto den Bereich Web-Einbindung.
  2. Klappen Sie in der Anpassung des Moduls das Feld Google Maps auf.
  3. Fügen Sie Ihren Schlüssel in das Feld Google Maps API ein.
  4. Klicken Sie auf Speichern.

Die Vorschau des Moduls lädt neu: Tippen Sie eine Adresse in Startadresse – die Google-Vorschläge sollten erscheinen. Haben Sie Karte anzeigen aktiviert, nimmt die Karte das Aussehen von Google Maps an.

Den Schlüssel entfernen

Leeren Sie einfach das Feld Google Maps API unter Web-Einbindung und Speichern Sie. Das Modul kehrt sofort zur integrierten Adresssuche und zum OpenStreetMap-Kartenhintergrund zurück: Es geht nichts verloren, und keine Buchung ist betroffen.

Wenn etwas nicht klappt

  • Keine Adressvorschläge — die Places API oder die Places API (New) ist im Projekt des Schlüssels nicht aktiviert, oder der Schlüssel wurde falsch kopiert.
  • Die Karte bleibt leer oder grau — die Maps JavaScript API ist nicht aktiviert, oder das Rechnungskonto ist im Projekt nicht aktiv.
  • Adressen stimmen, aber weder Entfernung noch Dauer — die Directions API ist nicht aktiviert.
  • Es lief, dann plötzlich nicht mehr — prüfen Sie, ob das Konto in einem abgelaufenen Testzeitraum hängen geblieben ist (siehe Schritt 1) und ob unter APIs und Dienste › Kontingente kein Limit erreicht wurde.
  • Die Vorschläge übergehen bestimmte Länder — das ist die Länderbeschränkung aus Ihren Einstellungen, nicht der Schlüssel.