Dokumentation Interaktive Online-Visualisierung Ganglinien

Überblick
URL-Parameter
Beispiele

Ü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

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:

http://pegelonline.wsv.de/webservices/zeitreihe/visualisierung?

Nach dem Fragezeichen werden Parameter angegeben, die die Darstellung beeinflussen. Dabei ist der Parameter pegelnummer von mindestens einem Pegel zwingend erforderlich (es sind maximal sechs möglich):

http://pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegelnummer=23700205

Eine Liste mit Pegelnummern steht hier zur Verfügung.

Weitere Parameter können mit einem & aneinander gehängt werden. Beispiele finden Sie weiter unten.

nach oben

URL-Parameter

Name	Beschreibung	Default
pegelnummer	Nummer eines darzustellenden Pegels in einer Einzelgrafik. Der Parameter kann wiederholt, bis zu sechs mal, in einer Url auftreten.	-
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 ganzjährig in MEZ. Beispiel: start=2010-10-25T11:00 für den 25.Oktober 2010 11:00 Uhr MEZ.	Zeitpunkt vor 30 Tagen
ende	Optionale Angabe des Endzeitpunkts der Zeitreihe. Der Zeitpunkt wird uhrzeitgenau angegeben nach folgender Syntax: jjjj-mo-ttThh:mm ganzjährig in MEZ. Beispiel: ende=2010-10-29T09:00 für den 29.Oktober 2010 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“

nach oben

Beispiele

Darstellung des Pegels Maxau (Pegelnummer 23700205).

http://pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegelnummer=23700205

Darstellung des Pegels Maxau (Pegelnummer 23700205) und Mainz (Pegelnummer 25100107) in der Einzelansicht.

http://pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegelnummer=23700205&pegelnummer=25100107

Darstellung des Pegels Maxau (Pegelnummer 23700205) und Mainz (Pegelnummer 25100107) in der Mehrfachansicht.

http://pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegelnummer=23700205&pegelnummer=25100107&ansicht=mehrfach

Darstellung des Pegels Mainz (Pegelnummer 25100107) mit Angabe von Start- und Endzeitpunkt vom 02. May 2012 09:00 Uhr bis zum 14. May 2012 16:00 Uhr.

http://pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegelnummer=25100107&start=2012-05-02T09:00&ende=2012-05-14T16:00

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

<iframe 
	src="http://pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegelnummer=23700205&eingebettet=ja"
	scrolling="no" 
	marginheight="0" 
	marginwidth="0" 
	frameborder="0" 
	width="940" 
	height="450" 
	style="">
</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="http://pegelonline.wsv.de/webservices/zeitreihe/visualisierung?pegelnummer=23700205&eingebettet=ja"
	scrolling="no" 
	marginheight="0" 
	marginwidth="0" 
	frameborder="0" 
	width="730" 
	height="450" 
	style="">
</iframe>

nach oben