Geodaten-Ermittlung

Paket: BASIS

1. Allgemein

In brainX werden Geodaten für folgende Funktionalitäten verwendet:

• Startseite - Dashboard Widget - Lokalisierung (Länderkarten)
• Listenansicht - Geofilter (Filter mittels Umkreisdefinition)
• Aktion Erstelle Google Maps Routenplan in Listenansichten

Nach erfolgreicher Einrichtung dieser Einstellung können Routenplanungen erstellt sowie Karten mit der Anzeige des genauen Standorts eines Datensatzes (z. B. Organisation, Kontakt, Lead etc.) dargestellt werden.

2. Einstellungen für Geodaten mit Google Maps

Um in brainX Geodaten zu erhalten müssen folgende Voraussetzungen erfüllt sein:

• Der Google Maps Geocoding API Schlüssel ist in brainX hinterlegt.
• Der Google Maps JavaScript API Key ist in brainX hinterlegt.
• Die Hintergrundaufgabe Geodaten-Ermittlung muss aktiv sein.

2.1. Google Maps Geocoding API Schlüssel

Für die Abfrage von Geodaten wird ein API Key benötigt, welcher im Feld “Google Maps Geocoding API Schlüssel” eingetragen werden muss.

Wie der API Key generiert wird, ist der Anleitung Geocoding API einrichten zu entnehmen.

Für diesen API Key (Schlüssel) muss zwingend die “Google Geocoding API” aktiviert sein.

Der API Key kann auf die IP Adresse des CRM Servers beschränkt werden.

2.2. Google Maps JavaScript API Key

Um im CRM Karten von Google anzeigen zu lassen, muss im Feld “Google Maps JavaScript API Key” ein entsprechender API Key hinterlegt werden. Eine Anleitung zur Erstellung ist unter https://developers.google.com/maps/documentation/javascript/get-api-key verfügbar.

Es ist zu beachten, dass dieser Dienst mit Kosten verbunden ist. Für diesen Schlüssel müssen die Geocoding, Maps JavaScript und Directions API aktiviert sein. Er kann über die Verweis-URL des CRMs eingeschränkt werden, z.B. “https://name.brainx.app/*”.

Wird in einem der beiden Eingabefelder ein Schlüssel eingetragen, oder es wird einer der beiden Schlüssel geändert, ist der Button “Speichern” aktiv. Um die Änderungen zu speichern, muss lediglich der Button angeklickt werden.

3. Praxisbeispiele

1 - Außendienstmitarbeiter plant seine Tagesroute

Ausgangssituation: Ein Außendienstmitarbeiter hat an einem Tag mehrere Kundenbesuche in einer Region geplant und möchte die effizienteste Reihenfolge ermitteln.

Vorgehen: In der Listenansicht des Moduls Organisationen werden die gewünschten Datensätze gefiltert und markiert. Über die Aktion Erstelle Google Maps Routenplan wird eine optimierte Route in Google Maps geöffnet, die alle Standorte berücksichtigt.

Ergebnis: Der Mitarbeiter erhält eine direkt navigierbare Route und spart Zeit bei der manuellen Planung.

2 - Vertrieb filtert Kunden im Umkreis einer Messe

Ausgangssituation: Das Vertriebsteam möchte vor einer Messe alle Kunden und Interessenten im Umkreis von 50 km um den Messestandort identifizieren, um gezielt Einladungen zu versenden.

Vorgehen: In der Listenansicht des Moduls Organisationen wird der Geofilter verwendet. Als Mittelpunkt wird die Adresse des Messegeländes eingetragen, der Radius auf 50 km gesetzt. Die gefilterten Datensätze werden anschließend für eine E-Mail-Kampagne weiterverarbeitet.

Ergebnis: Alle relevanten Kontakte im Umkreis werden in wenigen Sekunden ermittelt - ohne manuelle Auswertung von Adressen.

3 - Geografische Auswertung der Kundendichte per Dashboard

Ausgangssituation: Die Geschäftsleitung möchte auf einen Blick sehen, in welchen Regionen die meisten Kunden ansässig sind, um Vertriebsressourcen gezielt einzusetzen.

Vorgehen: Auf der Startseite wird das Dashboard-Widget Lokalisierung eingebunden. Das Widget zeigt eine Länderkarte mit der geografischen Verteilung der Datensätze.

Ergebnis: Regionale Schwerpunkte und Lücken in der Kundenverteilung sind auf einen Blick erkennbar.

4. Häufige Fragen

Benötige ich für beide API-Schlüssel einen kostenpflichtigen Google-Account?

Der Google Maps JavaScript API Key ist mit Kosten verbunden, da er die Maps JavaScript API, die Geocoding API und die Directions API nutzt. Google bietet jedoch ein monatliches Guthaben, das für viele Anwendungsfälle ausreicht. Der genaue Kostenrahmen hängt vom Nutzungsvolumen ab und ist direkt bei Google zu erfragen. Es wird empfohlen, im Google Cloud-Konto ein Ausgabenlimit zu setzen.

Kann ich einen einzigen API-Schlüssel für beide Felder verwenden?

Grundsätzlich ist es technisch möglich, einen Schlüssel zu erstellen, der alle erforderlichen APIs aktiviert hat. Es empfiehlt sich jedoch, zwei separate Schlüssel zu verwenden und diese jeweils auf die zulässige IP-Adresse bzw. Verweis-URL einzuschränken, um Missbrauch zu vermeiden.

Was passiert, wenn die Hintergrundaufgabe „Geodaten-Ermittlung" nicht aktiv ist?

Ohne aktive Hintergrundaufgabe werden keine Geodaten für Datensätze ermittelt. Geofilter, Routenplanung und Standortkarten stehen in diesem Fall nicht zur Verfügung. Die Hintergrundaufgabe kann im Einstellungspunkt Hintergrundaufgaben aktiviert werden.

Warum werden für manche Datensätze keine Geodaten angezeigt?

Geodaten werden auf Basis der hinterlegten Adresse eines Datensatzes ermittelt. Ist die Adresse unvollständig, fehlerhaft oder nicht eindeutig auflösbar, kann keine Koordinate ermittelt werden. Es empfiehlt sich, Straße, PLZ, Ort und Land vollständig zu pflegen.

Kann der API-Schlüssel auf bestimmte Zugriffe eingeschränkt werden?

Ja. Der Google Maps Geocoding API-Schlüssel kann auf die IP-Adresse des CRM-Servers eingeschränkt werden. Der Google Maps JavaScript API Key kann über die Verweis-URL der brainX-Instanz eingeschränkt werden (z. B. https://name.brainx.app/*). Diese Einschränkungen werden empfohlen, um unbefugte Nutzung des Schlüssels zu verhindern.