Idee
Die Idee hinter dem elevation-service ist es die frei verfügbaren Höheninformationen in einer Datenbank so aufzubereiten, dass diese in der Feuerwehreinsatzkarte eingebunden werden können.
Da sich die aufbereiteten Höhendaten im Feuerwehrwesen sehr gut mit der Berechnung von Schlauchleitungen verknüpfen lassen, wird auch hierfür eine Schnittstelle zur Verfügung gestellt.
Durch die einfache Abfrage mittels REST Schnittstelle sollen aber auch andere Programme/Entwickler im Umfeld des Team122 leichten Zugriff auf diese Höhendaten erhalten.
Derzeit werden die Daten in folgenden Programmen verwendet:
Entwicklung / Support
Hauptentwicker:
Jost Samuel
(FF Abtei und FF TUGraz)
Unterstützung:
Stefan Hofer (FF Saalfelden)
Florian Bischof (FF Kennelbach)
Support:
info@122.co.at
Genauigkeit
Bei der Verwendung der API und den darauf aufbauenden Services des Team122 ist immer im Hinterkopf zu behalten auf welcher Datengrundlage diese API basiert.
Die Höhendaten stammen aus einer Laserscannbefliegung mit hoher Auflösung, veröffentlicht werden diese Daten allerdings nur im 10x10m Raster. Das bedeutet der Höhenwert den die API übergibt ist ein Mittel der wahren Werte aus 100 m².
Daraus ergeben sich je nach, Steilheit des Geländes und Abweichung der abgefragten Koordinate zum Mittelpunkt der jeweiligen Rasterzelle unterschiedlich große Differenzen zur Wirklichkeit.
Verwendung
Die Verwendung der API ist in erster Linie für Entwicklungen / Programme im Umfeld des Team122 gedacht.
Eine Verwendung der API von Programmen / Entwicklern mit ähnlicher Zielsetzung wie die des Team122 ist denkbar,
bei Interesse an einer Verwendung der Schnittstelle einfach an den
Support (info@122.co.at) wenden.
Eine Verwendung der API zur kommerziellen Nutzung ist ausgeschlossen!
Syntax Höhendaten:
/elevation.php
Mit den WGS84 Koordinaten des Punktes als Paramter
Returnparameter:
lat
- LAT Koordinaten des Punktes (kann sich bei Datenlöchern ev. vom Abfragepunkt unterscheiden)
lng
- LNG Koordinaten des Punktes (kann sich bei Datenlöchern ev. vom Abfragepunkt unterscheiden)
elevation
- Höhe des Punktes aus dem DGM [m]
Syntax Schlauchleitung:
/elevation_schlauchleitung.php
Mit den Eckpunkten der Schlauchleitung als WGS84 Koordinaten:
lat
- Array mit den LAT Koordinaten
lng
- Array mit den LNG Koordinaten
weitere optionale Parameter sind:
bar_grenze
- Druckverlust auf der Leitung bis zur nächsten Pumpe [Default: 8]
reibung
- Länge der ebenen Leitung die einen Bar Druckverlust verursacht [Default: 100]
reserve
- Faktor für die einberechnete Schlauchreserve für nicht gerade verlegeter Schläuche in % [Default: 10]
Returnparameter:
p_lat
- Array mit LAT Koordinaten der berechneten Pumpenstandorte
p_lng
- Array mit LNG Koordinaten der berechneten Pumpenstandorte
p_bar
- Array mit berechnetem Druckverlust vom Beginn der Leitung bis zu jeder Pumpe
p_dh_sum
- Array mit den Höhenunterschieden vom Beginn zu jeder Pumpe
p_dist3d_sum
- Array mit der 3 dimensionalen Leitungslänge in m für jede Pumpe
p_schlauch_nr
- Array mit der Anzahl der Schläuche bis zu jeder Pumpe
p_H
- Array mit den Absoluthöhen der Pumpenstandorte