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: 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:
- 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). |