Stage: int, Release: 1184, Branch: master, Commit: c5261181, Gebaut: 24.10.2024, 13:12:00
WSV
PEGELONLINE PEGELONLINE Webservices PEGELONLINE

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: Für die Darstellung im Browser ist die Aktivierung von Javascript erforderlich.

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://pegelonline-int.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://pegelonline-int.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

NameBeschreibungDefault
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://pegelonline-int.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://pegelonline-int.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://pegelonline-int.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 Thu Oct 17 09:00:00 CEST 2024 Uhr bis zum Tue Oct 29 16:00:00 CET 2024 Uhr.

https://pegelonline-int.wsv.de/webservices/zeitreihe/visualisierung?pegeluuid=a37a9aa3-45e9-4d90-9df6-109f3a28a5af&start=Thu Oct 17 09:00:00 CEST 2024&ende=Tue Oct 29 16:00:00 CET 2024

Folgende Darstellung der Ganglinie ist eine Einbettung per HTML iframe. Der dazugehörige HTML Code steht weiter unten.

<iframe
	src="https://pegelonline-int.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://pegelonline-int.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>