WebGIS Backend API

Backend-REST-API für WebGIS-Anwendungen mit feature-verknüpften PostgreSQL/PostGIS-Daten.

Schnellstart (Docker)

1. Kopiere db/config.example.js nach db/config.js und trage deine Datenbank-Zugangsdaten ein:

   cp db/config.example.js db/config.js
   # Passe config.js nach Bedarf an

2. Stelle sicher, dass in den Datenbanken folgende Views enthalten sind: Views

3. Baue und starte die API mit Docker Compose:

   docker-compose up -d

4. Die API ist dann erreichbar unter http://localhost:4430/webgis-backend-api

IIS-Bereitstellung

• Kopiere das Projektverzeichnis auf den Webserver nach C:\inetpub\wwwroot\webgis-backend-api\
• (Nur beim ersten Mal) Setze Vollzugriff für IIS_IUSRS auf den Ordner C:\inetpub\wwwroot\webgis-backend-api\
• Passe in der web.config den Node.js-Pfad an, z.B. zu C:\Program Files\nodejs\node.exe
• Für iisnode-Betrieb:
  • Installiere das URL Rewrite Module und iisnode auf dem Server.
  • Kontrolliere, dass nodeProcessCommandLine in der web.config auf den Node.js-Pfad des Zielservers zeigt.
  • Setze im IIS Application Pool die .NET CLR-Version auf No Managed Code.
  • Aktiviere die anonyme Authentifizierung für die Website.
  • Erlaube den gewünschten Port (z.B. 4430) in der Windows-Firewall und ggf. in der Anbieter-Firewall/Sicherheitsgruppe.
  • Lege im IIS ein HTTPS-Binding mit Zertifikat und gewünschtem Port an (z.B. 4430, Hostname optional).

API-Endpunkte

• Health Check

  • GET /webgis-backend-api/health
    Gibt den Verbindungsstatus zu allen konfigurierten Datenbanken zurück.

• Bäume

  • GET /webigs-backend-api/{db}/baum
    Gibt alle Bäume aus der gewählten Datenbank zurück.
  • GET /webgis-backend-api/{db}/baum/:gid
    Gibt einen einzelnen Baum anhand der GID zurück.
  • GET /webgis-backend-api/{db}/baum/:gid/kontrolle
    Gibt alle Kontrollen zu einem Baum zurück.

• Straßenabschnitte

  • GET /webgis-backend-api/{db}/strassenabschnitt
    Gibt alle Straßenabschnitte aus der gewählten Datenbank zurück.
  • GET /webgis-backend-api/{db}/strassenabschnitt/:gid
    Gibt einen einzelnen Straßenabschnitt anhand der GID zurück.
  • GET /webgis-backend-api/{db}/strassenabschnitt/:gid/kontrolle
    Gibt alle Kontrollen zu einem Straßenabschnitt zurück.
  • GET /webgis-backend-api/{db}/strassenabschnitt/:gid/aufbruch
    Gibt alle Aufbrüche zu einem Straßenabschnitt zurück.

Sortierung der Ergebnisse

Viele Endpunkte (z.B. /baum, /baum/:gid/kontrolle, /strassenabschnitt, /strassenabschnitt/:gid/kontrolle, /strassenabschnitt/:gid/aufbruch) unterstützen den Query-Parameter sortby, um die Ergebnisse nach einer oder mehreren Spalten zu sortieren.

• Syntax: ?sortby=+spalte1,-spalte2
  • + (oder kein Präfix) sortiert aufsteigend, - absteigend.
  • Es können nur freigegebene (whitelisted) Spalten zum Sortieren verwendet werden.

Beispielanfragen

• GET /webgis-backend-api/lohmar/strassenabschnitt
  Gibt alle Straßenabschnitte aus der Datenbank lohmar zurück.
• GET /webgis-backend-api/lohmar/strassenabschnitt/3120
  Gibt den Straßenabschnitt mit GID 3120 aus der Datenbank lohmar zurück.
• GET /webgis-backend-api/lohmar/strassenabschnitt/3120/kontrolle
  Gibt alle Kontrollen für Straßenabschnitt 3120 aus der Datenbank lohmar zurück.
• GET /webgis-backend-api/lohmar/strassenabschnitt/3120/aufbruch
  Gibt alle Aufbrüche für Straßenabschnitt 3120 aus der Datenbank lohmar zurück.
• GET /webgis-backend-api/lohmar/strassenabschnitt?sortby=-gid Gibt alle Straßenabschnitte aus der Datenbank lohmar zurück, absteigend nach gid sortiert.
• GET /webgis-backend-api/lohmar/strassenabschnitt/3120/kontrolle?sortby=-naechstekontrolle Gibt alle Kontrollen für Straßenabschnitt 3120, absteigend nach naechstekontrolle sortiert.

Hinweise

• Die API verbindet sich mit mehreren PostgreSQL-Datenbanken, wie in deiner db/config.js konfiguriert.
• Stelle sicher, dass dein lokales PostgreSQL von Docker aus erreichbar ist (unter Windows z.B. mit host.docker.internal als DB_HOST).