Der KulturpfadeService bietet die Möglichkeit, aus einer Liste an Orten eine Fussgänger-Route zwischen diesen Orten zu erstellen.
Hierfür wird ein Dokument mit Orten übergeben. Anhand der Adressen werden die notwendigen x/y-Koordinaten erstellt. Mit Hilfe der Routing-Software Graphhopper wird hieraus eine Route erstellt, die in Form von geojson-Objekten zur Verfügung gestellt werden. Die Orte enhalten eine eindeutige ID, die es ermöglicht, weitergehende Informationen mit dem Ort zu verknüpfen.
Die Software ist als Service gedacht, die es erlaubt, die notwendigen Daten für die Bereitstellung einer Oberfläche ohne Backend zu generieren.
Der Service soll eine einfache Weboberfläche enthalten, um das Ergebnis einfach kontrollieren zu können.
Voraussetzung für die Ausführung des Services ist die Installation von git, Java 17 und Maven 3. Der Service kann dann mit folgenden Befehlen auf der Kommandozeile heruntergeladen, gebaut und ausgeführt werden:
git clone https://github.com/weberius/kulturpfadservice.gitmvn clean installmvn spring-boot:run
Der Prozess mvn clean install kann je nach Internetverbindung mehr als 5 Minuten dauern. Vor den Tests wird der aktuelle Abzug der OSM-Daten für den Regierungsbezirk Köln heruntergeladen. Mit Starten der Applikation (mvn spring-boot:run) steht auf localhost:8080 ein einfacher Service mit unterschiedlichen Schnittstellen zur Verfügung:
http://localhost:8080/service/poi/<id>http://localhost:8080/service/route/<id>http://localhost:8080/service/gpx/<id>http://localhost:8080/service/data/<id>
Unter http://localhost:8080/index.html?id=<id> kann eine Weboberfläche aufgerufen werden, die bei der Erstellung der Routen und Pois unterstützt. Der Wert für id bezeichnet einen Kulturpfad. Z.B. http://localhost:8080/index.html?id=b03-t06 öffnet die Route für den Kulturpfad 06 "Braunsfeld/ Lindenthal".
Die Dokumentation des Service wird unter src/main/asciidoc fortgeführt.
Die Dokumentation wird im Rahmen der prepare-package Phase in html überführt und steht unter weberius.github.io/kulturpfadservice/main.html zur Verfügung.