Flusspegel - Versionsgeschichte

Ph1959de: Sichtung / Bearbeitung der letzten Änderung; Formatierung der Einfügung auf Syntaxhighlight umgestellt

2021-11-26T14:23:33Z

Sichtung / Bearbeitung der letzten Änderung; Formatierung der Einfügung auf Syntaxhighlight umgestellt

← Nächstältere Version		Version vom 26. November 2021, 16:23 Uhr
Zeile 37:		Zeile 37:

	Alternative: Verwendung des Moduls [[JsonMod]].		Alternative: Verwendung des Moduls [[JsonMod]].
	define ElbePegelWittenberg JsonMod ~~<nowiki>~~https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/W/currentmeasurement.json~~</nowiki>~~		<syntaxhighlight lang="text">
	attr ElbePegelWittenberg alias Pegel Wittenberg		define ElbePegelWittenberg JsonMod https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/W/currentmeasurement.json
	attr ElbePegelWittenberg readingList single((jsonPathf('$.value', '%0.2f')/100), 'pegel', 0);;		attr ElbePegelWittenberg alias Pegel Wittenberg
	attr ElbePegelWittenberg stateFormat pegel		attr ElbePegelWittenberg readingList single((jsonPathf('$.value', '%0.2f')/100), 'pegel', 0);;
			attr ElbePegelWittenberg stateFormat pegel
			</syntaxhighlight>
	Ein dazugehöriges [[FileLog\|Logfile]] könnte so definiert sein:		Ein dazugehöriges [[FileLog\|Logfile]] könnte so definiert sein:

Sinus61: Alternative JsonMod zur Abfrage hinzugefügt

2021-11-26T11:48:03Z

Alternative JsonMod zur Abfrage hinzugefügt

← Nächstältere Version		Version vom 26. November 2021, 13:48 Uhr
Zeile 36:		Zeile 36:
	</syntaxhighlight>		</syntaxhighlight>

			Alternative: Verwendung des Moduls [[JsonMod]].
			define ElbePegelWittenberg JsonMod <nowiki>https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/W/currentmeasurement.json</nowiki>
			attr ElbePegelWittenberg alias Pegel Wittenberg
			attr ElbePegelWittenberg readingList single((jsonPathf('$.value', '%0.2f')/100), 'pegel', 0);;
			attr ElbePegelWittenberg stateFormat pegel
	Ein dazugehöriges [[FileLog\|Logfile]] könnte so definiert sein:		Ein dazugehöriges [[FileLog\|Logfile]] könnte so definiert sein:

Ph1959de: auf umgestellt; Wikify etc.

2021-11-04T10:28:36Z

<source> auf <syntaxhighlight> umgestellt; Wikify etc.

← Nächstältere Version		Version vom 4. November 2021, 12:28 Uhr
Zeile 10:		Zeile 10:
	Einen konkreten amtlichen Pegel findet man, indem man im ersten Schritt die UUID des gewünschten Pegels in https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations.json herausfindet. Für den Pegel Elbe, Lutherstadt Wittenberg ist das die UUID "5c47b0ce-f33f-769b-1a02-89bf7772cb0d2878". Im zweiten Schritt wird die URL-Vorlage		Einen konkreten amtlichen Pegel findet man, indem man im ersten Schritt die UUID des gewünschten Pegels in https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations.json herausfindet. Für den Pegel Elbe, Lutherstadt Wittenberg ist das die UUID "5c47b0ce-f33f-769b-1a02-89bf7772cb0d2878". Im zweiten Schritt wird die URL-Vorlage

	<~~source~~ lang="html">		<syntaxhighlight lang="html">
	https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/[UUID]/W/currentmeasurement.json		https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/[UUID]/W/currentmeasurement.json
	</~~source~~>		</syntaxhighlight>

	mit der gefundenen UUID konkretisiert. Im Ergebnis erhält man eine URL mit den Daten (mehr als nur die Pegelhöhe selbst) des gewünschten Pegels, beispielsweise für den Pegel Elbe, Lutherstadt Wittenberg, den man im Browser testweise aufruft:		mit der gefundenen UUID konkretisiert. Im Ergebnis erhält man eine URL mit den Daten (mehr als nur die Pegelhöhe selbst) des gewünschten Pegels, beispielsweise für den Pegel Elbe, Lutherstadt Wittenberg, den man im Browser testweise aufruft:

	<~~source~~ lang="html">		<syntaxhighlight lang="html">
	https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/W/currentmeasurement.json		https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/W/currentmeasurement.json
	</~~source~~>		</syntaxhighlight>

	Da sich ~~Flußpegel~~ nicht sprunghaft ändern, sollte die Abfragehäufigkeit eine Stunde (3600) nicht unterschreiten.		Da sich Flusspegel nicht sprunghaft ändern, sollte die Abfragehäufigkeit eine Stunde (3600) nicht unterschreiten.

	==Integration in FHEM==		==Integration in FHEM==
	<~~source~~ lang="html">		Zur regelmäßigen Abfrage der Daten wird das Modul [[HTTPMOD]] verwendet.
			<syntaxhighlight lang="html">
	define ElbePegelWittenberg HTTPMOD https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/W/currentmeasurement.json 3600		define ElbePegelWittenberg HTTPMOD https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/W/currentmeasurement.json 3600
	attr ElbePegelWittenberg alias Pegel Wittenberg		attr ElbePegelWittenberg alias Pegel Wittenberg
Zeile 33:		Zeile 34:
	attr ElbePegelWittenberg stateFormat {sprintf("%.0f",ReadingsVal($name,"pegel",0))}		attr ElbePegelWittenberg stateFormat {sprintf("%.0f",ReadingsVal($name,"pegel",0))}
	attr ElbePegelWittenberg userReadings pegel:value.* {ReadingsVal($name,"value",0)}		attr ElbePegelWittenberg userReadings pegel:value.* {ReadingsVal($name,"value",0)}
	</~~source~~>		</syntaxhighlight>

	Ein dazugehöriges Logfile könnte so definiert sein:		Ein dazugehöriges [[FileLog\|Logfile]] könnte so definiert sein:

	<~~source~~ lang="html">		<syntaxhighlight lang="html">
	define FileLog_ElbePegelWittenberg FileLog ./log/ElbePegelWittenberg-%Y.log ElbePegelWittenberg		define FileLog_ElbePegelWittenberg FileLog ./log/ElbePegelWittenberg-%Y.log ElbePegelWittenberg
	attr FileLog_ElbePegelWittenberg logtype text		attr FileLog_ElbePegelWittenberg logtype text
	</~~source~~>		</syntaxhighlight>

	Die grafische Darstellung ließe sich dann so realisieren:		Die [[SVG\|grafische Darstellung]] ließe sich dann so realisieren:

	<~~source~~ lang="html">		<syntaxhighlight lang="html">
	define SVG_FileLog_ElbePegelWittenberg SVG FileLog_ElbePegelWittenberg:SVG_FileLog_ElbePegelWittenberg:CURRENT		define SVG_FileLog_ElbePegelWittenberg SVG FileLog_ElbePegelWittenberg:SVG_FileLog_ElbePegelWittenberg:CURRENT
	</~~source>~~		</syntaxhighlight>

	~~Die dazugehörige GRafikdatei SVG_FileLog_ElbePegelWittenberg.gplot~~
	~~<source lang="html"~~>

			Die dazugehörige Grafikdatei SVG_FileLog_ElbePegelWittenberg.gplot
			<syntaxhighlight lang="html">
	# Created by FHEM/98_SVG.pm, 2018-04-09 21:30:11		# Created by FHEM/98_SVG.pm, 2018-04-09 21:30:11
	set terminal png transparent size <SIZE> crop		set terminal png transparent size <SIZE> crop
Zeile 69:		Zeile 69:

	plot "<IN>" using 1:2 axes x1y2 title 'Pegel Wittenberg' ls l2fill lw 1 with steps		plot "<IN>" using 1:2 axes x1y2 title 'Pegel Wittenberg' ls l2fill lw 1 with steps
	</~~source~~>		</syntaxhighlight>
	Eine vollständige Dokumentation der WebServices findet man unter https://www.pegelonline.wsv.de/webservice/guideRestapi . FHEM-Forenthread findet sich unter https://forum.fhem.de/index.php/topic,97570.0.html .

	==Abflussmenge==		==Abflussmenge==
	Die eigentlich interessantere Abflussmenge kann über eine geringfügig andere URL abgefragt werden: In der ermittelten URL ist lediglich das "W" durch "Q" zu ersetzen, im obigen Beispiel also		Die eigentlich interessantere Abflussmenge kann über eine geringfügig andere URL abgefragt werden: in der ermittelten URL ist lediglich das "W" durch "Q" zu ersetzen, im obigen Beispiel also

	<~~source~~ lang="html">		<syntaxhighlight lang="html">
	https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/Q/currentmeasurement.json		https://www.pegelonline.wsv.de/webservices/rest-api/v2/stations/070b1eb4-3872-4e07-b2e5-e25fd9251b93/Q/currentmeasurement.json
	</~~source~~>		</syntaxhighlight>

	==Einzelwert "trend"==		==Einzelwert "trend"==
Zeile 83:		Zeile 82:

	== Links ==		== Links ==
	* vollständige Dokumentation der WebServices von [https://www.pegelonline.wsv.de/webservice ~~PeglOnline~~]		* vollständige Dokumentation der WebServices von [https://www.pegelonline.wsv.de/webservice/guideRestapi PegelOnline]
	* Diskussion über das Thema in {{Link2Forum\|Topic=97570\|LinkText=diesem Forenthread}}		* Diskussion über das Thema in {{Link2Forum\|Topic=97570\|LinkText=diesem Forenthread}}

	[[Kategorie:Code_Snippets]]		[[Kategorie:Code_Snippets]]

Curt: /* Datenlieferant */

2019-04-03T21:23:13Z

Datenlieferant

← Nächstältere Version		Version vom 3. April 2019, 23:23 Uhr
Zeile 5:		Zeile 5:

	==Datenlieferant==		==Datenlieferant==
	Es gibt mehrere Bundesämter, die die Daten der offiziellen deutschen Flusspegel vorhalten. Von Interesse sind die Daten der Wasserstraßen- und Schifffahrtsverwaltung des Bundes: Sie werden im json-Format bereitgestellt. Damit ist die Integration in FHEM problemlos möglich. Zudem kann Pegelonline mit 200 Millionen Abfragen im Jahr als stabiler, langfristig verfügbarer Dienst angesehen werden.		Es gibt mehrere Bundesämter, die die Daten der offiziellen deutschen Flusspegel vorhalten. Von Interesse sind die Daten der Wasserstraßen- und Schifffahrtsverwaltung des Bundes: Sie werden im json-Format bereitgestellt. Damit ist die Integration in FHEM problemlos möglich. Zudem kann '''Pegelonline''' mit 200 Millionen Abfragen im Jahr als stabiler, langfristig verfügbarer Dienst angesehen werden.

	==Pegeldaten finden==		==Pegeldaten finden==

Curt am 3. April 2019 um 18:48 Uhr

2019-04-03T18:48:59Z

← Nächstältere Version		Version vom 3. April 2019, 20:48 Uhr
Zeile 1:		Zeile 1:
	~~{{Baustelle}}~~

	Der [[{{PAGENAME}}\|Artikel "Flusspegel"]] beschreibt das Vorgehen zur Integration eines amtlichen deutschen Flusspegels in FHEM.		Der [[{{PAGENAME}}\|Artikel "Flusspegel"]] beschreibt das Vorgehen zur Integration eines amtlichen deutschen Flusspegels in FHEM.

Curt: Dank an ITZBund weg, Autor weg. Link auf Autor ggf doch sinnvoll?

2019-04-03T18:48:25Z

Dank an ITZBund weg, Autor weg. Link auf Autor ggf doch sinnvoll?

← Nächstältere Version		Version vom 3. April 2019, 20:48 Uhr
Zeile 1:		Zeile 1:
	{{Baustelle}}		{{Baustelle}}

	Der [[{{PAGENAME}}\|Artikel "Flusspegel"]] ~~(Autor: {{Link2FU\|?????\|curt}}])~~ beschreibt das Vorgehen zur Integration eines amtlichen deutschen Flusspegels in FHEM.		Der [[{{PAGENAME}}\|Artikel "Flusspegel"]] beschreibt das Vorgehen zur Integration eines amtlichen deutschen Flusspegels in FHEM.

	==Etwas Theorie==		==Etwas Theorie==
Zeile 87:		Zeile 87:
	* vollständige Dokumentation der WebServices von [https://www.pegelonline.wsv.de/webservice PeglOnline]		* vollständige Dokumentation der WebServices von [https://www.pegelonline.wsv.de/webservice PeglOnline]
	* Diskussion über das Thema in {{Link2Forum\|Topic=97570\|LinkText=diesem Forenthread}}		* Diskussion über das Thema in {{Link2Forum\|Topic=97570\|LinkText=diesem Forenthread}}

	~~==Dank==~~
	~~Der Autor dieses Artikels dankt den Mitarbeitern des Informationstechnikzentrum Bund (ITZBund), die schnell, kompetent und freundlich Fragen beantworteten.~~

	[[Kategorie:Code_Snippets]]		[[Kategorie:Code_Snippets]]

Curt: erstmal Abschnitt Links

2019-04-03T18:46:42Z

erstmal Abschnitt Links

← Nächstältere Version		Version vom 3. April 2019, 20:46 Uhr
Zeile 83:		Zeile 83:
	==Einzelwert "trend"==		==Einzelwert "trend"==
	Der bei beiden URL auch gelieferte Wert "trend" ist laut Aussage ITZBund "künftig wegfallend".		Der bei beiden URL auch gelieferte Wert "trend" ist laut Aussage ITZBund "künftig wegfallend".

			== Links ==
			* vollständige Dokumentation der WebServices von [https://www.pegelonline.wsv.de/webservice PeglOnline]
			* Diskussion über das Thema in {{Link2Forum\|Topic=97570\|LinkText=diesem Forenthread}}

	==Dank==		==Dank==

Curt: zwei Ergänzungen

2019-03-12T04:33:44Z

zwei Ergänzungen

@@ Zeile 73: / Zeile 73: @@
 </source>
 Eine vollständige Dokumentation der WebServices findet man unter https://www.pegelonline.wsv.de/webservice/guideRestapi . FHEM-Forenthread findet sich unter https://forum.fhem.de/index.php/topic,97570.0.html .
 ==Dank==

Curt: /* Integration in FHEM */

2019-02-19T22:50:21Z

Integration in FHEM

← Nächstältere Version		Version vom 20. Februar 2019, 00:50 Uhr
Zeile 72:		Zeile 72:
	plot "<IN>" using 1:2 axes x1y2 title 'Pegel Wittenberg' ls l2fill lw 1 with steps		plot "<IN>" using 1:2 axes x1y2 title 'Pegel Wittenberg' ls l2fill lw 1 with steps
	</source>		</source>
	Eine vollständige Dokumentation der WebServices findet man unter https://www.pegelonline.wsv.de/webservice/guideRestapi .		Eine vollständige Dokumentation der WebServices findet man unter https://www.pegelonline.wsv.de/webservice/guideRestapi . FHEM-Forenthread findet sich unter https://forum.fhem.de/index.php/topic,97570.0.html .

	==Dank==		==Dank==

Curt: /* Integration in FHEM */

2019-02-19T22:20:56Z

Integration in FHEM

← Nächstältere Version		Version vom 20. Februar 2019, 00:20 Uhr
Zeile 50:		Zeile 50:
	</source>		</source>

			Die dazugehörige GRafikdatei SVG_FileLog_ElbePegelWittenberg.gplot
			<source lang="html">

			# Created by FHEM/98_SVG.pm, 2018-04-09 21:30:11
			set terminal png transparent size <SIZE> crop
			set output '<OUT>.png'
			set xdata time
			set timefmt "%Y-%m-%d_%H:%M:%S"
			set xlabel " "
			set title 'Pegel Wittenberg'
			set ytics
			set y2tics
			set grid y2tics
			set ylabel ""
			set y2label "Pegel"
			set yrange [0:8]
			set y2range [0:800]

			#FileLog_ElbePegelWittenberg 4:ElbePegelWittenberg.pegel\x3a::

			plot "<IN>" using 1:2 axes x1y2 title 'Pegel Wittenberg' ls l2fill lw 1 with steps
			</source>
	Eine vollständige Dokumentation der WebServices findet man unter https://www.pegelonline.wsv.de/webservice/guideRestapi .		Eine vollständige Dokumentation der WebServices findet man unter https://www.pegelonline.wsv.de/webservice/guideRestapi .