Vorlage:Koordinate/Dokumentation

Beschreibung

Die Vorlage:Koordinaten hat mehrere Funktionen:

• sie dient zur einheitlichen Darstellung von Koordinaten,
• sie verlinkt zu Kartenanbietern und liefert Koordinaten für die Kartenauswahl,
• verfügt über ein Feld für die frei wählbare Darstellung der Koordinaten im Artikel,
• beinhaltet eine Kurzbeschreibung, bestimmt für den Export in Google-Earth

Syntax

Im SkipperGuide-Artikel wird diese Vorlage mit folgender Syntax eingebunden:

{{Koordinate|U|Parameter1|Parameter2|Parameter3|Parameter4}}

Die Bestandteile im Einzelnen:

{{

zeigt dem Programm an, dass eine Vorlage eingebunden werden soll (}} bedeutet das Ende eines Vorlagenbefehls).

Koordinate

ist der Titel der Vorlage, die das Programm einfügen soll. Es folgt optional die Angabe von Parametern, getrennt durch einen senkrechten Strich. Bei dieser Vorlage sind es drei Parameter:

Parameter1

Festlegung, welche Art von Landmarke die Koordinate definiert.

H - Hafen/Harbour
M - Marina
A - Ankerbucht/Anchorage
R - Region
[leer] - nicht definiert

Parameter2

SkipperGuide verlinkt die hier eingefügte Koordinate mit OpenSeaMap. Bei Klick auf die Koordinate im Artikel öffnet sich automatisch die Karte und zeigt ein Hafen-Icon an der angegebenen Stelle. Bei Klick auf das Icon in der Karte erscheint automatisch der zugehörige Artikel in SkipperGuide.

Erwartet wird eine Angabe in den folgenden Formaten (d steht für Gradzahl, m für Minutenzahl, s für Sekundenzahl, H für Angabe der Hemisphäre, also N oder S, bzw. E oder W):

d.d_H_d.d_H

beliebige Anzahl an Nachkommastellen

d_m.m_H_d_m.m

beliebige viele Nachkommastellen ausschließlich bei den Minuten

d_m_s.s_H_d_m_s.s_H

beliebige viele Nachkommastellen ausschließlich bei den Sekunden

• Als Dezimaltrennzeichen erkennt OSeaM ausschließlich einen Punkt, kein Komma.
• Unterstriche als Trennung von Gruppen können bei eindeutiger Angabe weggelassen werden.
• Leerzeichen werden allerdings falsch interpretiert, ebenso Schriftzeichen für Grad, Minuten oder Sekunden.
• Möglicherweise werden noch andere Formate erkannt.

Parameter3

Das Feld ist gedacht, um eine "lesbare" Form der Koordinaten anzugeben - so wie sie im eigentlichen Artikel erscheinen sollen. Die Form ist frei wählbar, im Zweifelsfall kopiert ihr den Inhalt vom ersten Parameter.

Für ein einheitliches Erscheinungsbild empfiehlt sich jedoch das Format

dd° mm,mmm' H  ddd° mm,mmm' H

• Bei den Grad- wie bei den Minutenangaben wird eine eventuelle führende Null (bei der Längengradzahl sind zwei Nullen möglich) immer mit ausgeschrieben.
• Bei den Minuten werden nach Bedarf bis zu drei Nachkommastellen angegeben.
• Den größeren Abstand zwischen Breiten und Längenangabe erreicht man durch die Eingabe von zwei geschützen Leerzeichen (  ). Diese Form wird auch in offiziellen Veröffentlichen verwendet, und so ist sie im Funkverkehr einschließlich der Sicherheits- und Notmeldungen zur Übermittlung von Koordinaten vorgegeben.

Die Koordinatendarstellungen werden sukzessive auf dieses Format umgestellt.

Parameter4

Hierhin gehört eine kurze Bezeichung, ursprünglich gedacht als Text, der beim Export zur Google-Earth-Darstellung die dort dargestellten Koordinaten beschreibt.

Beispiel

Als Beispiel dient die Einfahrt zum Rheinauhafen in Köln:

Folgende Beispiele unterscheiden sich in den Eingaben für Parameter1:

{{Koordinate|H|50.9321833_N_6.9637333_E|50° 55,931' N  006° 57,824' E|Rheinauhafen}}
{{Koordinate|H|50_55.931_N_6_57.824_E|50° 55,931' N  006° 57,824' E|Rheinauhafen}}
{{Koordinate|H|50_55_55.86_N_6_57_49.44.824_E|50° 55,931' N  006° 57,824' E|Rheinauhafen}}
{{Koordinate|H|50.9321833N6.9637333E|50° 55,931' N  006° 57,824' E|Rheinauhafen}}

Auf der Artikelseite wäre das Erscheinungsbild in allen vier Fällen:

Koordinaten: 50° 55,931' N  006° 57,824' E Die folgende Koordinate wurde nicht erkannt: 50° 55,931' N  006° 57,824' E.