Google Maps API-Key einrichten (Inhouse)

Kurz erklärt

In Wice Inhouse zeigt die Organisations-Detailansicht optional eine Karte mit der Adressposition. Dafür hinterlegen Sie einen Google Maps JavaScript API-Key in den Systemeinstellungen. On-Demand-Mandanten erhalten die Kartendarstellung ohne eigenen Key.

Voraussetzungen

Voraussetzung	Hinweis
Wice Inhouse	Nicht für alle On-Demand-Setups nötig
Google-Konto	Kostenlose Registrierung bei Google
Admin-Rechte in Wice	Mehr → Administration → Systemeinstellungen
Öffentliche Wice-URL	Für HTTP-Referrer-Beschränkung des Keys

Schritt 1: API-Key bei Google anlegen

Melden Sie sich mit Ihrem Google-Konto an.
Folgen Sie der Google-Anleitung zum Erstellen eines API-Keys: Google Maps JavaScript API — API-Key (nur der Abschnitt zur Key-Erstellung ist relevant).
Beschränken Sie den Key auf HTTP referrer — Eintrag z. B.:

https://crm.ihre-domain.de/*

Verwenden Sie die URL, unter der Ihr Wice-Server tatsächlich erreichbar ist (inkl. https://, Wildcard /* am Ende).

Schritt 2: Key in Wice eintragen

Schritt	Aktion
1	Mehr → Administration → Systemeinstellungen → Allgemein
2	Feld für den Google API-Key (Kartendarstellung)
3	Key einfügen und Speichern

Ergebnis prüfen

Öffnen Sie eine Organisation mit vollständiger Adresse.
In der Detailansicht sollte die Karte mit Pin erscheinen (siehe auch Mobile Nutzung und Außendienst).
Browser-Konsole (F12): keine Fehler zu „Google Maps API“ oder „RefererNotAllowedMapError“.

Wenn etwas nicht funktioniert

Symptom	Häufige Ursache	Lösung
Karte bleibt leer	Key fehlt oder falsch gespeichert	Systemeinstellungen prüfen, Seite hart neu laden
`RefererNotAllowedMapError`	HTTP referrer passt nicht	Key in Google Cloud auf exakte Wice-URL (`https://…/*`) beschränken
Karte nur lokal, nicht produktiv	Key nur für Test-URL freigegeben	Referrer-Liste um Produktiv-URL ergänzen
Kein Pin trotz Karte	Adresse unvollständig	Straße, PLZ und Ort in der Organisation pflegen