Geokodierung von Kundenadressen / Lieferantenadressen

Ü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

Es handelt sich um die Datei CDH_GeoData.mdb. Diese muss im Verzeichnis {CDHClient}\Data gespeichert sein.

Geokodierung 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. 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