Diskussion:Tourpl: Unterschied zwischen den Versionen

Version vom 31. Oktober 2011, 17:23 Uhr

Aktueller Stand und Technologien

Aktueller Stand

Die Funktionalität wird zurzeit laufend erweitert - ausser "grosse Erweiterungen", wie z.B. eine Adressverwaltung, die wir gerne über unsere Premium-Services realisieren.

Daten

• Die Strassendaten stammen von der OpenStreetMap-Datenbank. Sie sind ca. 2 Tage alt (vgl. EOSMDBone).
• Bei Widersprüchen zwischen PLZ und Ortsname wird die PLZ verwendet (Näheres dazu siehe Geocoder).

Technologien

• Server: Python, SQLite
• Clients:
  • JavaScript: OpenLayers, jQuery
  • Webbrowser: Getestet unter Firefox 3, Firefox 4, Chrome 13 und IE 8 (später ev. IE 9 und Safari).
• Folgende externe Webservices werden genutzt:
  • Geocoder/Geocoding: Yahoo (eine Alternative wäre Mapquest oder Geonames)
  • Routing: OpenStreetMap-Route-Service (OSRM) [1] (eine Alternative wäre MapQuest)
    • Routing mit OSRM und mit PostGIS und pgrouting (pg_route ist outdated)
    • Dennis Luxen: "Routing with OpenStreetmap data", SOTM Wien, http://sotm-eu.org/talk?74 (PDF) (about OSRM)
    • Comparison of (OSM) routing-engines – Reloaded

Task List

Bis Ende Oktober 2011!

Einbau Fahrtenzeilen/Zusatzzeilen (vgl. Beispiel unten)

• Tab/Button "Download":
  • der Abfahrtszeit im Feld "Abfahrt", Fahrtdauer im Feld "Dauer" und im Feld Name kommt "Fahrt nach <xxx>" (Bsp. vgl. unten).
  • Die Abfahrtszeit wird mit Abfahrt und Dauer des vorangehenden Zwischenhalts berechnet.
  • Der Text in Name wird durch den Ort des Nachfolgers ergänzt (Koordinaten falls Ort nicht vorhanden).
  • Die letzte Zusatzzeile verwendet den Ort (Koordinaten) des Starts.
• Tab/Button "Upload":
  • "Fahrtenzeilen" ignorieren (Zeilen, bei denen nur in den ersten beiden Kolonnen Werte sind); Zukunft: Zwischenspeichern?.

Nach Tab sortiert:

• Tab/Button "Upload":
  • Felder "Anrede", "Email", "Telefon" und "Koordinate" sollten nicht obligatorisch sein, ggf. auch "Land" ("Land" und "Koordinate" ggf. erzeugen).
  • Adresse "Muster, Max, Dorfstrasse 100, 8105, Watt" => Gibt Error wegen "Dorfstrasse 100, 8105, Watt" (AttributeError "no such child: {http://www.opengis.net/kml/2.2}Placemark" in lxml.objectify._lookupChildOrRaise (src/lxml/lxml.objectify.c:5310), line 484)
  • Test mit realistischem Datensatz mit > 50 Adressen (tourpl_stud_test_alle.csv )
  • Error bei Aufruf von http://tourpl.ch/7nz2wuijijdupa4mbu35wisge4 (Datei:Tourpl err.zip mit Umlauten gemischt UTF-8 und ANSI?)

 <class 'app.helpers.route.RouteNotFound'> at /7nz2wuijijdupa4mbu35wisge4
 no such child: {http://www.opengis.net/kml/2.2}Placemark
 Python  lxml.objectify.pyx in lxml.objectify._lookupChildOrRaise (src/lxml/lxml.objectify.c:5310), line 484
 Web   GET http://tourpl.ch/7nz2wuijijdupa4mbu35wisge4

• Tab/Button "Download":
  • -
• Tab/Button "Löschen"
  • Sicherheitsrückfrage ("Wollen Sie wirklich löschen? Ok (Abbrechen)").
• Tab/Button "Verbessern" (Tour optimieren):
  • BUG: Der neue Algo. (mit < 20 Adressen) verändert den Startpunkt (Test http://www.tourpl.ch/v5yq4esjuvda7iicmd3nktp2ry )
  • mit Sicherheitsrückfrage ("Diese Funktion verändert die Reihenfolge. Fortfahren? (Abbrechen)").
  • mit Warte-Dialog! (graue Fläche über die Karte mit zentrierter Schrift "Bitte warten...").
  • Analyse Simulated Annealing: Warum wechselt die Route ständig bei kleiner Anzahl Zwischenstationen?
  • Einbau von Brute Force Algo für Touren mit max. 10 Städten (10! ist wahrscheinlich vernünftige obere Grenze)
• GUI:
  • Bei Exceptions/Fehler einen schönen Dialog anzeigen und zur Startseite zurückkehren.
  • Bei Umschalten auf bzw. Zoomen von Google Hybrid, den Dialog "Kartendaten: Grafiken (c) 2011 Terrametrics <Schließen>" entfernen.
  • Einbau Anzeige Datum+Zeit "Data 07.10.2011 03:23 (UTC) -1 Day" (analog Diskussion:PostGIS Terminal).
  • Alle Tabs/Buttons ausser "Drucken" in Fettschrift, also: | Vorlage | Upload | Download | Drucken | Löschen | Verbessern |
  • Permalink codiert allfällige XAPI-Syntax ([,=,]) und macht den Link damit kaputt.

Später (?):

• Zum Zwecke des Neusetzens des Startpunkts oder der nachträglichen Verbesserung "von Hand":
  • Visuelles Umordnen in der Karte (vorhandener Code einbauen!)
  • (Bug) Nach visuellem Umordnen der Liste oder in der Karte muss die Gesamtdistanz neu berechnet werden.
  • (Wie die Eingabe von weiteren Rahmenbedingungen erfolgen soll, ist noch nicht ganz klar)
• Einbau neues Logo von ambienteverde - sobald neues vorhanden.

Erledigtes unten in History einordnen.

Feature Requests

Adressen:

• Use Cases und Screen Mocks für Anschauen / Editieren Modi (Download "alle Adressen" vs. "nur Tour")

Upload:

• CSV-Parser/Reader:
  • Zellen mit unsichtbaren Spaces nach letztem Eintrag sollen ignoriert werden.
• Falls Fehler beim wiederholten "Upload" soll die Tour erhalten bleiben.
• Nach Upload "Zoom to full extent" festlegen und mit Daten speichern (oder jeweils berechnen).

Download:

• Weitere Formate, z.B. Excel (.xlsx) oder Office Calc (.odx)?

GUI:

• Reihenfolge in Karte interaktiv umstellen (vgl. OpenLayers Knacknuss).
• Nicht erkannte Adressen interaktiv als Marker in Karte setzen.
• Anzeige Abfahrtszeit in Adressenliste, editierbar.
• Option "Mittlere Aufenthaltsdauer" (Default für Dauer des Aufenthalt bei jedem Zwischenhalt, z.B. 2h)
  • Neue "Session" (=> Button "Neu")? vorher noch Fragen, ob die Seite wirklich verlassen werden soll. D.h. mit JavaScript verhindern, dass der Benutzer die Seite verlässt! Fragen, ob Daten nicht gespeichert werden sollen (bzw. Window verlassen) => <script> window.onbeforeunload = function(){ return "wirklich verlassen?"; } </script>
• Anzeigen der zuletzt aufgerufenen Touren, so wie das http://bitly.com/ auch macht (aufgrund Cookie?).

Statisches Layout:

• Werbung rechts einbauen (verwalten).
• Icons statt Weblinks in den Tabs (Vorlage, Upload, Download, etc.)
• Kleiner Versatz des Balkens oben rechts beim HSR-Logo um ein Pixel beheben (ist ev. mit Icons obsolet).
• Disabling von Funktionen, falls nicht sinnvoll (z.B. "Download, Verbessern").

Verschiedenes/Allgemeines:

• Geocodieren: Falls Adresse nicht erkannt wird => Grau machen und ignorieren.
• Marker nicht nur mit Nummer sondern neu auch mit Name beschriften
• Logging von "Neu erstellen Tourenplan" und von Löschen.
• Job robuster machen für weniger Ausfallzeiten à la EOSMDBOne

Print:

• Editieren (Druck-)Titel und -Beschreibung
• Speichern (Druck-)Titel und -Beschreibung
• Drucken (Druckansicht) = Print View = Drucken mit Liste und Karte

Ideen

• Stau-Vermeidung: Ist Stau für den nächsten Tag (wählbar) prognostiziert, wird zuerst versucht, die Tour-Reihenfolge anzupassen oder aber eine Umfahrung vorgeschlagen.
• Verwalten ganze Kontakte-Stamm in sep. Tab.;
  • Kontakt editieren und neuer hinzufügen.
  • Kontakte für Tour einzeln in Liste selektieren/deselektieren.
  • Kontakte für Tour in Karte selektieren/deselektieren.
  • Kontakte in Karte mit Lasso selektieren.
  • Download ganzer Kontakte-Stamm.
  • Kontakte synchronisieren/anbinden (zusätzlich zum CSV-Upload); verlangt kostenloses Konto (MyTourpl):
  • Importieren von Outlook-Kontakten (mit Plugin; funktioniert für Outlook 2007 und 2010; Realisierungsansatz: SmartClient AddIn für Microsoft Outlook).
    • Importieren von MS Exchange-Kontakten
    • Importieren von Google-Kontakten und anderen Social Software (vgl. OpenInviter).

• GUI:
  • Editieren und Hinzufügen von Adressen direkt in der Liste
• Nahe beieinander liegende Marker?
• Version für Mobiles

Premium-Funktionen:

• Stau-Vermeidung
• Unlimitierte Anzahl Routen
• Werbefrei
• Kalender-Anbindung (Google, Outlook, Exchange)
• Version für Mobiles/Smartphone
• Priorisierter Betrieb
• Editieren und Selektieren im Kontakt-Stamm

Realisierung

Zum Tourpl-Tagesrapport.

Use Cases:

1. UC1 "Tour erstellen":

• User: Tourpl starten
• User: Adressliste vorbereiten (CSV-Format)
• User: Upload Adressliste
• System: Eröffnet neue Tour:
  • tour_id generiert (verkürzte uuid)
  • Längen- und Breitengrade ergänzt durch Yahoo Geocoding
  • dann in sqlite DB persistiert
  • Umleitung uf tourpl.ch/?id=tour_id (besser direkt im Pfad à la Doodle)
  • Darstellung gemäss Reihenfolge Adressliste mit openlayers in Karte (Markers numerisch und mit Name) und mit JQuery in Liste

2. UC2 "Tour manuell verbessern":

3. UC3 "Tour optimieren lassen" (Prio 3)

• User: Wählt "Optimieren"
• System: Berechnet Liste neu mit TSP-Heuristik und (vorläufig) direkte Distanzen zwischen den 'Posten'.

4. UC4 "Tour download" (CVS-Datei):

• User: Wählt "Download"
• System: Defaults Start um 08:00 Uhr, Aufenthalt 1h

5. UC5 "Neue Tour eröffnen"

• User: Button "Neu"
• USer: Neueinstieg über Startseite

6. tbd.

Spezifikation CSV-Input und -Output

Erläuterungen a la Google...: CSV in Google Contats importieren.

Kolonnen/Felder für CSV-Upload/Input (fett obligatorisch):

• Kolonnen-Namen: Name; Vorname; Anrede; Strasse; PLZ; Ort; Land; Telefon; Email; Koordinaten; Tourpl; Bemerkungen.
• Mitzugeben sind mind. die Felder Name; sowie entweder 1. Adresse; PLZ; Ort; (ev. Land) oder 2. Koordinaten.
• Felder/Kolonnen gehen keine verloren, wenn sie wie oben angegeben heissen (Case Insensitive) - ausser die Felder 'Abfahrt' und 'Dauer'.
• Die Felder 'Abfahrt' und Dauer werden beim Druck/Download überschrieben mit neuen Tourenangaben.
• Feld-Delimiter ist Strichpunkt, Komma, oder Tab. Strings-Delimiter ist Anführungszeichen.
• Die Reihenfolge der Kolonnen ist irrelevant.
• Für den mehrmaligen Upload, sollte der Upload/Import zusätzlich imstande sein, wie folgt mit dem Input umzugehen:
  • Die Kolonnen 'Abfahrt' und Dauer: Inhalt wird gelöscht und überschrieben.
  • Die Kolonnen Vorname; Telefon; Email und Bemerkungen werden eingelesen und im Download wieder mitgegeben (aber noch nicht angezeigt).
  • Zeilen, die aus weniger als drei Werte in den Kolonnen haben, werden ignoriert. Das betrifft konkret auch die Wegbeschreibung (vgl. dort) des Outputs.

Kolonnen/Felder für CSV-Download/Druckansicht:

• Alle eingelesenen Kolonnen. Reihenfolge der Kolonnen...
• Kolonnen-Namen: Abfahrt; Dauer; Name; Vorname; Anrede; Adresse; PLZ; Ort; Land; Telefon; Email; Koordinaten; Bemerkungen.
• Der Feld-Delimiter ist Strichpunkt. Strings-Delimiter ist Anführungszeichen (später als Option?).
• Das Feld 'Abfahrt' enthält die Tageszeit-Angabe, wann die Tour weitergeht zum nächsten Zwischenhalt.
• Das Feldformat für Koordinaten ist Lat/Lon.

Beispiel für CSV-Upload/Input:

 Strasse            ;Ort          ;PLZ  ;Land      ;Name
 "Oberseestr. 10"   ;"Rapperswil" ;8640 ;"Schweiz" ;"HSR"
 "Jonastrasse 8"    ;"Wald ZH"    ;8636 ;"Schweiz" ;"Schreinerei"
 "Roosstrasse 53"   ;"Wollerau"   ;8832 ;"Schweiz" ;"Conrad Electronic" 

Beispiel für CSV-Download/Druckansicht mit Wegbeschreibung (man beachte auch neue Reihenfolge der Kolonnen!): (Vorgabe Dauer bei Zwischenhalt ist 01:00h; und Vorgabe Dauer bei "Reise nach..." ist 0:30h).

 X;Abfahrt;Dauer;Name                     ;Strasse         ;Ort         ;PLZ ; Land    ;Vorname; Anrede; Telefon; Email; Bemerkungen; Koordinaten
 X;08:00 ;      ;"Schreinerei"            ;"Jonastrasse 8" ;"Wald ZH"   ;8636;"Schweiz"; ; ; ; ; ;"47.27613,8.91014"
  ;08:00 ;00:30 ;"Fahrt nach Rapperswil"  ;;;;;;;;;
 X;08:30 ;01:00 ;"HSR"                    ;"Oberseestr. 10";"Rapperswil";8640:"Schweiz"; ; ; ; ; ;"47.22306,8.81651"
  ;09:30 ;00:30 ;"Fahrt nach Wollerau"    ;;;;;;;;;
 X;10:00 ;01:00 ;"Conrad Electronic"      ;Roosstrasse 53" ;"Wollerau"  ;8832;"Schweiz"; ; ; ; ; ;"47.18978,8.72249"
  ;11:00 ;00:30 ;"Rückfahrt nach Wald ZH" ;;;;;;;;;
 X;11:30 ;      ;"Schreinerei"            ;"Jonastrasse 8" ;"Wald ZH"   ;8636;"Schweiz"; ; ; ; ; ;"47.27613,8.91014"

History

• Upload:
  • Permalink ohne "=", d.h. neu mit "no padding" ("=") (Standard "Base32, uppercase" ist ok und lässt das zu). Sonst kann der Link nicht in Mails verschickt werden. => Sorry: Wollte schreiben lowercase (also "Base32, lowercase, no padding")
  • Umlaute auch in ANSI/cp1251 (MS Excel).
  • Berücksichtigen derjenigen Kontakte, die im Tourpl-Feld einen Wert (ein "X") haben (Feldname und Inhalt case insensitive).
  • Falls es kein Tourpl-Feld gibt, so sollen - wie bisher - alle Adressen importiert werden
  • Feldname darf "Adresse" oder neu "Strasse" heissen.
  • Robusterer CSV-Upload (Reader), u.a. mit Leerzeilen, etc..
  • Wenn die CSV-Vorlage in MS Excel (unter Windows) importiert und wieder gespeichert (bzw. als CSV exportiert) wird, gibt es immer noch Fehler beim Upload in Tourpl. Das Problem scheint die Codierung zu sein: Die Vorlage hat Filecodierung UNIX/ANSI und nach Speicherung durch Excel hat es PC/ANSI.
• GUI:
  • Visuelles Umordnen (=> Code von Michael Weibel).
  • Anzeige wahlweise OpenStreetMap oder Google Satellit. => "Google Hybrid" ([2]) ist noch besser - und ohne das komische Feld "Kartendaten: Grafiken (c) 2011 Terrametrics <Schließen>"
  • Die Layernamen sollen anstelle "lines" und "Markers" neu heissen "Tour" und "Adressnummer"
  • Anzeige Name - Ort (statt "Adresse" /Strasse).
  • Nach Umarrangieren und "Verbessern" soll der aktuelle Ausschnitt der Karte erhalten bleiben.
• Statisches Layout:
  • Werbung einbauen, ev. Layout (CSS) anpassen. Banner im Format "Wide Skyscraper" (gem. Standard-Werbeform IAB), d.h. 160 Pixel breit x 600 Pixel hoch, max. 50 kB, Dateiformate GIF, PNG, JPEG. Es kann auch ein animiertes SWF sein.
  • Neues FavIcon einbauen
• Verschiedenes:
  • http://labs.geometa.info/tourpl/ löschen