Vorlage:XDMS/Doku

Diese Seite ist die Dokumentations-Unterseite der Vorlage:XDMS.

Diese Vorlage ersetzt eine Geo-Koordinate im Format D/M/S (Degree, Minutes, Seconds) durch die entsprechende Gradzahl. Zum Beispiel:

{{subst:XDMS|50/22/12/N}}  →  50.37
{{subst:XDMS|7/31/8/W}}    →  -7.518889

Einfache Gradzahlen werden unverändert durchgereicht; Leerdaten werden ignoriert:

{{subst:XDMS|36.7632}}  →  36.7632
{{subst:XDMS|}}         →  

Dadurch kann man die Vorlage auch dann für automatische Umwandlungen einsetzen, wenn Koordinaten in gemischtem Format vorliegen oder unvollständig sind.

Ungültige Eingaben werden erkannt. Bei zu großen oder zu kleinen Zahlen oder ungültigen Himmelsrichtungen wird die Ausgabe „Parameterfehler bei XDMS“ erzeugt. Bei unzulässigem Zahlenformat, zum Beispiel Eingabe eines Buchstabens, erscheint ein „Expression-Fehler“.

Die Ausgabe von {{subst:XDMS}} kann mit der Vorschaufunktion überprüft werden.

Rundungsoption

{{subst:XDMS}} rundet die berechneten Zahlen normalerweise auf sechs Nachkommastellen. Das genügt, um hundertstel Bogensekunden – entsprechend ca. einem Zentimeter auf der Erdoberfläche – verlustfrei wiederzugeben. Wenn eine davon abweichende Genaugkeit gewünscht ist, kann mit dem zweiten Parameter eine bestimmte Zahl von Nachkommastellen angegeben werden, zum Beispiel:

{{subst:XDMS|7/31/8/E|8}}    →  7.51888889
{{subst:XDMS|7/31/8/E|4}}    →  7.5189
{{subst:XDMS|7/31/8/E|2}}    →  7.52

Diese Möglichkeit sollte nur in wohlüberlegten Ausnahmefällen genutzt werden. Mehr als sechs Nachkommastellen erzeugen unnötige Datenmengen, und bei weniger Stellen kann unter Umständen nicht mehr exakt in das DMS-Format zurückgewandelt werden.