Benutzer:Mcaviglia/Dokumentation Koordinatenvorlage

aus Wikipedia, der freien Enzyklopädie

Diese Vorlage ist für die Einbindung von Koordinaten in Artikeln bestimmt. Mehr Informationen zu Zweck und Zielen erfährst du auf der Projektseite WikiProjekt Georeferenzierung.

Beispiel

Dies ist der Beispielcode für die Einbundung der Koordinaten des Bundeshauses in Bern (Schweiz).

{{Coordinate|text=DEC|NS=46.946651|EW=7.444074|type=landmark|elevation=542|dim=600|region=CH-BE}}

Die Ausgabe dieses Codes sieht so aus: Parameter name fehlt in Fließtextkoordinate 46,9467° N, 7,4441° O

Kopiervorlage

{{Coordinate|text= |article= |NS= |EW= |type= |pop= |elevation= |dim= |name= |region= |sortkey= }}
{{Coordinate
|text     =X<!--Koordinate im Fliesstext  (multiple choice) X=Format der Ausgabe -->
|article  =X<!--Koordinate im Artikelkopf (multiple choice) X=Format der Ausgabe -->
|NS       =<!-- Breitengrad, negative Werte im Süden  S                          -->
           <!-- DD/MM/SS.ss/N                                       in DMS       -->
           <!-- {{subst:CH1903-WGS84|600|200||koor=B|subst=subst:}} in CH1903    -->
|EW       =<!-- Längengrad,  negative Werte im Westen W                          -->
           <!-- DD/MM/SS.ss/E                                       in DMS       -->
           <!-- {{subst:CH1903-WGS84|600|200||koor=L|subst=subst:}} in CH1903    -->
|globe    =<!-- Himmelskörper: moon, mercury, venus, earth (default), mars       -->
|type     =<!-- country     für Länder
                state       für andere Staatengebilde, nicht-souveräne Staaten ...
                adm1st      für Bundesländer, Kantone ...
                adm2nd      für Landkreise, Verwaltungsgemeinden (Samtgemeinden) ...
                city        für Städte und Stadtteile, Orte und Orts-Gemeinden
                isle        für Inseln, Inselgruppen
                airport     für Flughäfen, Luftwaffenstützpunkte ...
                mountain    für Berge, Hügel, Gebirgsketten, Pässe
                waterbody   für Gewässer: Flüsse, Seen, Gletscher, Kanäle,
                                Wasserfälle, Geysire ...
                forest      für Waldgebiete (aus EN)
                landmark    für Sehenswürdigkeiten, Landmarken, Gebäude 
                              und alles andere was nicht oben rein passt.        -->
|pop      =<!-- Einwohnerzahl                                                    -->
|elevation=<!-- Höhe über dem Meeresspiegel (amtliche Höhe der Region region)    -->
|dim      =<!-- Objektdurchmesser in Meter                                       -->
|name     =<!-- alternativer Name des Objekts                                    -->
|region   =<!-- ISO 3166-1/2 Code (mehrere Codes durch ›/‹ separiert)            -->
|sortkey  =<!-- Sortierung nach NS oder EW in sortierbaren Tabellen              -->
}}

Parameterübersicht

Parameter Beispiel Typ Erklärung Detail
article article=DMS optional Koordinate im spezifizierten Ausgabeformat (default DMS) oben rechts im Artikel.
text text=DMS optional Koordinate im spezifizierten Ausgabeformat im Fließtext.
NS NS=12.345678 fix Breitengrad (latitude) in Grad, Minuten und Sekunden oder Dezimalgrad (negative Werte beziehen sich auf die südliche Hemisphäre).
EW EW=12.345678 fix Längengrad (longitude) in Grad, Minuten und Sekunden oder Dezimalgrad (negative Werte beziehen sich auf Bereiche westlich des Nullmeridians).
type type=landmark optional Typ des georeferenzierten Objekt.
pop pop=100000 optional Einwohnerzahl (population) des georeferenzierten Objekts.
elevation elevation=8000 optional Höhe über dem Meeresspiegel des georeferenzierten Objekts (in Meter, ohne irgendwelche Tausendertrennzeichen).
dim dim=100 optional Durchmesser des Umkreises in Metern (Dimension des georeferenzierten Objekts).
region region=DE-SN optional Region(en mit ›/‹ separiert) des georeferenzierten Objekts.
name name=Wrack der Titanic optional Name des georeferenzierten Objekts, falls dieser nicht dem Lemma des Artikels entspricht.
sortkey sortkey=NS optional Sortierung nach Breitengrad (›NS‹) und Längengrad (›EW‹) in sortierbaren Tabellen (im Fließtext).

Parameter article und text

Der Inhalt dieser Felder bestimmt das Ausgabeformat. Durch die Parameter text und article werden die Ausgabemöglichkeiten der drei alten Vorlagen in einer Vorlage zusammengefasst.

Wird ein Parameter angegeben, so erfolgt am entsprechenden Ort eine Ausgabe. Bei text wird das im Fließtext sein und bei article oben rechts im Artikel. Wird weder text noch article in der Vorlage eingegeben, so erfolgt die Standardausgabe oben rechts im Format DMS (1° 2′ 3″ N 4° 5′ 6″ E) im Artikel.

Bei der Standardausgabe oben rechts wird immer das Format DMS ausgegeben. Wird mit dem Parameter article ein Spezialformat angegeben, so wird dieses zusätzlich dahinter angefügt, zum Beispiel 1° 2′ 3″ N 4° 5′ 6″ E (UTM 123456 N 123456 E). Spezialformate werden immer mit Name benannt. Der Leser soll erkennen können, welches Format zusätzlich angegeben wird.

Im Fließtext wird ebenfalls standardmäßig DMS angewendet. Alle anderen im Parameter text angegebenen Formate werden ohne Name in Klammern angehängt. Das Format sollte sich aus dem Kontext ergeben (zum Beispiel innerhalb von Infoboxen). Wird beim Parameter text ein beliebiger Text eingeben, der weder als Format noch als Formatkombination unterstützt wird, so wird dieser als Text im Fließtext ausgegeben. Dies ermöglicht das Einfügen dezenter Textlinks in den Fließtext, zum Beispiel „Lage“. Die Werte ›ICON0‹ und ›ICON1‹ setzen die Sonderzeichen ‚⊙‘ respektive ‚▼‘ ein und assoziert so eine Ortsangabe.

Beipiel:

{{Coordinate|text=DEC|article=DMS|....}}

Funktion

Die Parameter article= und text= steuern gleich zwei dinge:

1. Wo werden die Koordinaten angezeigt, sprich die Position im Artikel
2. Wie werden die Koordinaten angezeigt, sprich das Ausgabeformat

Anzeigeposition im Artikel

Die Position innerhalb des Artikels wird wie folgt gesteuert (WERT durch einen Wert für das Ausgabeformat ersetzen):


Koordinaten werden NUR im Fliesstext angezeigt

{{Coordinate|text=WERT|article=|....}}  oder  {{Coordinate|text=WERT|....}}


Koordinaten werden NUR beim Artikel oben rechts angezeigt

{{Coordinate|text=|article=WERT|....}}  oder  {{Coordinate|article=WERT|....}}


Koordinaten werden im Fliesstext UND beim Artikel oben rechts angezeigt

{{Coordinate|text=WERT|article=WERT|....}}

Ausgabeformate im Fliesstext

Die unterstützten Formate beschränken sich auf solche des öffentlichen Lebens. Dazu gehören z. B. von Rettungsdiensten verwendete Koordinatensysteme. Um das Ausgabeformat zu bestimmen wird jetzt aus den oberen Beispielen der WERT durch einen Wert aus folgender Tabelle ersetzt:

Beispiel:

{{Coordinate|text=DMS|....}}
WERT Erklärung Ausgabebeispiel
leer bzw. Null kein Fliesstext Keine Ausgabe
/ default abhängig von ISO-Code in Region Parameter name fehlt in Fließtextkoordinate 600414 / 199507
DMS Grad Minuten Sekunden (Degrees Minutes Seconds, WGS84 ) - Standardausgabe Parameter name fehlt in Fließtextkoordinate 46° 56′ 48″ N, 7° 26′ 39″ O
DM Grad Minuten (WGS84) Parameter name fehlt in Fließtextkoordinate 46° 57′ N, 7° 27′ O
DEC Dezimal (WGS84) Parameter name fehlt in Fließtextkoordinate 46,9467° N, 7,4441° O
CH1903 Schweizer Landeskoordinaten Parameter name fehlt in Fließtextkoordinate 600414 / 199507
/CH1903 default; Schweizer Landeskoordinaten Parameter name fehlt in Fließtextkoordinate 600414 / 199507
DMS/CH1903 Grad Minuten Sekunden; Schweizer Landeskoordinaten Parameter name fehlt in Fließtextkoordinate 46° 56′ 48″ N, 7° 26′ 39″ O (600414 / 199507)
DM/CH1903 Grad Minuten; Schweizer Landeskooedinaten Parameter name fehlt in Fließtextkoordinate 46° 57′ N, 7° 27′ O (600414 / 199507)
DEC/CH1903 Dezimal; Schweizer Landeskoordinaten Parameter name fehlt in Fließtextkoordinate 46,9467° N, 7,4441° O (600414 / 199507)
/DMS default; (Grad Minuten Sekunden) Parameter name fehlt in Fließtextkoordinate 600414 / 199507 (46° 56′ 48″ N, 7° 26′ 39″ O)
CH1903/DMS Schweizer Landeskoordinaten; (Grad Minuten Sekunden) Parameter name fehlt in Fließtextkoordinate 600414 / 199507 (46° 56′ 48″ N, 7° 26′ 39″ O)
DEC/DMS Dezimal; (Grad Minuten, Sekunden) Parameter name fehlt in Fließtextkoordinate 46,9467° N, 7,4441° O (46° 56′ 48″ N, 7° 26′ 39″ O)
/DM default; (Grad Minuten) Parameter name fehlt in Fließtextkoordinate 600414 / 199507
CH1903/DM Schweizer Landeskoordinaten; (Grad Minuten) Parameter name fehlt in Fließtextkoordinate 600414 / 199507
DEC/DM Dezimal; (Grad Minuten) Parameter name fehlt in Fließtextkoordinate 46,9467° N, 7,4441° O
CH1903/DEC Schweizer Landeskoordinaten; (Dezimal) Parameter name fehlt in Fließtextkoordinate 600414 / 199507 (46,9467° N, 7,4441° O)
DMS/DEC Grad Minuten Sekunden; (Dezimal) Parameter name fehlt in Fließtextkoordinate 46° 56′ 48″ N, 7° 26′ 39″ O (46,9467° N, 7,4441° O)
DM/DEC Grad Minuten; (Dezimal) Parameter name fehlt in Fließtextkoordinate 46° 57′ N, 7° 27′ O (46,9467° N, 7,4441° O)
ICON0 Parameter name fehlt in Fließtextkoordinate
ICON1 Parameter name fehlt in Fließtextkoordinate
"freier Text" Frei wählbarer Text (darf nicht mit „/“ beginnen) Parameter name fehlt in Fließtextkoordinate Hier ist das Bundeshaus

Ausgabeformate bei Artikel Koordinaten

Um das Ausgabeformat zu bestimmen wird jetzt aus den oberen Beispielen der WERT durch einen Wert aus folgender Tabelle ersetzt:

Beispiel:

{{Coordinate|article=DMS|....}}
Parameter Erklärung Ausgabe
leer bzw. Null keine Artikelkoordinate keine
/ Grad Minuten Sekunden; default abhängig von ISO-Code in Region Siehe Ausgabebeispiel beim Fliesstext
DMS Grad Minuten Sekunden Siehe Ausgabebeispiel beim Fliesstext
DMS/CH1903 DMS; CH1903: Schweizer Landeskoordinaten Siehe Ausgabebeispiel beim Fliesstext

Rechnerische Umwandlungen und Kombinationen

Es können maximal zwei Formate angegeben werden. DM und DMS schliessen sich gegenseitig aus. In diesem Fall wird nur das erstgenannte Format angewandt. Ist die erste Formatangabe leer (›/‹ oder ›/XYZ‹) so wird mit erster Priorität das lokal bevorzugte Format, welches sich aus der region-Angabe ergibt, umgesetzt. Gibt es keine lokale Präferenz so kommt ›DMS‹ zur Anwendung. ›DMS‹, ›DEC‹, ›CH1903‹ (, ›UTM‹, ›OSGB36‹) sowie ›DM‹, ›DEC‹, ›CH1903‹ (, ›UTM‹, ›OSGB36‹) sind beliebig kombinierbar.

Im Artikel wird der Name des zweiten Formats diesem vorangestellt. DMS ist immer das erste Format.
Nicht implementierte Umwandlungen erfolgen in DMS
Infoboxen können, das Default-Format mit {{CoordinateRR DEFAULT}} ermitteln und so zu den Koordinaten passenden Text ausgeben.

Textuelle Ersetzungen

›ICON0‹, ›ICON1‹ sowie die individuelle Textwahl müssen an erster Stelle stehen. An zweiter Stelle werden diese nicht berücksichtigt. Ein zweites Format wird ignoriert. Wird im ersten Teil keine Formatierungsanweisung erkannt, so wird der gesamte Text (inklusive ‚/‘) eingesetzt. Ein individueller Text kann nicht mit ‚/‘ beginnen (siehe oben: rechnerische Umwandlungen).

Parameter NS und EW

NS steht für North/South (Nord und Süd) und EW für East/West (Ost und West). Werden Dezimalgrad angegeben, so bedeuten negative Werte südliche Breiten- bzw. westliche Längengrade. Breiten- und Längengrad sind Pflichtangaben, fehlt eine, so wird das als Lagewunsch interpretiert und im Hauptnamensraum in die Kategorie:Wikipedia:Lagewunsch eingetragen.

{{Coordinate|....|NS=WERT|EW=WERT|...}}
Parameter Beschreibung
NS Geographische Breite, Latitude in Grad, Minuten und Sekunden oder Dezimalgrad (Bei Dezimalgrad negative Werte für südliche Breitengrade)
EW Geographische Länge, Longitude in Grad, Minuten und Sekunden oder Dezimalgrad (Bei Dezimalgrad negative Werte für westliche Längengrade)

Mögliche Eingabeformate:

Format Parameter WERT Beschreibung
Dezimal NS 46.946651 Max. 6 Nachkommastellen, negative Werte für südliche Breitengrade
Dezimal EW 7.444074 Max. 6 Nachkommastellen, negative Werte für westliche Längengrade
DMS NS 46/56/47.94/N Grad, Minuten und Sekunden
DMS EW 7/26/38.6664/E Grad, Minuten und Sekunden

In Infoboxen, die auch Vorlagen (z.B. Vorlage:Positionskarte) einbinden, die die Koordinaten in Dezimalgrad benötigen, können diese mit den Unter-Vorlagen {{CoordinateLAT|{{{NS|}}} }} für den Breitengrad, respektive {{CoordinateLONG|{{{EW|}}} }} für den Längengrad, erzeugt werden. Damit entfallen in diesen Infoboxen die Umrechnungen und die Koordinaten können ebenfalls komfortabel in DMS oder Dezimalgrad angegeben werden.


Parameter globe

Legt fest auf welchem Planeten die Koordinaten anwendung finden.

Code:

{{Coordinate|....|globe=WERT|....}}

Werte:

Wert Beschreibung
leer bzw. null Erde, ist default und muss nicht angegeben werden.
earth Erde, ist default und muss nicht angegeben werden.
moon Objekte auf dem Mond
mercury Objekte auf dem Merkur
mars Objekte auf dem Mars
venus Objekte auf dem Venus

Parameter type

Die Angabe type=WERT ermöglicht die Festlegung der Art einer Koordinate. Dadurch lassen sich z. B. in GIS-Programmen thematische Darstellungen erzeugen, weil aus der riesigen Masse an Koordinatenangaben z. B. nur alle Inseln oder Berge herausgefiltert werden können. Diese Angabe ist zwar nicht notwendig, aber erwünscht – ein anderer Benutzer muss sie sonst per Hand nachträglich pflegen. type ist verwandt mit Kategorien.

Beispiel:

{{Coordinate|....|type=WERT|...}}
WERT Beschreibung
country für Länder
state für andere Staatengebilde, nicht-souveräne Staaten …
adm1st für Bundesländer, Kantone …
adm2nd für Landkreise, Verwaltungsgemeinden (Samtgemeinden) …
city für Städte und Stadtteile, Orte und Orts-Gemeinden
isle für Inseln, Inselgruppen
airport für Flughäfen, Luftwaffenstützpunkte …
mountain für Berge, Hügel, Gebirgsketten, Pässe
waterbody für Flüsse, Seen, Gletscher, Kanäle, Wasserfälle, Geysire …
landmark für Landmarken, Sehenswürdigkeiten, Pläzte, Gebäude und alles andere was nicht oben rein passt.

Parameter pop, elevation und dim

pop

pop steht für Population (Bevölkerung).

{{Coordinate|....|pop=5000|....}}

elevation

elevation steht für Höhe über dem Meeresspiegel. Relevant ist die amtliche Höhe von region (sieh Parameter region) in Metern.

{{Coordinate|....|elevation=1234|....}}

dim

Die Dimension-Angabe (Größenangabe).

Dabei handelt es sich um den ungefähren Objektdurchmesser bzw. die Diagonale in Metern.

Beispiel eines Gebäudes mit 50 m diagonaler Ausdehnung:

{{Coordinate|....|dim=50|....}}

Parameter region

Die Angabe region=WERT ermöglicht es, das georeferenzierte Objekt einem Staat und/oder einer Region zuzuordenen. Dadurch kann auch beim automatischen Vorschlagen von Kartenressourcen die Ausgabe so optimiert werden, dass nur noch für die entsprechende Region geeignete Kartenressourcen angezeigt werden.

Die gültigen Werte findet ihr unter ISO 3166-1-Codes für Staaten bzw.ISO 3166-2-Code für subnationale Einheiten wie Bundesländer oder Kantone.


Beispiel für den Staat Schweiz (ISO-3166-1 Code)

{{Coordinate|....|region=CH|....}}


Beispiel für ein Objekt im Kanton Bern in der Schweiz (ISO-3166-1 UND ISO-3166-2 Code)

{{Coordinate|....|region=CH-BE|....}}


Beispiel für ein Objekt in Bayern, Deutschland (ISO-3166-1 UND ISO-3166-2 Code)

{{Coordinate|....|region=DE-BY|....}}

Zusätzlich gibt es die Schnell-Links für D-A-CH:

Einige geographische Punkte lassen sich mehreren Staaten/Regionen zuordnen, weil sie genau auf der Grenze liegen (Bsp: Four Corners). Weitere Regionen können mit ›/‹ separiert angehängt werden.


Four Corners:

{{Coordinate|....|region=US-AZ/US-CO/US-NM/US-UT|....}}


Die Vorlage wertet die ersten vier Regionen aus. Dies ist für alle (Punkt-)Koordinaten ausreichend. Nur am Südpol treffen noch mehr Sektoren zusammen, diese sind aber international umstritten (siehe Antarktisvertrag).

Parameter name

Der Name des Georeferenzierten Objekt kann hier speziell spezifiziert werden, falls dieser nicht dem Lemma (Titel, Schlagwort) des Artikels entspricht. Werden im Fließtext mehrere Koordinaten eingegeben, sollten diese durch sinnvolles Benennen ebenfalls unterscheidbar sein. Der Bezeichner ›coordinates‹ ist geschützt (CSS id der Artikel-Koordinate).

Der Name ist gleichzeitig auch der Tool-Tip des Linkes. ACHTUNG: Der ausgegebene Link Text kann nur über das Ausgabeformat beim Parameter text= gesteuert werden. Der Name wird also nicht als Link Text angezeigt, sondern erst wenn der Mauszeiger auf den Link zeigt.

Beispiel:

{{Coordinate|....|name=Bundeshaus in Bern|....}}

Wird kein Name spezifiziert (CSS: id="text coordinates") wird der Link mit dem {{FULLPAGENAME}} unterlegt.


Parameter sortkey

Der Sortierschlüssel legt fest, nach welchen Kriterien in Tabellen sortiert werden kann. Wird kein Schlüssel angegeben, können die Koordinaten in Tabellen nicht sortiert werden. Der Parameter ist also nur in sortierbaren Tabellen von Nutzen und sollte auch nur in diesen gebraucht werden.


Code:

{{Coordinate|....|sortkey=WERT|....}}

Werte:

Wert Erklärung
NS Sortieren nach Breitengrad - Nord (positive Dezimalgrad) ist grösser als Süd (negative Dezimalgrad)
EW sortieren nach Längengrad - Ost (positive Dezimalgrad) ist grösser als West (negative Dezimalgrad).