Google-Maps-Schlüssel einrichten¶

DiKAS kann Adressen beim Anlegen von Kunden und im Onboarding automatisch vervollständigen. Dafür braucht es einen eigenen Google-Maps-Schlüssel. Ohne Schlüssel funktioniert alles weiter — Adressen werden dann einfach von Hand eingetippt.

Der Schlüssel gehört Ihnen und wird direkt bei Google abgerechnet. Für die üblichen Mengen einer Gastronomie fällt in der Regel nichts an, weil Google ein monatliches Freikontingent gewährt. Prüfen Sie die aktuellen Konditionen aber selbst — sie können sich ändern.

Schritt 1 — Projekt in der Google Cloud Console anlegen¶

Öffnen Sie https://console.cloud.google.com/projectcreate.
Melden Sie sich mit Ihrem Google-Konto an.
Vergeben Sie einen Projektnamen, zum Beispiel „DiKAS Kasse", und bestätigen Sie mit Erstellen.
Warten Sie kurz und wechseln Sie oben links in das neue Projekt.

Schritt 2 — Abrechnung aktivieren¶

Google gibt Kartenschlüssel nur mit hinterlegtem Zahlungsmittel heraus, auch wenn Sie im Freikontingent bleiben.

Öffnen Sie https://console.cloud.google.com/billing.
Legen Sie ein Rechnungskonto an bzw. verknüpfen Sie ein bestehendes mit dem Projekt.

Schritt 3 — Die beiden benötigten Dienste einschalten¶

DiKAS braucht genau zwei Dienste. Öffnen Sie beide Seiten und klicken Sie jeweils Aktivieren:

Maps JavaScript API — https://console.cloud.google.com/apis/library/maps-backend.googleapis.com
Places API (New) — https://console.cloud.google.com/apis/library/places-backend.googleapis.com

Beide sind Pflicht

Fehlt einer der beiden Dienste, bleibt das Adressfeld stumm: es erscheinen keine Vorschläge, ohne dass eine Fehlermeldung auftaucht.

Schritt 4 — Schlüssel erstellen¶

Öffnen Sie https://console.cloud.google.com/apis/credentials.
Anmeldedaten erstellen → API-Schlüssel.
Kopieren Sie den angezeigten Schlüssel. Er beginnt mit AIza….

Schritt 5 — Schlüssel einschränken (wichtig)¶

Ein unbeschränkter Schlüssel kann von Fremden auf Ihre Rechnung genutzt werden. Der Schlüssel ist technisch bedingt im Browser sichtbar — die Einschränkung ist deshalb Ihr eigentlicher Schutz.

Klicken Sie in der Liste auf den neuen Schlüssel.
Unter Anwendungseinschränkungen → Websites auswählen.
Tragen Sie Ihre Adressen ein, jeweils mit /* am Ende, zum Beispiel:
https://ihrname.next.dikas.de/*
https://konto.dikas.de/*
Unter API-Einschränkungen → Schlüssel einschränken und die beiden Dienste aus Schritt 3 auswählen.
Speichern.

Schritt 6 — Schlüssel in DiKAS eintragen¶

Einstellungen → Betrieb.
Abschnitt Google Maps, Feld API-Schlüssel.
Schlüssel einfügen und speichern.

Danach schlägt DiKAS beim Tippen einer Adresse passende Treffer vor.

Wenn keine Vorschläge kommen¶

Änderungen an Schlüsseln brauchen bei Google gelegentlich ein paar Minuten. Kommt danach immer noch nichts:

Sind beide Dienste aus Schritt 3 aktiviert?
Stimmt die Website-Einschränkung exakt mit der Adresse überein, unter der Sie DiKAS aufrufen (inklusive https:// und /*)?
Ist am Rechnungskonto ein gültiges Zahlungsmittel hinterlegt?
Wurde der Schlüssel vollständig kopiert?