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
     • falls „Google Cloud Platform“ bisher nicht genutzt wurde, erscheint folgendes:
       • Ggf. den Nutzungsbedingungen zustimmen
       • Button „Jetzt kostenlos testen“
       • Land angeben
       • Button „Zustimmen und fortfahren“
       • Kontaktdaten und Zahlungsmethode angeben
       • Button „Jetzt kostenlos testen“
   • Oben rechts auf den Link „Console“ klicken
   • Oben links auf die Projektauswahl („My First Project“ oder aktuell ausgewähltes Projekt klicken)
   • Im geöffneten Fenster oben rechts auf „Neues Projekt“ klicken
   • Projektname eintragen „CDHWEB“
   • Button „Erstellen“ klicken
   • Oben links auf die Projektauswahl („My First Project“ oder aktuell ausgewähltes Projekt klicken)
   • Auf Projekt „CDHWEB“ klicken
   • Button „Alle APIs ansehen“ klicken (Mitte unter „Produkte“)
   • Links im Menü „Kategorie“->“Maps“
   • Directions API anklicken
   • Button „Aktivieren“
   • Teilweise müssen hier Nutzungsbedingungen bestätigt werden
   • Teilweise muss hier das Abrechnungskonto ausgewählt werden
   • 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. Es kann einige Minuten dauern, bis der Schlüssel bei google aktiviert ist.