hpi-swa-teaching/opensqueakmap

OpenSqueakMap

An OpenStreetMap browser for Smalltalk (Squeak)

Running OpenSqueakMap

1. Make sure you have metacello-work installed.

2. Load the project by running the following in your workspace:

   Metacello new
     baseline: 'OpenSqueakMap';
     repository: 'github://hpi-swa-teaching/OpenSqueakMap:master/packages';
     onConflict: [:ex | ex allow];
     load

3. To display a coordinate on the map, run the following in your workspace:

   OpenSqueakMap open: longitude@latitude

Coordinates are to be passed as decimal numbers. For example, if you want to look at the coordinate 8°30'N 13°00'W, run:

OpenSqueakMap open: -13@8.5 "West and south coordinates become negative"

You can pass an optional zoom level. A zoom level of 0 will show you the entire world, 20 will show you a single building.

OpenSqueakMap open: -13@8.5 at: 16

The default zoom level is 17. OpenSqueakMap currently does not perform too well on lower levels due to the high amount of data that needs to be downloaded.

Configuration

TODO documentation, check back soon!

Authors

• Lukas Behrendt
• Pawel Böning
• Carl Gödecken
• Lisa Ihde
• Daniel Thevessen

License

This project is licensed under the MIT License - see the LICENSE file for details

opensqueakmap's Issues

[h] Dynamisches Anpassen des Farbschemas ermöglichen

Was?

Als designverliebter Nutzer möchte ich das Farbschema individuell ändern können.

Akzeptanzkriterien

Einschränkungen

[8h] Anzeige von Straßennamen auf der Karte ermöglichen

Was?

Als Nutzer möchte ich auf der Karte Straßennamen sehen.

Akzeptanzkriterien

• Neben den Positionsangaben von Straßen werden auch deren Namen heruntergeladen.
• Die Straßennamen werden an den zugehörigen Straßen angezeigt.

Einschränkungen

• Die Straßennamen werden nicht gedreht oder gestaucht, um „in“ den Straßen zu liegen.

Depends on #50: [?] Straßennamen vor gezeichneten Straßen anzeigen

Was?

Als Nutzer möchte ich, dass Straßennamen vor den Straßen gerendert werden.

Akzeptanzkriterien

Einschränkungen

[13h] Falsche Kartenprojektion korrigieren

Was?

Als Nutzer, der Wert auf eine korrekte Darstellung legt, möchte ich die Kartendaten unverzerrt in einer vernünftigen Projektion angezeigt bekommen.

Akzeptanzkriterien

• Die bisherige gescherte Darstellung von Kartenobjekten wird durch eine korrekte, unverzerrte Darstellung ersetzt.
• Insbesondere werden rechteckige Gebäude nicht mehr als Parallelogramme dargestellt.

Parsing von Relations reparieren

Was?

Als Nutzer möchte ich, dass die Karte auch Elemente vom Typ „Relation“ zeigt. Dazu gehören beispielsweise Waldstücke, die vom Typ relation sind und den Tag landuse=forest besitzen.

Akzeptanzkriterien

Einschränkungen

Marker vor den RenderObjects und Straßennamen anzeigen

Was?

Als Nutzer möchte ich das gesetzte Marker und ihre Beschreibung vor Straßennamen und RenderObjects angezeigt werden. In diesem Zuge soll auch die Schriftgröße geändert werden.

Akzeptanzkriterien

Einschränkungen

Gesammeltes Refactoring

Nur template, worauf man in PR's verlinken kann...

Laden von Chunks im Hintergrund ermöglichen

Was?

Als Nutzer möchte ich vom Nachladen neuer Chunks beim Scrollen und Zoomen nicht blockiert werden. Als Nutzer möchte ich außerdem, dass Chunks generell im Hintergrund geladen werden.

Akzeptanzkriterien

Einschränkungen

[3h] Wiki-Seite zur Funktionsweise der Render-Konfiguration erstellen

Was?

Als Tutor hätte ich gerne einen Überblick über die Funktionsweise der bestehenden Render-Konfiguration.

Akzeptanzkriterien

• Es existiert eine Wiki-Seite, auf der übersichtlich die Funktionsweise der bereits implementierten Render-Konfigurationen beschrieben wird.

[1h] Streetmorphs löschen, bei Zoomstufen wechsel

Aktuell werden Streetmorphs bei jedem Zoomstufenwechsel neu gezeichnet, überlappen sozusagen die alten und werden nicht gelöscht
Daraus folgt auch: Straßennamen in hoher Zoomstufe werden beim raussuchen nach dem erstmaligen rendern nicht wieder gelöscht

ToDo:

• alle aktuellen Streetmorphs tracken und beim Zoomstufenwechsel löschen
• in neuer Zoomstufe werden dann alle nötigen Morphs neu gezeichnet

Installationsanweisungen korrigieren und präzisieren (in Bezug auf Git Browser)

Was?

Als Entwickler möchte ich ohne die Verwendung von Metacello nur mithilfe von Squeaks Git Browser das Projekt clonen können.

Akzeptanzkriterien

• Das Projekt ist in seiner Dateistruktur so angepasst, dass es ohne weitere Dependencies mittels des im Squeak-Image eingebauten Git Browsers in einer lauffähigen Version gecloned werden kann.
• Die Readme des GitHub-Repositories ist entsprechend angepasst.

Einschränkungen

Our first issue is labeled "#2" and I'm a whiny little bitch

[8h] Anzeigen von Kontextinformationen zu Kartenobjekten ermöglichen

Was?

Als Nutzer möchte ich beim Anklicken von Objekten auf der Karte zugehörige Kontextinformationen (z. B. Objektname, Koordinaten) angezeigt bekommen.

Akzeptanzkriterien

• Beim Auswählen eines Kartenobjekts werden zugehörige Informationen angezeigt.

GitHub comments may be edited by other members, which might create confusion

See #7 and #3

We have too few issues

[?] Straßennamen verschwinden, wenn man eine Straße markiert und anschließend die Markierung entfernt

[8h] Überlappung von Straßennamen verhindern

zoomLevelAbstraction-Dictionary in ChunkManager/eigene Klasse verschieben

Was?

Da es sich bei der zoomLevelAbstraction um eine Konfiguration handelt, die für alle Chunks gleich ist, muss diese nicht auf Instanz-Seite für jeden Chunk gespeichert werden.

Akzeptanzkriterien

Einschränkungen

[1h] Nacharbeit: Markieren und Speichern von Orten ermöglichen

Was?

Als Nutzer, der die Karte mehrmals verwendet, möchte ich wichtige Orte markieren und beschriften können.

Akzeptanzkriterien

• Nutzer sind in der Lage, eine Position auf der Karte mit einem grafischen Marker zu versehen und diesen Marker zu beschriften.
• Gesetzte Marker werden gespeichert und somit über mehrere Sitzungen hinweg persistent angezeigt.
• Nutzer sind in die Lage, gesetzte Marker wieder zu entfernen.

[5h] Anzeigen von Straßennamen entlang der Straße ermöglichen

Was?

Als detailverliebter Nutzer möchte ich die Straßennamen entlang der Straße angezeigt bekommen.

Akzeptanzkriterien

• Im Gegensatz zur in #19 erfolgten Umsetzung sollen die Straßennamen gedreht und/oder gestaucht werden, um entlang von Straßen angezeigt zu werden.

Einschränkungen

[2h] Angehängtes „nil“ an Objektinformationen entfernen

Relates to #14

[8h] Panning per Drag-and-Drop ermöglichen

Was?

Als Nutzer, der moderne Interfaces gewohnt ist, möchte ich das Sicht-Fenster mit der Maus bewegen können.

Akzeptanzkriterien

• Nutzer sind in der Lage, mittels Drag-and-Drop den Kartenausschnitt zu verschieben (ähnlich zu bspw. Google Maps).
• Das Verschieben geschieht stufenlos.
• Beim Verschieben werden Kacheln mithilfe der bestehenden Methoden nachgeladen.

Einschränkungen

• Das Nachladen von Kacheln wird nicht angepasst.

Messen von Längen und Flächen ermöglichen

Was?

Als Nutzer möchte ich auf der Karte Längen und Flächen messen können.

Akzeptanzkriterien

Einschränkungen

Protokoll Tutortreffen 04.05.

Termine

• Vortrag: 06.07.2017
• Konsultation: 26.06.2017

Organisatorisches

• Betreuerin ist gleichzeitig Betreuer und Kunde (nimmt User Stories ab)
• anfangs einwöchige Treffen, später auch zweiwöchig möglich
• Trello-Board von der Vorgänger-Gruppe wird uns von Betreuerin geschickt
• Der Lehrstuhl fügt uns zum (evtl. geforkten) GitHub-Repo hinzu
  • falls das bis 05.05. nicht passiert ist: noch mal melden!

Begrifflichkeiten (User Stories, Praktiken)

• User Stories
  • legen wir selbst an und schätzen sie auch selbst (mit Punkten/Planning Poker/Keksen/…)
  • Kunde vergibt ebenfalls Punkte (z. B. 30) auf die User Stories nach Prioritäten
  • sollten permanent sein (z. B. GitHub Issues oder Trello-Karten)
  • gern auch auf Karten ausdrucken/aufschreiben und mitbringen
  • Akzeptanzkriterien und Anforderungen klar beschreiben
  • z. B. „As a Teacher I want to …“
  • wichtig: Dass man es versteht und es sinnvoll ist
• Praxis „Simple Design“ + eine weitere selbst auswählen! (es können beliebig viele ausgewählt werden)
  • z. B. Planning Poker

Inhalt der Präsentation

• Wie wurden Praktiken angewandt?
• Was haben wir geschaffen?
• Wie haben sich die Praktiken auf unseren Prozess ausgewirkt?
• optimal: Feststellen, dass die Praktiken sinnvoll waren

Thema Ladezeiten

• momentan sind Ladezeiten sehr hoch, weil immer alle Kartendaten geladen werden
• besser wäre es, wenn man z. B. nur Flüsse oder nur Wege laden können

Erste Woche (bis zum nächsten Treffen)

• mit Legacy Code auseinandersetzen (versuchen, Code zum Laufen zu bringen)
• evtl. bestehende User Stories/Issues anschauen
• eine weitere Praxis auswählen (neben Simple Design) – kann Unterpraxis von XP, aber auch sowas wie TTD sein
• erste User Stories (Welche Features hätten wir gern?) erstellen
  • im Optimalfall genug User Stories, um einen Sprint (eine Woche) damit mit Arbeit füllen zu können
• neue User Stories schätzen (z. B. mittels Planning Poker/Bucket Estimation/Affinity Estimation)

[4h] „Layer“ für Text und Anmerkungen über Kartenelementen anlegen

Um Elemente wie Straßennamen oder Anmerkungen immer über der Karte anzeigen zu können, möchte ich als Entwickler herausfinden, ob und wie ein solcher „Layer“ oberhalb der Kartenelemente angelegt werden kann.

Manche RenderObjects verschwinden beim Laden neuer Chunks kurz

Was?

Als Nutzer möchte ich während Laden neuer Chunks nicht auf Informationen der Karte verzichten müssen, d.h. alle Objekte auf der Karte stetig sehen. Durch kurzes Verschwinden einzelner Objekte beim Download-Vorgang ist dies nicht gewährleistet.

Ideen

• das Verschwinden mancher Objekte könnte an der Überlappung von Objekten mit mehreren Chunks liegen

Akzeptanzkriterien

Einschränkungen

[13h] „Layer“ für Text und Anmerkungen über Kartenelementen anlegen

Was?

Als Nutzer möchte, dass die Anzeigeobjekte vernünftig in der korrekten Reihenfolge „übereinander" gerendert werden.

Akzeptanzkriterien

Einschränkungen

Größe der Straßennamen an Größe/Länge der Straße anpassen

Was?

Als Nutzer möchte ich, dass die Schriftgröße der Straßennamen abhängig vom Zoomlevel, von der Straßenlänge und dem Straßentyp gerendert wird.

Akzeptanzkriterien

Einschränkungen

Anzeigen von Routen ermöglichen

Was?

Als fahrradfahrender Nutzer möchte ich in der Lage sein, Routen von einem Ort zu einem anderen Orten angezeigt zu bekommen.

Akzeptanzkriterien

Einschränkungen

• Es geht nicht um die Routenberechnung auf Client-Seite, sonder um das Laden und Anzeigen einer von einer Fremd-API berechneten Route.

[8h] Nacharbeit: Caching ermöglichen

Was?

Als Nutzer möchte ich, dass ein- und derselbe Ort beim erneuten Öffnen nicht jedes Mal neu geladen werden muss.

Akzeptanzkriterien

• Caching soll definitiv innerhalb einer Squeak-Session ermöglicht werden
• Caching muss nicht zwangsläufig so implementiert werden, dass nach dem Schließen des Images Chunks zwischengespeichert bleiben

Einschränkungen

We have too many open issues

[3h] Verbesserung der Lesbarkeit und allgemeinen optischen Darstellung

• Straßennamen z. B. mit Outline/Schatten/Rahmen/… anzeigen, um sie besser von den Straßen abzuheben
• defaultRenderConfiguration so anpassen, dass sie optisch „schöner“ ist und bessere Kontrastverhältnisse besitzt
• …

Our issues are not really relevant

[5h] Anzeigen eines Ortes durch Adresseingabe ermöglichen

Was?

Als Nutzer, der die Koordinaten eines Ortes nicht kennt, möchte ich den Ort über die Eingabe einer Adresse (Straße und Ort) anzeigen lassen.

Akzeptanzkriterien

• Die Klasse OpenSqueakMap stellt eine Methode bereit, mit der durch Eingabe einer Adresse diese auf der Karte angezeigt werden kann.

Einschränkungen

• Es steht zunächst keine grafische Oberfläche für die Eingabe der Adresse bereit. Diese Funktionalität wird eventuell in einer Folge-Story behandelt.

Panning beim Vergößern des Viewports reparieren

Was?

Als Nutzer möchte ich, dass das Panning per Drag & Drop auch nach Vergrößern des Viewports akzeptabel funktioniert.

Fehlschlagende Chunk-Downloads behandeln

Was?

Als Nutzer möchte ich bspw. bei nicht vorhandener oder sehr schwacher Internetverbindung, dass das Herunterladen nicht endlos oft versucht wird.

Ideen

• Nach gewisser Anzahl an Versuchen abbrechen
• Nach gewisser Zeit abbrechen

Anstatt einfach abzubrechen, könnte dem Nutzer ggf. auch eine entsprechende Meldung mit Möglichkeit zum erneuten Versuchen des Downloads angezeigt werden.

Akzeptanzkriterien

Einschränkungen

[8h] Hinzufügen von noch nicht gezeichneten Objekten

Was?

Als Nutzer möchte, dass auch Objekte die bisher noch nicht gezeichnet werden sichtbar werden (z.B. Wasser).

Akzeptanzkriterien

Einschränkungen

[5h] Anzeigen & Ausblenden von Straßennamen in Abhängigkeit vom Zoom-Level ermöglichen

Was?

Als Nutzer möchte ich in Abhängigkeit vom Zoom-Level nur relevante Straßennamen angezeigt bekommen um die Übersichtlichkeit zu erhalten.

Akzeptanzkriterien

Einschränkungen

Stufenloses Zoomen per Mouse-Scrolling ermöglichen

Was?

Als Nutzer, der moderne Interfaces gewöhnt ist, möchte ich stufenlos mithilfe von Maus-Scrolling zoomen können.

Akzeptanzkriterien

Einschränkungen

[8h] Nacharbeit: Verändern der RenderConfiguration per GUI ermöglichen

Was?

Als Nutzer möchte ich – ohne Code schreiben zu müssen – die Darstellung der Karte verändern.

Akzeptanzkriterien

• Es existiert eine grafische Benutzeroberfläche (GUI), mit der die in der Standard-Renderkonfiguration hinterlegten Darstellungsoptionen getrennt nach Kartenobjekt-Typ (z. B. Gebäude) konfigurierbar sind.

Our project is not finished yet

Steps to complete

• Finish the project

[3h] Wechseln zwischen zwei Render-Konfigurationen per Button ermöglichen

Was?

Als Nutzer möchte ich in der Lage sein, mit einem Button zwischen zwei Render-Konfigurationen (z. B. Darstellung mit/ohne Gebäude) zu wechseln.

Akzeptanzkriterien

• Es existieren zwei Render-Konfigurationen, die sich deutlich voneinander unterscheiden.
• Für das Umschalten zwischen diesen beiden Konfigurationen steht ein Button in Form der bestehenden Buttons zum Verschieben des Kartenausschnitts bereit.

Einschränkungen

• Es besteht nicht die Möglichkeit, die Render-Konfigurationen mittels einer GUI anzupassen.
• Das Wechseln zwischen mehr als zwei Render-Konfigurationen wird nicht ermöglicht.

Anzeigen von Points of Interests (POI) ermöglichen

Was?

Als Nutzer möchte ich die Namen von POIs (z. B. Bahnhaltestellen) auf der Karte sehen.

Akzeptanzkriterien

Einschränkungen

Our issues are too old

Disregard that I suck cocks

Nur angezeigte Chunks bewegen/rendern

Was?

Als Nutzer möchte ich, dass nur die sichtbaren Chunks, also die sich im Viewport befindlichen Chunks, gerendert und bewegt werden.

Akzeptanzkriterien

Einschränkungen

[3h] Zu öffnende Koordinaten nicht an der oberen linken Ecke, sondern zentriert darstellen

To Do bis Do 11.05.

• SWT-Folien zu „agilen Praktiken“ (z.B. XP) anschauen, um neben Simple Design noch eine weitere Praxis für unseren Prozess auswählen zu können – https://hpi.de/internalfiles/materialien/FG_SoftwareArchitekturen/SoftwareEngineering_V/Handouts/Swt1_U04_XP.pdf (ab Folie 51)
• Neue User Stories überlegen
• Legacy-Code im Image auschecken; versuchen, insb. die Rendering-Konfiguration nutzen zu können (unsere Vorgänger haben z.B. das Rendering von Gebäuden eingebaut und wir sind noch nicht dahinter gestiegen, wie man das aktiviert)