Benutzer:Mcaviglia/Dokumentation Koordinatenvorlage

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: 46,9467° N, 7,4441° O46.9466517.444074542

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	600414 / 19950746.9466517.444074542
DMS	Grad Minuten Sekunden (Degrees Minutes Seconds, WGS84 ) - Standardausgabe	46° 56′ 48″ N, 7° 26′ 39″ O46.9466517.444074542
DM	Grad Minuten (WGS84)	46° 57′ N, 7° 27′ O46.9466517.444074542
DEC	Dezimal (WGS84)	46,9467° N, 7,4441° O46.9466517.444074542
CH1903	Schweizer Landeskoordinaten	600414 / 19950746.9466517.444074542
/CH1903	default; Schweizer Landeskoordinaten	600414 / 19950746.9466517.444074542
DMS/CH1903	Grad Minuten Sekunden; Schweizer Landeskoordinaten	46° 56′ 48″ N, 7° 26′ 39″ O (600414 / 199507)46.9466517.444074542
DM/CH1903	Grad Minuten; Schweizer Landeskooedinaten	46° 57′ N, 7° 27′ O (600414 / 199507)46.9466517.444074542
DEC/CH1903	Dezimal; Schweizer Landeskoordinaten	46,9467° N, 7,4441° O (600414 / 199507)46.9466517.444074542
/DMS	default; (Grad Minuten Sekunden)	600414 / 199507 (46° 56′ 48″ N, 7° 26′ 39″ O)46.9466517.444074542
CH1903/DMS	Schweizer Landeskoordinaten; (Grad Minuten Sekunden)	600414 / 199507 (46° 56′ 48″ N, 7° 26′ 39″ O)46.9466517.444074542
DEC/DMS	Dezimal; (Grad Minuten, Sekunden)	46,9467° N, 7,4441° O (46° 56′ 48″ N, 7° 26′ 39″ O)46.9466517.444074542
/DM	default; (Grad Minuten)	600414 / 19950746.9466517.444074542
CH1903/DM	Schweizer Landeskoordinaten; (Grad Minuten)	600414 / 19950746.9466517.444074542
DEC/DM	Dezimal; (Grad Minuten)	46,9467° N, 7,4441° O46.9466517.444074542
CH1903/DEC	Schweizer Landeskoordinaten; (Dezimal)	600414 / 199507 (46,9467° N, 7,4441° O)46.9466517.444074542
DMS/DEC	Grad Minuten Sekunden; (Dezimal)	46° 56′ 48″ N, 7° 26′ 39″ O (46,9467° N, 7,4441° O)46.9466517.444074542
DM/DEC	Grad Minuten; (Dezimal)	46° 57′ N, 7° 27′ O (46,9467° N, 7,4441° O)46.9466517.444074542
ICON0	⊙	⊙46.9466517.444074542
ICON1	▼	▼46.9466517.444074542
"freier Text"	Frei wählbarer Text (darf nicht mit „/“ beginnen)	Hier ist das Bundeshaus46.9466517.444074542

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:

• Deutschland: ISO 3166-2:DE
• Österreich: ISO 3166-2:AT
• Schweiz: ISO 3166-2: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).