Dokumentation Interaktive Online-Visualisierung Ganglinien
Überblick
Mit der Interaktiven Online-Visualisierung Ganglinien können grafische Anzeigen aktueller gewässerkundlicher Zeitreihen (z.B. Wasserstandsdaten einer Messstelle der letzten drei Tage) dynamisch bezogen werden und in eine externe Webseite integriert werden.Im Gegensatz zur statischen Online-Visualisierung kann die Gangliniendarstellung durch den Benutzer in vielerlei Hinsicht verändert werden:
- Veränderung des dargestellten Ausschnitts durch Zoomen und Verschieben
- Zusätzliche Darstellung der Messdaten tabellarisch und als Tooltips
- Eingrenzung des Zeitbereichs über Schiebebalken und Kalender
Aus der interaktiven Online-Visualisierung auf PEGELONLINE ist das Open Source Projekt GIMV hervorgegangen. Es basiert auf Google Web Toolkit und erlaubt Entwicklern, interaktive Zeitreihendarstellung in eine browserbasierte Anwendung zu integrieren.
Die nachfolgende Dokumentation bezieht sich auf die Gangliniendarstellung von PEGELONLINE, nicht auf das Open Source Projekt.
Die interaktive Online-Visualisierung wird unter folgender Basis-URL zur Verfügung gestellt:
https://www.pegelonline.wsv.de/webservices/zeitreihe/visualisierung?
Nach dem Fragezeichen werden Parameter
angegeben, die die Darstellung beeinflussen. Dabei ist der Parameter
pegeluuid
von mindestens einem Pegel
zwingend erforderlich (es sind maximal sechs möglich): https://www.pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegeluuid=b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea
Bei den UUIDs handelt es sich um eindeutige und unveränderliche IDs der Pegel. Die UUIDs sind in der Pegeltabelle aufgelistet.
Bei einer Reihe von Küstenpegeln werden parallel zu den gemessenen Rohdaten astronomische Gezeitenganglinien gestrichelt dargestellt.
Weitere Parameter können mit einem & aneinander gehängt werden. Beispiele finden Sie weiter unten.
URL-Parameter
Name | Beschreibung | Default |
---|---|---|
pegeluuid | UUID eines darzustellenden Pegels. Der Parameter kann wiederholt, bis zu sechs mal, in einer Url auftreten. Die UUIDs sind in der Pegeltabelle aufgelistet. | - |
parameter | Optionale Angabe des Namens des Parameters, Groß- und Kleinschreibung spielt keine Rolle. | „Wasserstand Rohdaten“ |
start | Optionale Angabe des Anfangszeitpunkts der Zeitreihe. Der Zeitpunkt wird uhrzeitgenau angegeben nach folgender Syntax: jjjj-mo-ttThh:mm. Beispiel: start=2016-10-25T11:00 für den 25.Oktober 2016 11:00 Uhr. | Zeitpunkt vor 30 Tagen |
ende | Optionale Angabe des Endzeitpunkts der Zeitreihe. Der Zeitpunkt wird uhrzeitgenau angegeben nach folgender Syntax: jjjj-mo-ttThh:mm. Beispiel: ende=2016-10-29T09:00 für den 29.Oktober 2016 09:00 Uhr. | 00:00 Uhr des aktuellen Folgetages |
ansicht | Der Wert einzeln stellt einzelne Gangliniendarstellungen untereinander dar. Der Wert mehrfach führt alle Ganglinien in einer Darstellung zusammen. | „einzeln“ |
eingebettet | Wird hier ja angegeben, so wird eine Version für die Einbettung als iframe erzeugt. Dabei wird z.B. der Kopfbereich mit dem PEGELONLINE-Logo weggelassen. | „nein“ |
gesetzlicheZeit | Hierüber wird bestimmt ob die Ganglinie in gesetzlicher Zeit dargestellt wird („true“), oder, ob die Ganglinie auch in der Sommerzeit in Mitteleuropäischer Winterzeit (MEZ) angezeigt wird („false“). | „true“ |
Beispiele
Darstellung des Pegels Maxau (UUID: b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea).https://www.pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegeluuid=b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea
Darstellung des Pegels Maxau (UUID: b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea) und Mainz (UUID: a37a9aa3-45e9-4d90-9df6-109f3a28a5af) in der Einzelansicht.
https://www.pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegeluuid=b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea&pegeluuid=a37a9aa3-45e9-4d90-9df6-109f3a28a5af
Darstellung des Pegels Maxau (UUID: b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea) und Mainz (UUID: a37a9aa3-45e9-4d90-9df6-109f3a28a5af) in der Mehrfachansicht.
https://www.pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegeluuid=b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea&pegeluuid=a37a9aa3-45e9-4d90-9df6-109f3a28a5af&ansicht=mehrfach
Darstellung des Pegels Mainz (UUID: a37a9aa3-45e9-4d90-9df6-109f3a28a5af) mit Angabe von Start- und Endzeitpunkt vom 23. September 2024 09:00 Uhr bis zum 05. October 2024 16:00 Uhr.
https://www.pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegeluuid=a37a9aa3-45e9-4d90-9df6-109f3a28a5af&start=2024-09-23T09:00&ende=2024-10-05T16:00
Folgende Darstellung der Ganglinie ist eine Einbettung per HTML iframe. Der dazugehörige HTML Code steht weiter unten.
<iframe src="https://www.pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegeluuid=b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea&eingebettet=ja" scrolling="no" marginheight="0" marginwidth="0" frameborder="0" width="940" height="460"> </iframe>
Eine Darstellung der interaktiven Onlinevisualisierung ohne die Messwerttabelle am rechten Rand ist möglich, indem die Breite des iframes auf 730 Pixel begrenzt wird:
<iframe src="https://www.pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegeluuid=b6c6d5c8-e2d5-4469-8dd8-fa972ef7eaea&eingebettet=ja" scrolling="no" marginheight="0" marginwidth="0" frameborder="0" width="730" height="460"> </iframe>