Skip to content

Know-Where-You-Go ist eine open-source Webanwendung, die Ihnen hilft herauszufinden wo Sie sind und wohin Sie gehen.

Notifications You must be signed in to change notification settings

DHBW-FN-TIT20/know-where-you-go

Repository files navigation

Logog

Know Where You Go

Website GitHub release (latest by date)

Know-Where-You-Go ist eine Webanwendung die Ihnen hilft herauszufinden wo Sie sind und wohin Sie gehen.

🔎 Features

  • Bekomme Informationen über jeden Ort mithilfe von Wikipedia
  • Finde heraus wo du dich aktuell befindest mithilfe von OpenStreetMap
  • Lass dir die schnellsten Routen zu einem Ort deiner Wahl zeigen und öffne sie in GoogleMaps
  • Lass die beim Suchen von Länder, Regionen und Städten deren genauen Grenzen anzeigen
  • Kann auf jedem Endgerät installiert werden
  • Selbst ohne Internetzugang kannst du deine letzten Inhalte sehen
  • Hoste die Anwendung auf deinem eigenem Server mit Docker

🔎 Technische Details und Highlights

  • Automatische Vervollständigung der Suche abhängig von deinem aktuellen Standort
  • Verschiedene Kartenansichten ( "Map" und "Satellite" )
  • Speicherung der zuletzt besuchten Orte
  • Der aktuelle Zoomgrad der Karte wird beim Reverse Geocoding zu jederzeit berücksichtigt
  • Recursive Suche der Wikipediainformationen bis passende Informationen zum Ort gefunden wurden

🐳 Deploy mit Docker

Clonen des Repos:

git clone https://github.com/DHBW-FN-TIT20/know-where-you-go.git

Bauen und starten eines eigenen Image:

# Bauen eines Containers mit dem namen know-where-you-go
cd know-where-you-go
docker build buildx -t know-where-you-go .

# Bei einer alten Docker Version verwende
docker build -t know-where-you-go .

# Starten des Containers
docker run -d --name know-where-you-go know-where-you-go

Alternativ mit docker-compose:

cd know-where-you-go
docker compose up -d

# Bei einer alten Docker / docker-compose Version verwende
docker-compose up -d

🚀 Deploy Manuell

Ein Pre-Build ist unter Releases zu finden.

Entpacke die Datei release.tar.gz unter Windows mit 7-Zip oder vergleichbaren.
Unter Linux kann folgender Befehl eingegeben werden:

tar -xzvf release.tar.gz

Die Daten im Ordner www können nun mit einem beliebigen Server wie z.B. Apache bereitgestellt werden.

🛠 Bauen der Anwendung

Es kann der www Ordner auch selbst gebaut werden.

Node Version >= 16 wird vorausgesetzt.
Eine Anleitung ist hier zu finden: https://nodejs.org/en/

git clone https://github.com/DHBW-FN-TIT20/know-where-you-go.git
cd know-where-you-go
npm install
npm run build

Die Daten befinden sich im Ordner www.

🤓 Entwickler