Skip to content

pitwch/go-proffix-geocode

Repository files navigation

Build Status codecov

Geocode PROFFIX Adressen

Mit diesem Tool können Adressen aus PROFFIX automatisch geocodiert werden.

Das Tool liest sämtliche Adressen ohne Longitude / Latitude aus der angegebenen PROFFIX - Datenbank, geocodiert diese wahlweise über Google oder Mapquest und schreibt die Longitude / Latitude Werte zurück in die PROFFIX - Datenbank.

Beispiel Ergebnis geocodierter PROFFIX - Adressen in pApp alt text

Konfiguration

Sämtliche Konfiguration erfolgt über eine config.json welche sich im selben Verzeichnis wie das Tool befinden muss.

Beispiel:

{
  "Database": {
    "Username": "sa",
    "Password": "1234",
    "Database": "PX000001",
    "Hostname": "SERVER1",
    "Port": 1433,
    "Parameter": "?connection+timeout=30"
  },
  "Settings": {
    "UseGeocoder": "Google",
    "MapQuestAPIKey": "",
    "GoogleAPIKey": "AgOleyXsXAbzEuSPzRYf_vbdT943s44w1nRkW"
  }
}
Parameter Typ Bemerkung
Username string Benutzername SQL - Server 1
Password string Passwort SQL - Server 1
Database string PROFFIX Datenbank
Hostname string Hostname des SQL - Servers; kann auch IP sein
Port int Port des SQL Servers
Parameter string Div. Parameter für SQL-Server
UseGeocoder string "Google" / "Mapquest" ; legt fest mit welchem Provider gearbeitet wird
MapQuestAPI string API - Key für Mapquest
GoogleAPIKey string API - Key für Google (empfohlen)

1: Single-Sign-On unter Windows wird unterstützt, d.h. wenn der ausführende Benutzer genügenden administrative Berechtigungen hat um die PROFFIX Datenbank zu bearbeiten kann sowohl Username wie auch Password leer gelassen werden.

API - Key

Sowohl für das Geocodieren über Google als auch über Mapquest wird ein API - Key benötigt. Diesen erhält man wie folgt:

Google (empfohlen): https://developers.google.com/maps/documentation/geocoding/get-api-key

Mapquest: https://developer.mapquest.com/documentation/

Die entsprechenden Lizenzbedingungen beachten! (Im Falle von pApp - dem App für PROFFIX ist alles ok)

Verwendung

Die aktuellste Version des Tools findet sich immer unter Release.

Alternativ kann das ZIP-File hier direkt heruntergeladen werden.

Dann das ZIP-File entpacken, die API-Keys besorgen und die config.json editieren.

Das Tool kann anschliessen in Windows per CMD ausgeführt werden (Nur Doppelklick funktioniert nicht!):

alt text

Fragen / Hilfe

Fragen und Hilfestellung bei der Anwendung oder Installation entweder per Github oder direkt über die Pedrett IT + Web AG