Geokodierung von Kundenadressen / Lieferantenadressen

Ziel

In CDHWeb ist es möglich, Kunden- und Lieferantenadressen auf einer digitalen Landkarte anzeigen zu lassen und auch Routen zu planen.

Überblick

In CDHWeb gibt es die Funktionen „Umkreissuche“ und „Geo Map“. Diese Funktionen brauchen Geo-Daten zu den Adressen der Kunden und Lieferanten. Die Kodierung der Adressen kann in CDHWeb erfolgen, und zwar entweder direkt beim Start der „Umkreissuche“ oder nach der Suche in „Geo Map“

Datenbasis für die Geokodierung

Die Geokodierung kann anhand einer von CDH bereitgestellten Datenbank erfolgen. In dieser sind Straßen, PLZ und Geodaten gespeichert. Diese Datenbak erhält aber nur Daten für Deutschland und ist nicht vollständig. Falls die Geokodierung über diese Datenbank nicht möglich ist, kann eine Geokodierung über „google maps“ erfolgen.

Einrichtung mit "Google maps"

Diese Geokodierung steht für alle Länder zur Verfügung und basiert auf dem Adressbestand von „google maps“. Der Dienst ist kostenpflichtig (meistens entstehen nur Kosten von weniger als 1 €). Es muss ein API-Key in einer Konfigurationsdatei hinterlegt werden.

1. Beantragung des API-Keys
   • Bei google anmelden (ggf. eigenes Konto einrichten)
   • „Google Cloud Platform“ aufrufen
     • https://cloud.google.com
     • Ggf. den Nutzungsbedingungen zustimmen
     • Button „Jetzt kostenlos starten“
     • Daten angeben
     • Zahlungsmethode hinterlegen
     • Weitere Daten Eintragen
   • Button „Meine Konsole“
   • Oben links werden Projekte angezeigt
     • Neues Projekt erstellen
     • Projektname eintragen „CDHWEB“
     • Erstellen
   • Projekt auswählen
   • Button „Alle APIs ansehen“
   • Kategorie->Maps
   • Directions API anklicken
   • Button „Aktivieren“
   • Es wird der API-Schlüssel angezeigt
   • Button „Zur GOOGLE MAPS Plattform“
   • Dialog „Schlüssel schützen“
     • „API-Einschränkung auswählen“
     • In unterer Liste folgende APIs markieren
       • Directions API
       • Geocoding API
       • Maps JavaScript API
     • Button OK
     • Button „Schlüssel einschränken“
   • Links auf „Schlüssel und Anmeldedaten“ klicken
   • Rechts auf Schlüssel anzeigen
   • Schlüssel kopieren
2. Key in Konfigurationsdatei eintragen
   • Datei {CDHServer}\Data\ CDHGeoData.settings.json in einem Texteditor öffnen
   • Rechts vom Doppelpunkt zwischen den Hochkommas den Key eintragen. Der Dateiinhalt muss dann so aussehen:
     • {"googleApiKey":"Der Google MAPS API Key"}
   • Datei speichern

Wichtig: CDHOffice muss einmal komplett neu gestartet werden, damit es dann auch in CDHWeb funktioniert.