Dieser ChangeLog gibt Auskunft über die verschiedenen Versionen der TrackViewer-API und welche Änderungen seit der vorhergehenden Version jeweils durchgeführt wurden.
Version 5/0/0 (03.12.2020)
Die 5er Version erweitert das Spektrum der verfügbaren Karten beträchtlich und legt es in die Hand
des Webmasters, welche Karten er einsetzen möchte.
Neu:
- 60 Karten von 21 Anbietern sind auswählbar, dazu kommen neue API-Optionen um die gewünschten Karten
zu selektieren und eine davon zur initialen Anzeige vorauszuwählen.
- Es gibt eine eigene Kartenseite in der API-Dokumentation mit Details zu allen Karten und Links
zu den Kartenanbietern. Zusätzlich für jeden Kartenanbieter Textvorschläge zur Gestaltung der Datenschutzerklärung.
- Der interaktive Trackviewer, der nun angepassten V.5-Code generiert, ist durch eine Kartenselektion
erweitert, mit der weitere Karten zur bestehenden Vorauswahl dazugeladen werden können.
- Weitere API-Optionen zur Hinterlegung von persönlichen API-Keys für verschiedene Kartenanbieter, so wie bisher
bereits für Thunderforest.
- Die alten Kartennamen (osm, osmc, ...) entfallen, die neuen entsprechen den Einblendungen im Kartenumschalter.
- Der Kartenumschalter wird ausgeblendet, wenn nur eine einzige Karte selektiert ist.
- Mögliche Begrenzung des maximalen Zoomlevels per API-Option
maxZoom
, default ist 22.
- Karten, die keine hohen Zoomlevel liefern, werden durch Leaflet entsprechend hoch skaliert, damit (möglichst)
keine leeren Kartenfenster entstehen.
- Das Kartenfenster erhält links unten ein Scale-Control, also eine metrische Maßstabseinblendung.
- Aktualisierungen von jQuery und Leaflet auf die aktuellen Versionen in der Dokumentation und im
generierten Beispielcode des interaktiven TrackViewers auf jQuery 3.5.1 (V1.8.3 funktioniert auch
noch) und Leaflet 1.7.1 (V1.4 funktioniert ebenfalls).
Fehlerbehebung:
- Veränderung der Größe (Resizable) des Kartenfensters des interaktiven TrackViewers ist wieder möglich.
- Der MimeType der serverseitigen JSONP-Antwort wird von
application/json
auf application/javascript
umgestellt, das vermeidet Warnungen im Browserlog.
- Das Fehlerreporting der serverseitigen Komponente wird abgeschaltet, das soll vermeiden, dass PHP-Warnungen
an den Client geschickt werden. (Das hatte negative Auswirkungen in der Applikation "TrackAnzeige".)
- Die Fehlereinblendung lag optisch links oben im Kartenfenster, aber hinter den Zoomcontrols - durch
Erhöhung des zIndex bereinigt.
Version 4/0/1 (09.11.2019)
Wechsel von OpenStreetMap.org zu OpenStreetMap.de.
Die Umstellung hat Datenschutzgründe. OpenStreetMap.org setzt bei der Anzeige der Karten Cookies,
OpenStreetMap.de tut dies nicht und ist deshalb im Geltungsbereich der europäischen DSGVO die bessere
Alternative. (Nachtrag 10.11.2020: Neu überprüft, OpenStreetMap.org setzt keine Cookies mehr)
Die API akzeptiert als Backlink nun auch einen Https-Link anstelle des bisherigen einfachen Http-Links.
Version 4/0/0 (22.04.2019)
Version 4 nutzt nicht mehr Google Maps, weder die Google Maps Karten, noch die Google Maps API,
dadurch ist auch keine Registrierung bei Google mehr erforderlich. Zum Einsatz kommt statt dessen
Leaflet, als freie Javascript API und wie bisher die OpenStreetMap Karten.
Die Version 3 bleibt aber weiterhin bestehen und ist sinnvoll für diejenigen Website-Betreiber, die
lieber Google Maps nutzen und mit Google entsprechende Entgelte vereinbart haben.
Umstieg von Version 3 auf Version 4 in kurzen Worten
- Leaflet downloaden
- Leaflet Dateien auf den Webserver hochladen (leaflet.js, leaflet.css zusammen mit dem Verzeichnis images
- Leaflet Stylesheet in die HTML-Seite einbinden
- Aufruf der Google Maps JavaScript Datei in der HTML-Seite durch den Aufruf von Leaflet.js ersetzen
Version 3/0/0 (30.06.2018)
Neu:
- Umstellung auf Https
- Eingabemöglichkeit für einen individuellen API-Key für Thunderforestkarten. Damit der Hinweis 'API Key Required' entfällt
Fehlerbehebung:
- Tracklängen unter 100m führten zu Fehler bei der Erzeugung des Höhendiagramms
- Timeout für die initiale Einblendung des Copyright-Hinweises auf 3sec erhöht, damit die Map Zeit hat zu laden
Version 2/0/1 (25.11.2012)
Fehlerbehebung:
- GPX-Dateien mit UTF-BOM (hex EF BB BF am Dateianfang) wurden nicht erkannt
Version 2/0/0 (18.07.2012)
Fehlerbehebung:
- Infolink korrigiert, der bei fehlendem Backlink anzezeigt wird
- Cacheeinstellungen für den Download der Höhenprofilgrafik verändert, damit Browser nicht cached
Version 1/0/0
Die Nuller-Versionen (0/0/x) waren die Entwicklungsstände vor der Veröffentlichung
der TrackViewer-API. Die 1er Versionen werden übersprungen, da an sich der alte
Trackviewer (vor Juli 2012) die erste Version darstellt. Die produktive TrackViewer-API
wird also mit Version 2/0/0 starten.
Version 0/0/3
Fehlerbehebung:
- Umlaut in "Höhe" (im Infowindow) als "ö" kodiert für non-UTF-8 Seiten und "m" für
Meter ergänzt
Neue Funktionen:
- .request() kann nun mehrfach aufgerufen werden
- .initMap() stellt eine Karte dar, ohne wie bei .request() eine gpx-Datei abzurufen
- Erweiterung der Userexits auf jetzt insgesamt 4
Version 0/0/2
Fehlerbehebung:
- XML-Parser: leere Routenpunkte ohne Name und Höhe führten zu Loop (analog zu GORP)
- Bei der Einblendung von Routen- oder Wegpunktnamen bei MouseOver zuvor alle HTML-Anteile
entfernen
Neue Funktionen:
- Vereinfachung: für das Höhenprofil werden nun die Ränder vorgegeben und nicht mehr
Ursprungskoordinaten und Achsenlänge. Dadurch kann die Grafikgröße verändert werden,
ohne gleichzeitig die Achslänge anpassen zu müssen.
- Neuer Parameter "scrollWheelZoom", um wie beim der alten Trackanzeige den Zoom per Mausrad
unterdrücken zu können. (Aktiv per default)
Version 0/0/1
Urversion im Juni 2012 zum Einsatz in den Wanderbeiträgen und Regionsübersichten auf
GpsWandern.de.