Schön, dass Sie da sind!

PlusPedia wird derzeit technisch modernisiert. Wie alles, was bei laufendem Betrieb bearbeitet wird, kann es auch hier zu zeitweisen Ausfällen bestimmter Funktionen kommen. Es sind aber alle Artikel zugänglich, Sie können PlusPedia genauso nutzen wie immer.

Bei PlusPedia sind Sie sicher: – Wir verarbeiten keine personenbezogenen Daten, erlauben umfassend anonyme Mitarbeit und erfüllen die Datenschutz-Grundverordnung (DSGVO) vollumfänglich. Es haftet der Vorsitzende des Trägervereins.

Bitte beachten: Aktuell können sich keine neuen Benutzer registrieren. Wir beheben das Problem so schnell wie möglich.

PlusPedia blüht wieder auf als freundliches deutsches Lexikon.
Wir haben auf die neue Version 1.43.3 aktualisiert.
Wir haben SSL aktiviert.
Hier geht es zu den aktuellen Aktuelle Ereignissen

Hinweis zur Passwortsicherheit:
Bitte nutzen Sie Ihr PlusPedia-Passwort nur bei PlusPedia.
Wenn Sie Ihr PlusPedia-Passwort andernorts nutzen, ändern Sie es bitte DORT bis unsere Modernisierung abgeschlossen ist.
Überall wo es sensibel, sollte man generell immer unterschiedliche Passworte verwenden! Das gilt hier und im gesamten Internet.
Aus Gründen der Sicherheit (PlusPedia hatte bis 24.07.2025 kein SSL | https://)

Vorlage:Coordinate/Doku: Unterschied zwischen den Versionen

Aus PlusPedia
Zur Navigation springen Zur Suche springen
Wanderfalke (Diskussion | Beiträge)
Fmrauch (Diskussion | Beiträge)
Mikroformat: bild fehlt
 
(30 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
<noinclude>{{Dokumentation/Dokuseite}}</noinclude>[[Datei:Geo microformat.png|right|geo-microformat]][[Datei:Gnome-globe.png|right|120px|Globus]]


{{Übersicht Georeferenzierung}}
Diese Vorlage ist für die Einbindung von WGS84-Koordinaten in Artikeln bestimmt. Dadurch können Orte automatisch auf einer Landkarte angezeigt werden.


Diese Vorlage ist für die Einbindung von [[World Geodetic System 1984|WGS84]]-Koordinaten in Artikeln bestimmt. Sie prüft, formatiert und verlinkt die Daten und ermöglicht so eine automatische Auswertung. Weiterführende Informationen sind unter [[#Weiteres]] aufgeführt.
→ '''[[#toc|Inhaltsverzeichnis]]'''


;Kopiervorlagen
Beispiel: Der Code zur Einbindung der Koordinaten von der Porta Nigra in Trier lautet:<br />
* um einen Artikel mit einer Koordinate zu versehen: <code style="display:inline-block; padding:.5em 1em; border:1px dashed #2f6fab;">&#123;&#123;Coordinate|[[#NS|NS]]=|[[#EW|EW]]=|[[#type|type]]=|[[#region|region]]=&#125;&#125;</code>
<pre>
* um einen Koordinatenlink im Artikeltext einzufügen: <code style="display:inline-block; padding:.5em 1em; border:1px dashed #2f6fab;">&#123;&#123;Coordinate|[[#NS|NS]]=|[[#EW|EW]]=|[[#type|type]]=|[[#region|region]]=|[[#text|text]]=|[[#name|name]]=&#125;&#125;</code>
{{Coordinate|NS=49.759681|EW=6.6440194|type=landmark|dim=25|region=DE-RP}}
oder
{{Coordinate|NS=49/45/34.85/N|EW=6/38/38.47/E|type=landmark|dim=25|region=DE-RP}}
</pre>


;→ [[Wikipedia:WikiProjekt Georeferenzierung/Kurzanleitung|Kurzanleitung]]
== Kopiervorlage ==
<!--
<!--|globe    =<!-- Himmelskörper: moon, mercury, venus, earth (default), mars -->
{{Coordinate <small>|[[#map|map]]=</small> |[[#article|article]]= |[[#text|text]]=  
<nowiki>
{{</nowiki>Coordinate <small>|[[#map|map]]=</small> |[[#article|article]]= |[[#text|text]]=  
  |'''[[#NS|NS]]'''= |'''[[#EW|EW]]'''= |'''[[#type|type]]'''= |[[#pop|pop]]= |[[#elevation|elevation]]= |'''[[#region|region]]'''= |[[#dim|dim]]= |[[#name|name]]=
  |'''[[#NS|NS]]'''= |'''[[#EW|EW]]'''= |'''[[#type|type]]'''= |[[#pop|pop]]= |[[#elevation|elevation]]= |'''[[#region|region]]'''= |[[#dim|dim]]= |[[#name|name]]=
<small>|[[#mapsize|mapsize]]= |[[#sortkey|sortkey]]= </small><nowiki>
}}</nowiki>
'''Grundkonstrukt <small>Artikelkoordinate</small>'''
<pre>
{{Coordinate|NS=|EW=|type=|region=}}
</pre>
NS=          Breitengrad in der Form Grad/Minute/Sekunde/Himmelsrichtung
              Bsp. NS=49/45/34.85/N  oder
              Breitengrad als Dezimalangabe  (kein Vorzeichen für nördliche Breite, negatives Vorzeichen für südliche Breite)
              Bsp. NS=49.759681
EW=          Längengrad in der Form Grad/Minute/Sekunde/Himmelsrichtung
              Bsp. EW=6/38/38.47/E  oder
              Längengrad als Dezimalangabe
              Bsp. EW=6.6440194  (kein Vorzeichen für östliche Länge, negatives Vorzeichen für westliche Länge)
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 Flüsse, Seen, Gletscher, Kanäle, Wasserfälle, Geysire
              landmark  für Sehenswürdigkeiten, Landmarken, Gebäude und alles andere was nicht oben rein passt
region=      Länder-/Regionencode nach ISO 3166-1 und ISO 3166-2 muss angegeben werden
              Bsp. für Niedersachsen DE-NI, für Berlin DE-BE, für Wien AT-9
'''Zusätzliche Angaben'''
text=        Koordinate im Fließtext  (multiple choice) [[#Formate|Format]] der Ausgabe, verlangt zusätzlich ''name'' des Objekts
article=    Koordinate im Artikelkopf (multiple choice) [[#Formate|Format]] der Ausgabe
              / für default
map=        Koordinate auf Positionskarte
              none für keine Ausrichtung der Karte
              left    Ausrichtung links im Fließtext
              right    Ausrichtung rechts im Fließtext
mapsize=    ###      (maximale) Kartenbreite
                x###  maximale  Höhe,
              ###x###  maximales umgebendes Rechteck
              leer    (ohne Parameterwert) thumbsize-Benutzereinstellung
                      default (ohne Parameter) 240 Pixel
maplevel=    [global, continental, national, adm1st, adm2nd]
maptype=    [relief]
pop=        Einwohnerzahl
              zu type country, state, adm1st, adm2nd, city oder isle
elevation=  Höhe über dem Meeresspiegel (amtliche Höhe der Region region)
dim=        Objektdurchmesser in Meter
name=        Name des Objekts (falls abweichend vom Artikellemma)
              zwingend bei Fließtextkoordinaten
globe=      Himmelskörper: moon, mercury, venus, earth (default), mars
sortkey=    Sortierung nach NS oder EW in sortierbaren Tabellen
Einfache Hilfsmittel zur Koordinatenermittlung gibt es für Google Earth [http://www.alder-digital.de/wiki/index.php?title=Koord-ermittlungs-Tool hier] und mit Google Maps [http://www.mcaviglia.ch/gmap/get_coor_ext.asp?l=de hier].
<!-- Inhaltsverzeichnis erst hier, die Kurzanleitung geht sonst wieder unter -->
__TOC__
== Mikroformat ==
Die Vorlage unterstützt das GEO-[[Mikroformate|Mikroformat]].<ref>[http://microformats.org/wiki/geo geo-microformats]</ref> Die semantische Textauszeichnung geschieht mit den CSS-Klassen ›geo‹, ›latitude‹, ›longitude‹ und ›elevation‹. Diese Klassen sind für diesen Zweck reserviert und dürfen nicht anderweitig verwendet werden.


<small>|[[#mapsize|mapsize]]= |[[#sortkey|sortkey]]= </small>
<small>Die Klasse ›elevation‹ wurde erst kürzlich zur Standardisierung vorgeschlagen<ref>[http://microformats.org/wiki/geo-extension-elevation geo-extention-elevation]</ref> und ist noch kein Standard.</small>
}}
-->


== Parameter ==
== Parameter ==
{| class="wikitable float-right" style="width:30%; max-width:25em; min-width:15em;"
=== Übersicht ===
|+ Kurzübersicht
{| class="wikitable"
|-
|- class="hintergrundfarbe6"
| <code style="font-weight:bold;">[[#NS|NS]]</code>
! Parameter
| Breitengrad (latitude)
! Beispiel
! width="50"| Typ
! Erklärung
! width="30"| Detail
|-
|-
| <code style="font-weight:bold;">[[#EW|EW]]</code>
| '''NS'''
| Längengrad (longitude)
| style="text-align:center"| NS=12.345678
| style="text-align:center"| fix
| Breitengrad (latitude) in Grad, Minuten und Sekunden oder Dezimalgrad (negative Werte beziehen sich auf die südliche Hemisphäre).
| style="text-align:center"|[[#NS und EW|]]
|-
|-
| <code style="font-weight:bold;">[[#type|type]]</code>
| '''EW'''
| Typ des Objekts
| style="text-align:center"| EW=12.345678
| style="text-align:center"| fix
| Längengrad (longitude) in Grad, Minuten und Sekunden oder Dezimalgrad (negative Werte beziehen sich auf Bereiche westlich des [[Nullmeridian]]s).
| style="text-align:center"|[[#NS und EW|]]
|-
|-
| <code style="font-weight:bold;">[[#region|region]]</code>
| '''type'''
| Regions-Code(s) nach [[ISO 3166-2]]
| style="text-align:center"| type=landmark
| style="text-align:center"| optional
| Typ des georeferenzierten Objekt.
| style="text-align:center"|[[#type|→]]
|-
|-
| <code>[[#globe|globe]]</code>
| '''pop'''
| Himmelskörper
| style="text-align:center"| pop=100000
| style="text-align:center"| optional
| Einwohnerzahl (population) des georeferenzierten Objekts.
| style="text-align:center"|[[#pop und elevation|]]
|-
|-
| <code>[[#dim|dim]]</code>
| '''elevation'''
| Durchmesser des Umkreises (dimension)
| style="text-align:center"| elevation=8000
| style="text-align:center"| optional
| [[Höhe über dem Meeresspiegel]] des georeferenzierten Objekts (in Meter, ohne irgendwelche Tausendertrennzeichen).
| style="text-align:center"|[[#pop und elevation|→]]
|-
|-
| <code>[[#elevation|elevation]]</code>
| '''dim'''
| [[Höhe über dem Meeresspiegel]]
| style="text-align:center"| dim=100
| style="text-align:center"| optional
| Durchmesser des Umkreises in Metern (Dimension des georeferenzierten Objekts).
| style="text-align:center"|[[#dim|→]]
|-
|-
| <code>[[#pop|pop]]</code>
| '''region'''
| Einwohnerzahl (population)
| style="text-align:center"| region=DE-SN
| style="text-align:center"| optional
| Region(en mit ›/‹ separiert) des georeferenzierten Objekts.
| style="text-align:center"|[[#region|]]
|-
|-
| <code>[[#name|name]]</code>
| '''globe'''
| Name
| style="text-align:center"| region=moon
| style="text-align:center"| optional
| Himmelskörper, auf dem sich das referenzierte Objekt befindet.
| style="text-align:center"|[[#globe|]]
|-
|-
| <code>[[#simple|simple]]</code>
| '''name'''
| schnellere Vorlage mit eingeschränktem Funktionsumfang
| style="text-align:center"| name=Wrack der Titanic
| style="text-align:center"| optional
| Name des georeferenzierten Objekts, falls dieser nicht dem Lemma des Artikels entspricht.
| style="text-align:center"|[[#name|]]
|-
|-
| <code>[[#article|article]]</code>
| '''sortkey'''
| Koordinatenformat oben rechts im Artikel
| style="text-align:center"| sortkey=NS
| style="text-align:center"| optional
| Sortierung nach Breitengrad (›NS‹) und Längengrad (›EW‹) in sortierbaren Tabellen (im Fließtext).
| style="text-align:center"|[[#sortkey|]]
|-
|-
| <code>[[#text|text]]</code>
| '''article'''
| Koordinatenformat im Fließtext
| style="text-align:center"| article=DMS
| style="text-align:center"| optional
| Koordinate im spezifizierten Format (default DMS) oben rechts im Artikel.
| style="text-align:center"|[[#article und text|]]
|-
|-
| <code>[[#sortkey|sortkey]]</code>
| '''text'''
| Sortierbarkeit nach NS oder EW
| style="text-align:center"| text=DMS
| style="text-align:center"| optional
| Koordinate im spezifizierten Format im Fließtext.
| style="text-align:center"|[[#article und text|]]
|-
|-
| <code>[[#tooltip|tooltip]]</code>
| '''map'''
| individueller [[Tooltip]]
| style="text-align:center"| map=right
|-
| style="text-align:center"| optional
| <code>[[#tooltipformat|tooltipformat]]</code>
| Koordinatenformat im Tooltip
|-
| <code>[[#map|map]]</code>
| Positionskarte
| Positionskarte
| style="text-align:center"|[[#map|→]]
|-
|-
| <code>[[#mapsize|mapsize]]</code>
| '''mapsize'''
| style="text-align:center"| mapsize= x180
| style="text-align:center"| optional
| Größe der Karte
| Größe der Karte
| style="text-align:center"|[[#mapsize|→]]
|-
|-
| <code>[[#maplevel|maplevel]]</code>
| '''maplevel'''
| übergeordnete Positionskarte
| style="text-align:center"|maplevel   = adm1st
|-
| style="text-align:center"| optional
| <code>[[#maptype|maptype]]</code>
| Abweichende Karte auf der ISO Skala rauf und runter: Wertebereich [global, continental, national, adm1st, adm2nd]
| Kartentyp
| style="text-align:center"|[[#maplevel|]]
|-
| <code>[[#maplabel|maplabel]]</code>
| Kartenmarkierungs&shy;beschriftung
|-
|-
| <code>[[#maplayer|maplayer]]</code>
| '''maptype'''
| Bildunterschrift der Karte
| style="text-align:center"|maptype  = relief
| style="text-align:center"| optional
| Anzeige einer physischen Karte anstelle der normalen, politischen Karte
| style="text-align:center"|[[#maptype|]]
|}
|}


=== Eingabedaten ===
=== Parameter im Detail ===
==== {{Anker|NS|EW|NS und EW}} Breiten- und Längengrad ====
 
''NS'' steht für North/South (Nord und Süd) und ''EW'' für East/West (Ost und West). Die Angabe ist jeweils sowohl dezimal in [[Grad (Winkel)|Grad]] als auch im „Degrees/[[Winkelminute|Minutes]]/[[Winkelsekunde|Seconds]]“-Format möglich; die Werte beziehen sich auf die [[World Geodetic System 1984|WGS84]]-Referenz. Die Angabe von [[Geographische Breite|Breiten-]] und [[Geographische Länge|Längengrad]] ist Pflicht. Fehlt eines davon, so wird das als [[Lagewunsch]] interpretiert.


Die Dezimaldarstellung ist nach Norden bzw. Osten gerichtet, negative Werte beziehen sich auf die südliche Hemisphäre bzw. auf Bereiche westlich des [[Nullmeridian]]s. In der DMS-Darstellung müssen Grad, Minuten und Sekunden einen positiven Wert haben. Sie und die Angabe der Himmelsrichtung (<code>N</code>, <code>O</code>/<code>E</code>, <code>S</code> und <code>W</code>) werden über drei [[Schrägstrich]]e miteinander verknüpft. Der Platz für die Sekunden kann dabei auch leergelassen werden; nicht ganzzahlige Werte sind dann auch bei den Minuten erlaubt. Beispiele:
==== {{Anker|NS}}{{Anker|EW}}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:Geographische Lage gewünscht]] eingetragen.
<pre>
<pre>
|NS = 45.123456
|NS= 45.123456
|EW = -12.123456
|EW=-12.123456


|NS = 55/44/33.22/N
|NS= 55/44/33.22/N
|EW = 11/22/33.44/W
|EW= 11/22/33.44/W
</pre>
</pre>


{{Anker|Schweizer Landeskoordinaten}}[[Schweizer Landeskoordinaten]] können mithilfe der [[Vorlage:CH1903-WGS84]] umgerechnet werden. Diese wird dazu [[Hilfe:Vorlagen#Vorlagen verwenden|substituiert]]:
In der DMS-Darstellung müssen Grad, Minuten und Sekunden einen positiven Wert haben. Das negative Vorzeichen muss zwingend über die Angabe von ›S‹ oder ›W‹ erfolgen. Ein negatives Vorzeichen ist nur in reiner Dezimal-Schreibweise möglich.
 
In Infoboxen, die auch Vorlagen einbinden, die die Koordinaten in Dezimalgrad benötigen, können diese mit den Unter-Vorlagen <tt>&#123;&#123;[[Vorlage:CoordinateLAT|CoordinateLAT]]|&#123;&#123;&#123;NS|&#125;&#125;&#125; &#125;&#125;</tt> für den Breitengrad, respektive <tt>&#123;&#123;[[Vorlage:CoordinateLONG|CoordinateLONG]]|&#123;&#123;&#123;EW|&#125;&#125;&#125; &#125;&#125;</tt> 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.
 
===== Schweizer Landeskoordinaten =====
Längen- und Breitengrad können mit einer [[Hilfe:Vorlagen#Vorlagen verwenden|Substitution]] direkt aus den [[Schweizer Landeskoordinaten]] ermittelt werden.


<small>Beispiel: Bern (600'000/200'000)
<small>Beispiel: Bern (600'000/200'000)
<pre style="padding:.5em 1em; margin:0;">|NS = {{subst:CH1903-WGS84|600|200|koor=B}}
|NS= &#123;{subst:[[Vorlage:CH1903-WGS84|CH1903-WGS84]]|600|200||koor=B}}
|EW = {{subst:CH1903-WGS84|600|200|koor=L}}
|EW= &#123;{subst:CH1903-WGS84|600|200||koor=L}}
|region = CH-BE</pre></small>
|region=CH-BE</small>
 
==== type ====
Die Angabe <tt>type=XX</tt> ermöglicht die Festlegung der Art einer Koordinate. Dadurch lassen sich z.&nbsp;B. in [[Geoinformationssystem|GIS]]-Programmen thematische Darstellungen erzeugen, wenn aus der riesigen Masse an Koordinatenangaben z.&nbsp;B. nur alle Inseln oder Berge herausgefiltert werden sollen. Diese Angabe ist zwar nicht notwendig, aber erwünscht. Der Parameter ''type'' ist verwandt mit dem Konzept der Kategorien. Als Symbole werden kleine Bilder verwendet.


==== {{Anker|type}} Art des Objekts ====
Die Angabe des Parameters <code>type</code> ermöglicht die Festlegung der Art des georeferenzierten Objekts, eine Art [[Wikipedia:Kategorien|Kategorisierung]]. Dadurch lassen sich z.&nbsp;B. in [[Geoinformationssystem|GIS]]-Programmen thematische Darstellungen erzeugen, weil aus der riesigen Masse an Koordinatenangaben z.&nbsp;B. nur alle Inseln oder Berge herausgefiltert werden können. Auch diese Angabe ist Pflicht.
{| class="wikitable"
{| class="wikitable"
|+ mögliche Werte
|- class="hintergrundfarbe6"
! Text in der Vorlage || Type
|-
|-
| <code>type=country</code> || für Länder
| <tt>type=country</tt> || für Länder
|-
|-
| <code>type=state</code> || für andere Staatengebilde, nicht-souveräne Staaten …
| <tt>type=state </tt> || für andere Staatengebilde, nicht-souveräne Staaten …
|-
|-
| <code>type=adm1st</code> || für Bundesländer, Kantone …
| <tt>type=adm1st </tt> || für Bundesländer, Kantone …
|-
|-
| <code>type=adm2nd</code> || für Landkreise, Verwaltungsgemeinden (Samtgemeinden) …
| <tt>type=adm2nd </tt> || für Landkreise, Verwaltungsgemeinden (Samtgemeinden) …
|-
|-
| <code>type=city</code> || für Städte und Stadtteile, Orte und Orts-Gemeinden
| <tt>type=city </tt> || für Städte und Stadtteile, Orte und Orts-Gemeinden, meist [[:Datei:Reddot.png]]
|-
|-
| <code>type=isle</code> || für Inseln, Inselgruppen
| <tt>type=isle </tt> || für Inseln, Inselgruppen
|-
|-
| <code>type=airport</code> || für Flughäfen, Luftwaffenstützpunkte …
| <tt>type=airport </tt> || für Flughäfen, Luftwaffenstützpunkte …
|-
|-
| <code>type=mountain</code> || für Berge, Hügel, Gebirgsketten, Pässe
| <tt>type=mountain </tt> || für Berge, Hügel, Gebirgsketten, Pässe - siehe [[:Datei:BlackMountain.png]]
|-
|-
| <code>type=waterbody</code> || für Flüsse, Seen, Gletscher, Kanäle, Wasserfälle, Geysire …
| <tt>type=waterbody </tt> || für Flüsse, Seen, Gletscher, Kanäle, Wasserfälle, Geysire …
|- style="font-size:smaller;"
| <code style="color:gray;">type=forest</code> || für Waldgebiete (wird in der deutschsprachigen WP nicht verwendet)
|-
|-
| <code>type=landmark</code> || für Sehenswürdigkeiten, [[Landmarke]]n, Gebäude und alles andere was nicht oben rein passt.
| <small><tt style="color:gray;">type=forest </tt></small> || <small>für Waldgebiete (en:WP, in der deutschsprachigen WP nicht verwendet) …</small>
|- style="font-size:smaller;"
| <code style="color:gray;">type=event</code> || für Ereignisse (wird in der deutschsprachigen WP nicht verwendet)
|-
|-
| <code style="color:gray;">type=example</code> || nur für interne Beispielzwecke (nicht im Artikelnamensraum)
| <tt>type=landmark </tt> || für Sehenswürdigkeiten, [[Landmarke]]n, Gebäude und alles andere was nicht oben rein passt.
|-
| <small><tt style="color:gray;">type=event </tt></small> || <small>für Ereignisse (en:WP, in der deutschsprachigen WP nicht verwendet) …</small>
|-
| <tt style="color:gray;">type=example </tt> || nur für interne Beispielzwecke (nicht im Artikelnamensraum)
|}
|}


==== {{Anker|region}} Verortung ====
==== {{Anker|pop}}{{Anker|elevation}}pop und elevation ====
Die verpflichtende Angabe <code>region=XX-YY</code> ermöglicht es, das georeferenzierte Objekt einem [[Staat]] und einer [[Region]] zuzuordnen. Die Kodierung ist durch den ISO-Standard [[ISO 3166]] festgehalten. Die ersten beiden Buchstaben stehen dabei für den [[ISO-3166-1-Kodierliste|ISO 3166-1-ALPHA2-Code]] des Staates. Erweiterbar ist er mit dem Variant-Code für die subnationale Einheit (wie Bundesländer oder Kantone) nach [[ISO 3166-2|ISO-3166-2]]-Code, der mit einem [[Bindestrich]] angefügt wird. Ist der Ländercode bekannt, kann man die Regionalcodes für jedes Land in der '''[[:Kategorie:ISO 3166-2]]''' nachschlagen. Einige geographische Punkte lassen sich mehreren Staaten/Regionen zuordnen, weil sie genau auf der Grenze liegen (etwa [[Four Corners]]). Bis zu drei weitere Regionen können mit dem Schrägstrich <kbd>/</kbd> separiert angehängt werden, was für alle (Punkt-)Koordinaten ausreichend ist <small>(Nur am [[Südpol]] treffen noch mehr Sektoren zusammen, diese sind aber [[Antarktisvertrag|international umstritten]])</small>.
''pop'' steht für Population (Bevölkerung). Der Parameter wird bei Objekten des Typs ''city'', ''adm1st'', ''adm2nd'', ''state'', ''country'' und ''isle'' an die GeoHack-Schnittstelle weitergegeben. Er ersetzt die frühere Angabe „city(5000)“ durch ein separates <pre>|pop=5000</pre>
 
''elevation'' steht für [[Höhe über dem Meeresspiegel]]. Relevant ist die amtliche Höhe von ''region'' (erster Parameter) in Metern. Dieser neue Parameter ersetzt die frühere Angabe „mountain(1234)“ durch ein separates <pre>|elevation=1234</pre>
 
==== dim ====
Dimensions- bzw. Größen-Angabe, optional.
 
Es handelt sich um den ungefähren Objektdurchmesser bzw. die Diagonale in Metern. Diese Angabe beeinflusst die initiale Vergrößerung einer Kartenansicht und ersetzt die Scale-Angabe, welche nie präzise definiert war.
 
Beispiel eines Gebäudes mit 50&nbsp;m diagonaler Ausdehnung: <pre>|dim=50</pre>
 
==== region ====
Die Angabe <tt>region=XX</tt> oder <tt>region=XX-YY</tt> ermöglicht es, das georeferenzierte Objekt einem [[Staat]] und einer [[Region]] zuzuordnen. 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 Kodierung ist durch den [[Internationale Organisation für Normung|ISO-Standard]] [[ISO 3166]] festgehalten. Das ›XX‹ steht für die zwei Buchstaben des [[ISO-3166-1-Kodierliste|ISO 3166-1-Codes]] für Staaten, das ›YY‹ steht für den [[ISO 3166-2|ISO-3166-2]]-Code für subnationale Einheiten wie Bundesländer oder Kantone. Ist der Ländercode bekannt, kann man den Regionalcode für jedes Land in der [[:Kategorie:ISO 3166-2]] nachschlagen.


Beispiel für Four Corners:
Bisher sind diese hier nur für einige Staaten vollständig:
<pre style="padding:.5em 1em; margin:0;">|region = US-AZ/US-CO/US-NM/US-UT</pre>
* Deutschland: [[ISO 3166-2:DE]]
Beispiel für ein Objekt in Bayern:
* Frankreich: [[ISO 3166-2:FR]]
<pre style="padding:.5em 1em; margin:0;">|region = DE-BY</pre>
Beispiel für ein Objekt irgendwo in Russland:
<pre style="padding:.5em 1em; margin:0;">|region = RU</pre>


{{Anker|Ozean|Ozeane}}
Einzelne Bundesländer können wie folgt - am Beispiel für Bayern - angesprochen werden:
Von den außerhalb staatlicher Hoheitsgebiete liegenden Gebieten wurde in der [[ISO-3166-1-Kodierliste]] bisher nur die Antarktis (Code AQ) berücksichtigt. Codes für die [[Ozean]]e fehlen. Bis dies von der ISO nachgeholt wird, hat sich die Wikipedia aus dem Bereich für private Nutzung in der [[ISO 3166-1]] (AA, QM–QZ, XA–XZ und ZZ) die Codes XA, XI, XN, XO, XP und XS angeeignet. Die Einteilung basiert auf der allgemein anerkannten [[Ozean#Einteilung|Einteilung]] der Ozeane:
<pre>
* '''XN''' [[Arktischer Ozean]] ''(Nordpolarmeer),''
|region    = DE-BY
* '''XA''' [[Atlantischer Ozean]] ''(Atlantik),''
</pre>
* '''XI''' [[Indischer Ozean]] ''(Indik),''
* '''XP''' [[Pazifischer Ozean]] (''Pazifik,'' auch ''Stiller Ozean'' genannt) und
* '''XS''' [[Südlicher Ozean]] ''(Südpolarmeer).''
{{Anker|Orbit}} Zusätzlich wurde '''XO''' für geostationäre Objekte im [[Umlaufbahn|Orbit]] vergeben.


{{Anker|globe}} Für Objekte auf anderen Himmelskörpern als der Erde wird dieser mit dem Parameter <code>globe</code> angegeben. Er ersetzt die Angabe der <code>region</code>, ISO-3166-Codes bezeichnen ausschließlich Regionen auf der Erde. Mögliche Werte sind die englischen Namen der Himmelskörper in Kleinschreibung; eine vollständige Liste findet sich mit der [[:Kategorie:Vorlage:Info globe]]. Eine Angabe von <code>globe=earth</code> ist überflüssig.
Einige geographische Punkte lassen sich mehreren Staaten/Regionen zuordnen, weil sie genau auf der Grenze liegen; weitere Regionen können mit /‹ separiert angehängt werden. In den USA gibt es ''Four Corners'' = Vier-Staaten-Prinzip; Beispiel:  


Beispiel für ein Objekt auf dem Mond:
<pre>
<pre style="padding:.5em 1em; margin-top:0;">|globe = moon</pre>
|region    = US-AZ/US-CO/US-NM/US-UT
</pre>


==== {{Anker|pop|elevation|pop und elevation}} Bevölkerung und Höhenangabe ====
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]]).
Mit dem Parameter <code>pop</code> ({{lang|en|''population''}}, dt. [[Bevölkerung]]) wird bei Verwaltungseinheiten, Städten und Inseln die Einwohnerzahl angegeben. Die natürliche Zahl darf keine Tausendertrennzeichen enthalten. <!-- Der Parameter wird bei Objekten des Typs ''city'', ''adm1st'', ''adm2nd'', ''state'', ''country'' und ''isle'' an die GeoHack-Schnittstelle weitergegeben. -->


Mit dem Parameter <code>elevation</code> lassen sich [[Höhenpunkt]]e festlegen. Relevant ist die innerhalb der angegebenen ''region'' (erster Teil) amtliche [[Höhe über dem Meeresspiegel]] in Metern an der Stelle der Koordinate. Die Höhe muss als Zahl übergeben werden, „von-bis“-Angaben sind nicht möglich!
==== globe ====
Die Angabe <tt>globe=XX</tt> erlaubt Koordinaten auf anderen Himmelskörpern als der Erde wie Planeten oder Monde anzugeben. Der Himmelkörper wird mit dem englischen Begriff in Kleinschreibung angegeben. Eine vollständige Liste der verfügbaren Himmelskörper befindet sich unter [[:Kategorie:Vorlage:Info globe]].  


==== {{Anker|dim}} Objektausmaße ====
Wenn globe nicht angegeben wird oder mit dem Wert <tt>globe=earth</tt> belegt wird, bezieht sich die Angabe auf die Erde. Auf anderen Himmelskörpern darf <tt>region=XX</tt> nicht belegt werden, da die Codes nach [[ISO 3166]] ausschließlich regionen auf der Erde bezeichnen.  
Der Parameter <code>dim</code> ist für eine Dimensions- bzw. Größen-Angabe vorgesehen. Es handelt sich dabei um den ungefähren Objektdurchmesser bzw. die Diagonale in Metern. Diese Angabe beeinflusst den Anfangsmaßstab einer externen Kartenansicht sowie die [[#Rundung]] der Ausgabe.


Beispiel eines Gebäudes mit 50&nbsp;m diagonaler Ausdehnung:
Objekt auf dem Mond
<pre style="padding:.5em 1em; margin-top:0;">|dim = 50</pre>
<pre>
|globe    = moon
</pre>


==== {{Anker|name}} Bezeichnung ====
===== Ozeane =====
Der Name des georeferenzierten Objekts kann, falls dieser nicht dem Lemma des Artikels entspricht, mit dem Parameter <code>name</code> spezifiziert werden. Im Fließtext ''muss'' dieser Parameter gesetzt werden; sind mehrere Koordinaten im Artikelfließtext genannt, so müssen diese durch sinnvolles Benennen unterscheidbar sein.
Für außerhalb staatlicher Hoheitsgebiete liegende Gebiete wurde bisher nur der Antarktis ein Code (AQ) zugeteilt. Codes für die [[Ozean]]e fehlen. Bis dies im ISO 3166 nachgeholt wird, hat sich die WP aus dem Bereich für private Nutzung ([[ISO 3166#ISO 3166-1|AA, QM–QZ, XA–XZ und ZZ]]) die Codes XA, XI, XN, XO, XP und XS angeeignet. Die Einteilung basiert auf der allgemein anerkannten [[Ozean#Einteilung|Einteilung]] der Ozeane:
* '''XN''' [[Arktischer Ozean]] (''Nördliches Eismeer''),
* '''XA''' [[Atlantischer Ozean]] (''Atlantik''),
* '''XI''' [[Indischer Ozean]] (''Indik''),
* '''XP''' [[Pazifischer Ozean]] (''Pazifik'', auch ''Stiller Ozean'' genannt) und
* '''XS''' [[Südlicher Ozean]] (''Südliches Eismeer'').
{{Anker|Orbit}}Zusätzlich wurde '''XO''' für geostationäre Objekte im [[Umlaufbahn|Orbit]] vergeben.


Der Name wird auch im [[#tooltip]] verwendet und dient überdies als [[Hilfe:Anker|Anker]], das heißt er kann als Ziel in [[Wikipedia:Verlinken#Überschriften|Wikilinks]] verwendet werden. Wird kein Name spezifiziert (bei Verwendung als Artikelkoordinate), so ist eine eventuelle Textausgabe als „text_coordinates“-Anker verlinkbar und als Bezeichner wird der Seitentitel verwendet.
Diese Codes ergänzen die [[ISO-3166-1-Kodierliste]].


=== Ausgabemöglichkeiten ===
==== name ====
==== {{Anker|Vorlage zu langsam?}} simple ====
Der Name des Georeferenzierten Objekt kann, falls dieser nicht dem Lemma des Artikels entspricht, hier entsprechend spezifiziert werden. Im Fließtext muss der Parameter gesetzt werden; sind mehrere Koordinaten im Artikelfließtext genannt, so sollten diese durch sinnvolles Benennen unterscheidbar sein.
Der Bezeichner ›<tt>coordinates</tt>‹ ist geschützt (CSS-id der Artikel-Koordinate).


Bei der Einbindung sehr vieler Koordinaten auf einer Seite kann es durch die Komplexität der Koordinatenvorlage zu langen Seitenladezeiten kommen. Für solche Fälle gibt es einen Parameter, der eine vereinfachte Variante aktiviert:
Der Name ist gleichzeitig auch Link-Text ([[Tooltip]]) und [[Anker (HTML)|HTML-Anker]]. Wird kein Name spezifiziert (CSS: id="text coordinates") wird der Link mit dem Artikel-Lemma <tt>&#123;&#123;FULLPAGENAME&#125;&#125;</tt> als Tooltip unterlegt.
<pre style="padding:.5em 1em; margin-top:0;">|simple = y</pre>


Dadurch wird die Vorlage schneller und kann öfter pro Seite verwendet werden, allerdings stehen verschiedene Funktionen nicht mehr zur Verfügung:
==== sortkey ====
* keine direkte Unterstützung von D/M/S-Koordinatenangaben, nur reine Gradzahlen mit Dezimalpunkt (siehe [[#Breiten- und Längengrad]]) werden akzeptiert
→ Hilfe: [[Hilfe:Tabellen#Sortierbare Tabelle|Sortierbare Tabellen]]
* keine Unterstützung für automatische Ausgabeformate (<code>text=/</code>)
* keine Rundung von DMS-Ausgabekoordinaten in Abhängigkeit vom dim und type
* es ist nur ''ein'' [[#Ausgabeformate|Ausgabeformat]] möglich
* kein veränderbarer Tooltip für die Textausgabe; es erscheint nur „Koordinate”
* die Angabe von Höhe oder Einwohnerzahl wird ignoriert (bei Bedarf evtl. nachrüstbar)
* nicht für Himmelskörper verwendbar (bei Bedarf evtl. nachrüstbar)
* keine Positionskarten und keine Artikelkoordinate


D/M/S-Koordinaten können mit <code><nowiki>{{subst:</nowiki>[[Vorlage:XDMS|XDMS]]<nowiki>}}</nowiki></code> in Dezimalbrüche umgerechnet werden. Für die bequeme Umstellung vieler Koordinateneinbindungen auf die simple-Variante steht {{Vorlage|CoordinateSimpleDMS}} zur Verfügung.
Der Sortierschlüssel legt fest, nach welchen Kriterien sortiert werden kann.
* NS, für sortieren nach Breitengrad
* EW, für sortieren nach Längengrad
Dabei ist '''N'''ord (positive Dezimalgrad) grösser als '''S'''üd (negative Dezimalgrad) und '''O'''st (positive Dezimalgrad) grösser als '''W'''est (negative Dezimalgrad).
Wird kein Schlüssel angegeben, so sind die Koordinaten in sortierbaren Tabellen nicht sortierbar. Der Parameter ist nur in Tabellen von Nutzen und sollte auch nur in solchen gebraucht werden. Nebeneffekt des Sortierschlüssels ist, dass bei Minuten und Sekunden führende Nullen eingefügt werden.


Wegen des eingeschränkten Funktionsumfangs sollte <code>simple=y</code> nur verwendet werden, wenn es tatsächlich Probleme mit der Artikelladezeit gibt. Die Ladezeiten sind abhängig von ''text'' und ''sortkey''. Die Erzeugung eines Ausgabeformats ist, abhängig von dessen Komplexität (DEC ist schneller als CH1903), relativ langsam. Schneller ist ein fester Text wie „Lage“ oder „Standort“; ersterer wird auch automatisch generiert wenn man den Parameter <code>text</code> weglässt.
==== {{Anker|map}}{{Anker|article und text}}{{Anker|article}}{{Anker|text}}map, article und text ====


Die Maximalzahl der mit <code>simple=y</code> einbindbaren Koordinaten liegt ja nach verwendeten Optionen (Ausgabeformat etc.) und Komplexität der Liste bei etwa 1000 bis 2000. Die Artikelladezeit beträgt ca. 2–3 Sekunden pro 100 Koordinaten.
Das Setzen oder Weglassen dieser Felder bestimmt die Darstellung als Positionskarte, Artikel- oder Fließtextkoordinate.


==== {{Anker|article|article und text|map, article und text}} Ausgabevarianten ====
{| class="wikitable"
Das Setzen oder Weg-/Leerlassen der Parameter <code>article</code>, <code>text</code> und <code>map</code> bestimmt die Ausgabe, wobei drei Darstellungen möglich sind:
* Als Artikelkoordinate wird die Anzeige des Links für den ganzen Artikel bezeichnet. [[Hilfe:Skin|Skinspezifisch]] ist er üblicherweise im rechten oberen Eck positioniert. Hinter dem Link wird der Button „Karte“ eingefügt, der das Ein- und Ausblenden einer [[OpenStreetMap|OSM-Karte]] ermöglicht (→ [[Hilfe:OpenStreetMap]]).
* Die (Fließ-)Textkoordinate bezeichnet die Ausgabe des Links an der Stelle, an der die Vorlage im (Quell-)Text eingebunden wurde. Der Linktext ist dabei frei wählbar.
* Die {{lang|en|''map''}}-Option zeigt die Koordinate auf einer für die Region passenden (anpassbaren) [[Vorlage:Positionskarte|Positionskarte]] an.
Ist ein Parameter gefüllt, wird das entsprechende Format aktiviert; alle Kombinationen sind möglich (wenn auch nicht unbedingt sinnvoll). Ist keiner der Parameter gesetzt, so wird eine Artikelkoordinate ausgegeben („Standardausgabe“).
<!--
{| class="wikitable float-right" style="text-align:center;"
|- class="hintergrundfarbe6"
|- class="hintergrundfarbe6"
!colspan="3"| Feld !! Ausgabe
! colspan="3" | Feld !! Ausgabe
|- class="hintergrundfarbe5"
|- class="hintergrundfarbe5"
! map !! article !! text !! Ort
!map!!article!!text!!Ort
|-
|-
| X || X || X || Positionskarte, Artikel- und Fließtextkoordinate
|style="text-align:center; vertical-align:middle;"| X || X || X || Positionskarte Artikel- und Fließtextkoordinate
|-
|-
|  || X || X || Artikelkoordinate Fließtextkoordinate
|style="text-align:center; vertical-align:middle;"|  || X || X || Artikelkoordinate Fließtextkoordinate
|-
|-
| X ||  || X || Positionskarte und Fließtextkoordinate
|style="text-align:center; vertical-align:middle;"| X ||  || X || Positionskarte und Fließtextkoordinate
|-
|-
| X || X ||  || Positionskarte und Artikelkoordinate
|style="text-align:center; vertical-align:middle;"| X || X ||  || Positionskarte und Artikelkoordinate
|-
|-
| X ||  ||  || Positionskarte
|style="text-align:center; vertical-align:middle;"| X ||  ||  || Positionskarte
|-
|-
|  || X ||  || Artikelkoordinate
|style="text-align:center; vertical-align:middle;"|  || X ||  || Artikelkoordinate
|-
|-
|  ||  || X || Fließtextkoordinate
|style="text-align:center; vertical-align:middle;"|  ||  || X || Fließtextkoordinate
|-
|-
|  ||  ||  || Artikelkoordinate
|style="text-align:center; vertical-align:middle;"|  ||  ||  || Artikelkoordinate
|}-->
|}


==== {{Anker|text|Fließtextkoordinate|Fliesstextkoordinate}} Textausgabe ====
===== Positionskarte =====
Der Parameter <code>text</code> bietet verschiedene Möglichkeiten an, die Fließtextausgabe zu gestalten:
Der Inhalt von ''map'' bestimmt die Lage der Positionskarte im Text. Der Parameter wurde zusätzlich eingeführt um unnötige Redundanz bei Positionskarten zu vermeiden.
* Die häufigste Variante sind eines oder mehrere [[#Ausgabeformate]] für die Koordinatenwerte selbst. Üblich ist das einfach als Koordinate erkennbare „DMS“, andere Formate sollten sich aus dem Kontext ergeben.
<pre>
* Mit den Werten „ICON0“, „ICON1“ oder „ICON2“ werden die Sonderzeichen bzw. Symbole ‚⊙‘, ‚▼‘  respektive ‚[[Datei:Erioll world.svg|15px|link=|Ort]]‘ mit Verlinkung zum Geohack ausgegeben. Sie assoziieren so eine Ortsangabe, ohne bei der Nutzung im Fließtext den Lesefluss zu unterbrechen.
|map=right
* Sämtliche Werte, die mit „Datei“ beginnen, verursachen eine Medieneinbindung mit Dateilink. Nur gemeinfreie Dateien angeben, siehe [[H:Bilder#Link]]! Im ANR dürfen nur die „offiziellen“ Icons verwendet werden!
</pre>
* Alle anderen Texte, die keinen der obigen Fälle <small>(Faustregel: Darf nicht mit <kbd>/</kbd>, <kbd>Icon</kbd> oder <kbd>Datei</kbd> beginnen)</small> abdecken, werden direkt als Linktext ausgegeben. Dies ermöglicht das Einfügen dezenter Textlinks in den Fließtext, zum Beispiel „Lage“.
{| class="wikitable"
|- class="hintergrundfarbe6"
! Wert
! Erklärung
|- class="hintergrundfarbe5"
| <nowiki><!--leer--></nowiki>
| keine Positionskarte
|-
| none<br/><small>(default für nicht leer)</small>
| Die Positionkarte wird an Ort und Stelle eingesetzt.
|-
| right
| Position am rechten Rand
|-
| left
| Position am linken Rand
|}


{{Anker|sortkey}} Wird die Textausgabe in [[Hilfe:Tabellen#Sortierbare Tabelle|sortierbaren Tabellen]] verwendet, so lassen sich Koordinatenangaben mit dem Parameter <code>sortkey</code> sortierbar machen. Mögliche Werte sind dabei:
Die Positionkarte wird auf Grund der ''[[#region|region]]''-Angabe gewählt (erster Code).
* „NS“ für sortieren nach Breitengrad
* „EW“ für sortieren nach Längengrad
Dabei ist '''N'''ord (positive Dezimalgrad) grösser als '''S'''üd (negative Dezimalgrad) und '''O'''st (positive Dezimalgrad) grösser als '''W'''est (negative Dezimalgrad). Der Parameter ist nur in Tabellen von Nutzen und sollte auch nur in solchen gebraucht werden. Nebeneffekt des Sortierschlüssels ist, dass bei Minuten und Sekunden führende Nullen eingefügt werden.


{{Anker|tooltip|tooltipformat}} Als [[Tooltip]] des Links wird standardmäßig der Bezeichner [[#name|<code>name</code>]] verwendet. Werden die Koordinaten nicht im Linktext ausgegeben (Icons, Freitext), wird der Tooltip zusätzlich um einen Doppelpunkt und die Koordinaten im DMS-Format ergänzt, um die Informationen für den Leser bestmöglich darzustellen. Um dies in Ausnahmefällen anpassen zu können, lässt sich mit dem Parameter <code>tooltipformat</code> das [[#Format|Koordinatenformat]] anpassen (ein Code) oder unterdrücken (leer). Mit dem Parameter <code>tooltip</code> lässt sich auch der Bezeichner, einschließlich des eventuell folgenden Doppelpunktes, individualisieren.
====== mapsize ======
[[Vorlage:Positionskarte]]
<pre>
|mapsize    = ###    (maximale) Kartenbreite
                x### maximale Höhe,
              ###x### maximales umgebendes Rechteck
            = <!--leer--> thumbsize-Benutzereinstellung
              default 240 Pixel
</pre>


==== {{Anker|Artikelkoordinate|Artikel- und Fließtextkoordinate|Format}} Ausgabeformate ====
====== maplevel ======
Der Inhalt der Felder ''article'' und ''text'' bestimmt das Ausgabeformat. Formatangaben bestehen dabei aus einem Formatcode oder zwei durch einen Schrägstrich <kbd>/</kbd> getrennten. Ein Trennstrich ohne Code davor, danach oder ganz alleine bewirkt eine automatische Ermittlung des in der angegebenen [[#region|Region]] bevorzugten Koordinatenformats mithilfe der [[Vorlage:CoordinateDefault]]. Dies geschieht auch in der Standardausgabe.
Der Kartenlevel dient der Positionskartenauswahl relativ zum toplevel des ''[[#region|region]]''-Codes (ISO 3166-1). Standardmäßig wird die Karte des Staates (genauer: des Gebildes mit eigenem Top-Level-Code in ISO-3166) eingebunden; diese Standard-Einbindung entspricht <tt>maplevel = national </tt>. Karten zu subnationalen Administrationsebenen auf Stufe 1 (Gouvernements, Kantone, Bundesländer, Provinzen usw.) und Stufe 2 (Départements usw.) Werden mit  → <tt>maplevel=adm1st</tt> bzw. <tt>maplevel=adm2nd</tt> gewählt. Voraussetzung dafür ist, dass der ''[[#region|region]]''-Code auf der untersten Ebene vergeben wurde. Ist die Karte zu der gewünschten Administrationstiefe nicht vorhanden, so wird die nächsthöhere vorhandene Positionskarte als Ersatz eingebunden. Mit (<tt>maplevel = continental </tt>) oder (<tt>maplevel = global </tt>) können Karten der Kontinente bzw. der Erde erzwungen werden.
<pre>
|maplevel  = [global, continental, national, adm1st, adm2nd]
</pre>
Der Wertebereich wurde so gewählt, dass sich die den subnationalen Administrationseinheiten entsprechenden Koordinatentypen (''[[#type|type]]'') und zugehörigen Kartenlevel entsprechen:
: country/state ↔ national, adm1st ↔ adm1st, adm2nd ↔ adm2nd.


Pro Ausgabe sind höchstens zwei Formate möglich, zu ähnliche (wie DM und DMS) schließen sich aus. Bei Verwendung der [[#simple|simple-Option]] ist nur ein Format möglich.
====== maptype ======
* Für die Artikelkoordinate wird immer das Format DMS genutzt, wählbar (ob durch den Parameter <code>article</code> oder automatisch) ist nur ein eventuelles zweites. Dieses Spezialformat wird durch einen Strichpunkt abgetrennt und mit Name benannt, damit es vom Leser erkannt wird.
[[Vorlage:Positionskarte]]
* Werden im Fließtext mehrere Formate ausgegeben, so wird das zweite ohne Name in Klammern angehängt.
<pre>
|maptype    = relief
</pre>
{| class="wikitable"
|- class="hintergrundfarbe6"
! Wert
! Erklärung
|- class="hintergrundfarbe5"
| <nowiki><!--leer--></nowiki>
| Die normale Karte wird angezeigt
|-
| relief
| Eine physische Karte wird angezeigt. Falls keine physische Karte verfügbar ist, wird die normale Karte angezeigt.
|}
 
===== {{Anker|Artikelkoordinate}}{{Anker|Fließtextkoordinate}}{{Anker|Fliesstextkoordinate}}Artikel- und Fließtextkoordinate =====
Der Inhalt der Felder ''article'' und ''text'' 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 <span style="background: white; white-space: nowrap;">1° 2′ 3″ N 4° 5′ 6″ E (UTM 123456 N 123456 E)</span>. 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 assoziiert so eine Ortsangabe.
 
{| class="wikitable"
|- class="hintergrundfarbe6"
! Alte Vorlage !! Neue Vorlage !! Ausgabe
|- valign="top"
| <code><nowiki>{{</nowiki>Koordinate&nbsp;Artikel…}}</code>
| <code><nowiki>{{</nowiki>Coordinate|…}}</code>
| Die Anzeige im Format DMS oben rechts ('''Standard''').
|- valign="top"
| <code><nowiki>{{</nowiki>Koordinate&nbsp;Text&nbsp;Artikel…}}</code>
| <code><nowiki>{{</nowiki>Coordinate|…|text=DMS|article=DMS|…}}</code>
| Anzeige der Koordinate im Text und oben rechts.
|- valign="top"
| <code><nowiki>{{</nowiki>Koordinate Text…}}</code>
| <code><nowiki>{{</nowiki>Coordinate|…|text=DMS|…}}</code>
| Anzeige der Koordinate nur im Text.
|}
 
====== {{Anker|Format}}Formate ======
Das gewünschte Format wird von einer Untervorlage der Form
<pre><nowiki>
{{Coordinate to XYZ  XYZ: das Zielformat (z. B. DMS)
|NS = 50.3            maximal 6 Nachkommastellen
|EW =-12.2            negativ ist Süd bzw. West
|dim= 100            Der Durchmesser des Umkreises steuert die Rundung.
}}
</nowiki></pre>
 
bereitgestellt.
 
Die unterstützten Formate beschränken sich auf die am häufigsten benutzten Systeme. Dazu gehören z.&nbsp;B. von Rettungsdiensten verwendete Koordinatensysteme.


{| class="wikitable"
{| class="wikitable"
|+ mögliche Formate
|- class="hintergrundfarbe6"
! Wert
! article
! text
! Erklärung
|- class="hintergrundfarbe5"
|- class="hintergrundfarbe5"
! Code
! colspan="4"| rechnerische Umwandlungen
! Erklärung
|-
! Beispiel
| /
| style="text-align:center"| X
| style="text-align:center"| <small>X</small>
| '''Verwende Standardausgabeformat.''' Benutzen, um zu definieren, ''dass'' und nicht ''wie'' eine Koordinate im Fließtext bzw. Artikelkopf angezeigt werden soll.<br /><small>Im Fließtext wegen [[:Kategorie:Seiten, die aufwändige Parserfunktionen zu oft aufrufen|teurer Parserfunktionen]] nicht erwünscht.</small>
|-
|-
| DMS
| DMS
| Standardformat „Degrees Minutes Seconds“
| style="text-align:center"| X
| {{Coordinate/to DMS|NS=46.8086|EW=9.9891|round=1|label=}}
| style="text-align:center"| X
| [[Bogenminute|Degrees Minutes Seconds]], [[World Geodetic System 1984|WGS84]] in Grad Minuten und Sekunden '''Standardausgabe'''
|-
|-
| DM
| DM
| nur Grad und Minuten
| style="text-align:center"|
| {{Coordinate/to DM|NS=46.8086|EW=9.9891|round=1|label=}}
| style="text-align:center"| X
| WGS84 in Grad und Minuten
|-
|-
| DEC
| DEC
| Dezimalgrad
|
| {{Coordinate/to DEC|NS=46.8086|EW=9.9891|round=1|label=}}
| style="text-align:center"| X
| WGS84 in Dezimalgrad
|-
| [[UTM-Koordinatensystem|UTM]]<br /><small>nicht implementiert</small>
| style="text-align:center"| X
| style="text-align:center"| X
| Universial Transversal Mercator
|-
|-
| CH1903
| CH1903
| style="text-align:center"| X
| style="text-align:center"| X
| [[Schweizer Landeskoordinaten]]
| [[Schweizer Landeskoordinaten]]
| {{Coordinate/to CH1903|NS=46.8086|EW=9.9891|round=1|label=}}
|-
|-
| UTM
| [[OSGB36]]<br /><small>nicht implementiert</small>
| [[Universal Transverse Mercator]]
| style="text-align:center"| X
| {{Coordinate/to UTM|NS=46.8086|EW=9.9891|round=1|label=}}
| style="text-align:center"| X
| Ordnance Survey Great Britain 1936
|- class="hintergrundfarbe5"
! colspan="4"| textuelle Ersetzungen
|-
| ICON0, ICON1
|
| style="text-align:center"| X
| Anzeige eines assoziativen Sonderzeichens (‚⊙‘, ‚▼‘) mit Verlinkung zum Geohack, um bei der Nutzung in Fließtext (Beispiel: [[Chao Phraya]]) den Lesefluss nicht zu unterbrechen.
|-
| individueller Text
|
| style="text-align:center"| X
| z.&nbsp;B. für Bereichsangaben wie in [[Geographie Tunesiens]]
|}
|}
<!-- *[[Gauß-Krüger-Koordinatensystem]] -->
<!-- *[[Gauß-Krüger-Koordinatensystem]] -->


Beispiel „Verwende Standardausgabeformat“: nur definieren, ''dass'' und nicht ''wie'' eine Koordinate im Fließtext bzw. Artikelkopf angezeigt werden soll.
'''Rechnerische Umwandlungen und deren Kombinationen'''
<pre style="padding:.5em 1em; margin:0;">|text=/
|text=Lage|article=/</pre>
Beispiel: UTM-Format, dahinter in Klammern dezimal in Grad:
<pre style="padding:.5em 1em; margin:0;">|text=UTM/DEC</pre>
Beispiel: Zeige DMS-Format und dahinter, wenn ein lokal bevorzugtes Format vorhanden ist, dieses in Klammern:
<pre style="padding:.5em 1em; margin:0;">|text=DMS/</pre>
Beispiel: Zeige im Artikelkopf nach dem üblichen DMS noch die Schweizer Landeskoordinaten an (verschiedene Möglichkeiten):
<pre style="padding:.5em 1em; margin:0;">|article=DMS/CH1903
|article=CH1903
|article=CH1903/DMS
|article=/CH1903</pre>


{{Anker|Rundung}} Eine automatische Rundung erfolgt bei der Standardausgabe DMS sowie bei DEC, wobei der [[#dim|Parameter <code>dim</code>]], also die Größe des Objekts, in die Rundung einfließt. Ist er nicht angegeben, wird die Rundung aus dem [[#type|Parameter <code>type</code>]] ermittelt. Alle Spezialformate werden nicht gerundet.
Es können maximal zwei Formate angegeben werden. DM und DMS schließen sich gegenseitig aus. In diesem Fall wird nur das erstgenannte Format angewandt. Ist die erste Formatangabe leer (›<tt>/</tt>‹ oder ›<tt>/XYZ</tt>‹) 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 <tt>&#123;&#123;[[Vorlage:CoordinateRR DEFAULT|CoordinateRR DEFAULT]]&#125;&#125;</tt> 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).
 
====== Rundung ======
Eine automatische Rundung erfolgt bei der Standardausgabe Grad Minute Sekunde (DMS), wobei der Parameter <tt>dim</tt>, also die Größe des Objektes in die Rundung einfließt. Alle Spezialformate werden nicht gerundet. Die Dezimalausgabe wird ebenfalls nicht gerundet.
 
DMS<ref name="landmark">''type'' ›landmark‹ wird nur bis zu einer maximalen ''dim'' von 1000m auf Zehntel- und Hunderstel-Sekunden gerundet</ref> wird wie folgt gerundet:


{| class="wikitable"
{| class="wikitable"
|+ Rundungswerte
|- class="hintergrundfarbe6"
|- class="hintergrundfarbe5"
! Ausgabe
! dim-Wert (in m)
! dim-Wert [m]
! type
! DMS-Ausgabe
! DMS-Genauigkeit<ref>Am [[Äquator]] zwischen [[Meridian (Geographie)|Meridian]]en, also höchstmöglicher Abstand</ref>
! DEC-Stellen
! DEC-Genauigkeit
|-
|-
|style="text-align:center;"| 500000 < dim
|
| „country“, „state“, „adm1st“
|D bei Dimensionen dim > 500000 auf Grad<ref>default für ''type'' = ›country‹, ›state‹, ›adm1st‹</ref>
| Grad (5°)
| ≈ 111&nbsp;km
| 0
| ≈ 111&nbsp;km
|-
|-
|style="text-align:center;"| 10000 < dim 500000
| 5° 10′
| „adm2nd“, „city“, „mountain“, „isle“
| DM 10000 < dim <= 500000 auf Minuten<ref>default für ''type'' = ›adm2nd‹, ›city‹, ›mountain‹, ›isle‹</ref>
| Minuten (5° 10′)
| ≈ 1,85&nbsp;km (≈ 1&nbsp;[[Seemeile|sm]])
| 2
| ≈ 1&nbsp;km
|-
|-
|style="text-align:center;"| 250 < dim 10000
| 5° 10′ 25″
| „landmark“
| DMS 250 < dim <= 10000 auf Sekunden '''default'''
| Sekunden (5° 10′ 25″)
| ≈ 30&nbsp;m
| 4
| ≈ 11&nbsp;m
|-
|-
|style="text-align:center;"| 25 < dim ⩽ 250
| 5° 10′ 25,1″
|
| DMSd 25 < dim <= 250 auf Zehntelsekunden<ref name="landmark"/>
| Zehntelsekunden (5° 10′ 25,1″)
| ≈ 3&nbsp;m
| 5
| ≈ 1&nbsp;m
|-
|-
|style="text-align:center;"| dim ⩽ 25
| 5° 10′ 25,12″
|
| DMSdc dim <= 25 auf Hundertstelsekunden<ref name="landmark"/>
| Hundertstelsekunden (5° 10′ 25,12″)
| ≈ 30&nbsp;cm
| 6
| ≈ 11&nbsp;cm
|}
|}
<references />


==== {{Anker|map}} Positionskarte ====
An [[Äquator]] und [[Meridian (Geographie)|Meridian]]en entspricht 1° ≈ 111&nbsp;km, 1′ ≈ 1,85&nbsp;km (≈ 1&nbsp;[[Seemeile|sm]]), 1″ ≈ 30&nbsp;m, 0,01″ ≈ 30&nbsp;cm<br />
Mit dem Parameter <code>map</code> lässt sich eine vollwertige [[Vorlage:Positionskarte|Positionskarte]] einbauen. Neben der Redundanzvermeidung gegenüber einer zusätzlichen Vorlageneinbindung mit Wertevalidierung hat diese Option den Vorteil, automatisch über den [[#region|Regions-Code]] (bzw. dessen ersten Teil) eine passende Karte auszusuchen und eine wiederum zu dieser passende Bildunterschrift zu finden.
Bei Eingabe von Dezimalwerten für die Koordinaten entspricht 10<sup>-6</sup>° einer Entfernung von 11&nbsp;cm.
 
====== SORT ======
Dem Fließtext wird für die Verwendung in Tabellen ein unsichtbarer Sortierschlüssel vorangestellt. Der Schlüssel ist eine eindeutige Kodierung aus Breiten- und Längengrad.
 
== Lagewunsch ==
Ist die Lage eines georeferenzierbaren Objekts nicht bekannt, so kann die [[Vorlage:Lagewunsch]] eingesetzt werden. Substitution dieser Vorlage setzt einen „leeren“ Aufruf der Vorlage:Coordinate ein und bereits bekannte Parameter können fortlaufend ergänzt werden. Über die Wartungskategorie [[:Kategorie:Geographische Lage gewünscht]] und deren Unterkategorien sind diese Artikel auffindbar.
 
'''Achtung:''' Sorgt in einem Artikel bereits die Infobox für die Generierung eines Lagewunsches, so ist das nochmalige Setzen dieser Vorlage nicht notwendig. Dies ist fast bei allen Infoboxen der Fall, bei denen man eine Georeferenzierung eintragen kann. (→ [[:Kategorie:Vorlage mit Koordinate]])
 
== Fehlerbehandlung ==
 
Folgende Fälle werden geprüft und mit Fehlermeldung sowie Wartungslink versehen:
# Prüfung auf numerischen Wert von Breiten- ''(NS)'' und Längengrad ''(EW)'' in [[Vorlage:CoordinateMAIN|CoordinateMAIN]]
# Prüfung auf Wertebereich von Breiten- ''(NS)'' und Längengrad ''(EW)'' im Format ›CH1903‹ in [[Vorlage:Coordinate to CH1903|Coordinate to CH1903]]
# Prüfung des ''type''-Parameters in [[Vorlage:Coordinate|Coordinate]]/[[Vorlage:CoordinateMAIN|CoordinateMAIN]]
# <!--Prüfung des ''type''-Parameters in [[Vorlage:CoordinateMAIN|CoordinateMAIN]] ''(globe)''-->-
# Prüfung auf unbenannte Parameter
# Prüfung auf fehlenden Parameter ''region'' (in Infoboxen auch REGION-ISO, …)
# ''elevation'' Parameter fehlt (in Infoboxen auch HÖHE, Höhe, …) → Wartungslink
# ''name'' Parameter fehlt in Fließtextkoordinate ([[Vorlage:CoordinateMAIN|CoordinateMAIN]])
# ''pop'' Formatierungsfehler (keine natürliche Zahl)
* default Fehlermeldung (# unbekannte Fehlernummer)
 
Aus keiner Angabe von Breitengrad ''NS'' und Längengrad ''EW'' resultiert ein [[Vorlage:Coordinate#Lagewunsch|Lagewunsch]].
 
== Tutorial Infoboxen ==
In vielen Fällen erfolgt die Versorgung der Parameter für die Koordinaten direkt aus der Infobox und eine Übergabe als Parameter ist nicht notwendig, ein Beispiel dafür ist etwa die Typangabe <code>type=city</code>, die bei Ortsinfoboxen hart kodiert wird.
 
=== Namensempfehlung für Parameter ===
Folgende Schlüsselwörter werden bei der automatischen Vorlagenauswertung, der Elemente aus ''Kategorie:Vorlage mit Koordinate'', erkannt:
; NS : Breitengrad, BREITENGRAD, LATITUDE
; EW : Längengrad, LÄNGENGRAD, LONGITUDE
; type : COORDINATE_TYPE, KOORDINATE_TYP
; pop : Einwohner, EINWOHNER
; elevation : Gebrauchshöhe, ELEVATION, ALTITUDE
; region : Region-ISO, REGION-ISO, REGION-CODE
Bitte, um Fehlzuweisungen zu vermeiden, diese Parameternamen nur im Kontext mit Koordinaten verwenden! (Die internen Parameter der [[Vorlage:Coordinate]] wie '''NS''' und '''EW''' werden nicht erkannt.)
 
=={{Anker|Interface}}Externe Schnittstellen==
 
===GeoHack===
 
→[[Vorlage:GeoTemplate]]
 
====API-Auswertung====
 
* [http://toolserver.org/~dispenser/view/File_viewer#log:coord-dewiki.log toolserver.org (coord-dewiki.log)] / [http://toolserver.org/~dispenser/resources/logs/coord-dewiki.log toolserver.org (coord-dewiki.log)]
* [http://toolserver.org/~dispenser/cgi-bin/locateCoord.py toolserver.org (locateCoord.py)]
 
== Organisation der Unterseiten und Untervorlagen (sub-templates) ==
 
{{Special:Prefixindex/Vorlage:Coordinate}}
 
=== Unterseiten ===
'''Dokumentation''' {{Special:Prefixindex/Vorlage:Coordinate/Doku}}
 
'''Metadaten''' {{Special:Prefixindex/Vorlage:Coordinate/Meta}}
 
'''Test''' {{Special:Prefixindex/Vorlage:Coordinate/Test}}
 
=== Struktur (sub-templates) ===
Nachfolgend wird die ''„Programmstruktur“'' der [[Implementierung|Implementation]] aufgezeigt:
 
==== Hilfs''funktionen'' ====
 
'''Eingabehilfe'''
[[Vorlage:CH1903-WGS84|CH1903-WGS84]]
substituierbare Hilfsvorlagen zur Eingabe in Schweizer Landeskoordinaten
 
'''''Unter-''Vorlagen'''
: '''Allgemeine''' Vorlagen für Vorlagen
: [[Vorlage:ParmPart|ParmPart]]: separiert die durch ›/‹ getrennten Parameterteile
: [[Vorlage:Info ISO-3166-2]]: zur Navigation durch die Administrationslevel
 
: '''Spezielle''' Koordinaten-Vorlagen für die Verwendung in Infobox-Vorlagen (indirekte Einbindung der Koordinatenvorlage)
: [[Vorlage:CoordinateLAT]] Breitengrad (dezimal)
: [[Vorlage:CoordinateLONG]] Längengrad (dezimal)
: [[Vorlage:CoordinateSYSTEM]] Default-Koordinatensysteme
 
: '''Interne''' Vorlagen (nur Vorlage:Coordinate bestimmt)
: [[Vorlage:CoordinateMSG]] zur Fehlerbehandlung (Text und zugehöriger Wartungslink)
: [[Vorlage:CoordinateRR DEFAULT]] bestimmen der Default-Koordinatensysteme (intern)


{{Anker|mapsize}} Der Inhalt von <code>map</code> bestimmt die Anordnung der Positionskarte im Artikel. Er entspricht damit dem Parameter <code>float</code> der [[Vorlage:Positionskarte]]; für eine Bedeutung der der einzelnen Werte siehe deren Dokumentation. Default-Wert ist dabei eine normale Miniatur-Einbindung in Benutzereinstellungsgröße. Die Größe lässt sich mit dem Parameter <code>mapsize</code> (in px) anpassen; für die Doku gilt Entsprechendes.
==== Haupt''funktion'' ====
'''Coordinate''' und ihre Einbindungen
* Prüfung auf Pflichtfelder
*: Lagewunsch: [[Vorlage:CoordinateNO]]
* Vorbedingungen erfüllen (Error-Messages 3, 5, 7 und 9)
** Aufbereitung von Breiten- und Längengrad in Dezimalgrad
*** [[Vorlage:CoordinateLAT|CoordinateLAT]] und [[Vorlage:CoordinateLONG|CoordinateLONG]]
** ''article'' (''text'' NOR ''article'')
** geschützter Wert ›coordinates‹ von Parameter ''name'' abfangen. (CSS id Seiteneffekt)
** ''sortkey'' nur weitergeben wenn ''text'' nicht leer
* [[Vorlage:CoordinateMAIN|CoordinateMAIN]]
** Prüfung von Breiten- und Längengrad auf Zahl
** GEO-[[Mikroformate|Mikroformat]]
** Textbausteine für Artikel und Fließtext
*** '''[[Vorlage:CoordinateRR DEFAULT|CoordinateRR DEFAULT]]''' Default Format aus Parameter ''region''
*** '''[[Vorlage:CoordinateSORT|CoordinateSORT]]''' Vorangesteller Sortierschlüssel (text)
* [[Vorlage:CoordinateLINK|CoordinateLINK]]
** URL zu „Geohack“ und Parameter
** Link-Text aus:
*** Ausgabeformate<br /><small>nicht implementiert: UTM und OSGB36<br />für CH1903 wird [[Vorlage:WGS84-CH1903]] eingebunden</small>


Beispiel für eine Miniatur-Einbindung am rechten Rand:
==== Ausgabeformat-''Erweiterungen'' ====
<pre style="padding:.5em 1em; margin:0;">|map=right</pre>
Die gewünschten Formate werden von einer Untervorlage der Form
Beispiel für eine zentrierte Einbindung mit Festbreite:
<pre><nowiki>
<pre style="padding:.5em 1em; margin:0;">|map=center
{{Coordinate to XYZ  XYZ: das Zielformat (z. B. DMS)
|mapsize=300</pre>
|NS = 50.3            maximal 6 Nachkommastellen
|EW =-12.2            negativ ist Süd bzw. West
|dim= 100            Der Durchmesser des Umkreises steuert die Rundung.
|label=               Name (Label) des Koordinatensystem ausgeben?               
<!--
|elevation            komplexere Transformationen benötigen die dritte Dimension.
|region              z. B. für Helmert-Parameter
-->
}}
</nowiki></pre>


{{Anker|maptype|maplayer}} Ebenso lassen sich mit den Parametern <code>maptype</code> und <code>maplayer</code> wie bei der [[Vorlage:Positionskarte]] andere (etwa topographische) Karten wählen oder zusätzliche in den Datenvorlagen definierte Ebenen einblenden. Die möglichen Werte hängen von der gewählten Karte ab und sind dort dokumentiert.
bereitgestellt.


{{Anker|maplabel}} Aus dem Bezeichner [[#name|<code>name</code>]] oder evtl. dem Seitentitel wird automatisch eine Beschriftung für die Positionsmarkierung auf der Karte erzeugt. Mit dem Parameter <code>maplabel</code> lässt sie sich anpassen, durch <code>maplabel=none</code> auch ausblenden.
Dank konditionaler Vorlageneinbindung wird nur die jeweils notwendige Formatierung in der Vorlage eingesetzt. Die einbindende Vorlage [[Vorlage:CoordinateLINK|CoordinateLINK]] bleibt wartbar und es können relativ einfach neue Formate hinzugefügt werden. Eventuell sind für zukünftige Formatierungen noch weitere Parameter erforderlich<ref>[http://www.geodatenzentrum.de/geodaten/gdz_rahmen.gdz_div?gdz_spr=deu&gdz_akt_zeile=6&gdz_anz_zeile=3&gdz_user_id=0 Georeferenzierungen Deutschland]</ref><ref>[http://www.ordnancesurvey.co.uk/oswebsite/gps/osnetfreeservices/furtherinfo/questdeveloper.html Ordnance Survey Grait Britain] Ausführliche Dokumentation zum Herunterladen (englisch)</ref> ([[Helmert-Transformation]]).


;{{Anker|maplevel}} Kartenlevel
: {{Special:Prefixindex/Vorlage:Coordinate to}}


Mit dem Parameter <code>maplevel</code> lässt sich die Positionskartenauswahl beeinflussen. Mit dieser Kartenebene wird angegeben, von welcher der ISO-3166-Einheiten die Karte verwendet werden soll. Standardmäßig wird die Karte des Staates (genauer: des Gebildes mit eigenem Top-Level-Code in ISO-3166) eingebunden; diese Standard-Einbindung entspricht <code>maplevel=national </code>. Karten zu subnationalen Administrationsebenen auf Stufe 1 (Gouvernements, Kantone, Bundesländer, Provinzen usw.) und Stufe 2 (Départements usw.) Werden mit <code>maplevel=adm1st</code> bzw. <code>maplevel=adm2nd</code> gewählt. Voraussetzung dafür ist, dass der ''[[#region|region]]''-Code der untersten Ebene angegeben wurde. Ist die Karte zu der gewünschten Administrationstiefe nicht vorhanden, so wird die nächsthöhere vorhandene Positionskarte als Ersatz eingebunden. Mit <code>maplevel=continental</code> oder <code>maplevel=global</code> können auch Karten der Kontinente bzw. der Erde erzwungen werden.
== Siehe auch ==
* [[:Commons:Geocoding]] und die Vorlage [[:Commons:Template:Location|Vorlage Location]]


== Weiteres ==
== Einzelnachweise ==
* Die Dokumentation der Implementierungsdetails findet sich bei der [[Vorlage:CoordinateComplex]].
<references />
* Die Vorlage implementiert das geo-Microformat, siehe [[Vorlage:CoordinateComplex#Mikroformat]].
* Die Vorlage kann, ohne oder mit leeren Parametern, als [[Wikipedia:Lagewunsch|Lagewunsch]] eingesetzt werden.
* Mit der Integration der Koordinateneinbindung in andere Vorlagen beschäftigt sich die Seite [[Vorlage:Coordinate/Vorlagenprogrammierung]].
* Eine Übersicht über auftretende Fehler gibt die [[Vorlage:Coordinate/Wartung|Wartungsseite]].
* Die Oberfläche des verlinkten Toolserver-Tools „Geohack“ kann über die [[Vorlage:GeoTemplate]] angepasst werden.

Aktuelle Version vom 9. Mai 2025, 21:58 Uhr

Fehler beim Erstellen des Vorschaubildes: Datei fehlt Diese Seite ist die Dokumentations-Unterseite der Vorlage:Coordinate.
geo-microformat
geo-microformat
Fehler beim Erstellen des Vorschaubildes: Datei fehlt
Globus

Diese Vorlage ist für die Einbindung von WGS84-Koordinaten in Artikeln bestimmt. Dadurch können Orte automatisch auf einer Landkarte angezeigt werden.

Inhaltsverzeichnis

Beispiel: Der Code zur Einbindung der Koordinaten von der Porta Nigra in Trier lautet:

{{Coordinate|NS=49.759681|EW=6.6440194|type=landmark|dim=25|region=DE-RP}}
oder
{{Coordinate|NS=49/45/34.85/N|EW=6/38/38.47/E|type=landmark|dim=25|region=DE-RP}}

Kopiervorlage

{{Coordinate |map= |article= |text= 
|NS= |EW= |type= |pop= |elevation= |region= |dim= |name=
|mapsize= |sortkey= 
}}

Grundkonstrukt Artikelkoordinate

{{Coordinate|NS=|EW=|type=|region=}}
NS=          Breitengrad in der Form Grad/Minute/Sekunde/Himmelsrichtung
             Bsp. NS=49/45/34.85/N  oder
             Breitengrad als Dezimalangabe  (kein Vorzeichen für nördliche Breite, negatives Vorzeichen für südliche Breite)
             Bsp. NS=49.759681
EW=          Längengrad in der Form Grad/Minute/Sekunde/Himmelsrichtung
             Bsp. EW=6/38/38.47/E  oder
             Längengrad als Dezimalangabe
             Bsp. EW=6.6440194  (kein Vorzeichen für östliche Länge, negatives Vorzeichen für westliche Länge)
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 Flüsse, Seen, Gletscher, Kanäle, Wasserfälle, Geysire
             landmark   für Sehenswürdigkeiten, Landmarken, Gebäude und alles andere was nicht oben rein passt
region=      Länder-/Regionencode nach ISO 3166-1 und ISO 3166-2 muss angegeben werden
             Bsp. für Niedersachsen DE-NI, für Berlin DE-BE, für Wien AT-9

Zusätzliche Angaben

text=        Koordinate im Fließtext   (multiple choice) Format der Ausgabe, verlangt zusätzlich name des Objekts
article=     Koordinate im Artikelkopf (multiple choice) Format der Ausgabe
             / für default
map=         Koordinate auf Positionskarte
             none für keine Ausrichtung der Karte
             left     Ausrichtung links im Fließtext
             right    Ausrichtung rechts im Fließtext
mapsize=     ###      (maximale) Kartenbreite 
                x###  maximale  Höhe,
             ###x###  maximales umgebendes Rechteck
             leer     (ohne Parameterwert) thumbsize-Benutzereinstellung
                      default (ohne Parameter) 240 Pixel
maplevel=    [global, continental, national, adm1st, adm2nd]
maptype=     [relief]
pop=         Einwohnerzahl
             zu type country, state, adm1st, adm2nd, city oder isle
elevation=   Höhe über dem Meeresspiegel (amtliche Höhe der Region region)
dim=         Objektdurchmesser in Meter
name=        Name des Objekts (falls abweichend vom Artikellemma)
             zwingend bei Fließtextkoordinaten 
globe=       Himmelskörper: moon, mercury, venus, earth (default), mars 
sortkey=     Sortierung nach NS oder EW in sortierbaren Tabellen

Einfache Hilfsmittel zur Koordinatenermittlung gibt es für Google Earth hier und mit Google Maps hier.

Mikroformat

Die Vorlage unterstützt das GEO-Mikroformat.[1] Die semantische Textauszeichnung geschieht mit den CSS-Klassen ›geo‹, ›latitude‹, ›longitude‹ und ›elevation‹. Diese Klassen sind für diesen Zweck reserviert und dürfen nicht anderweitig verwendet werden.

Die Klasse ›elevation‹ wurde erst kürzlich zur Standardisierung vorgeschlagen[2] und ist noch kein Standard.

Parameter

Übersicht

Parameter Beispiel Typ Erklärung Detail
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.
globe region=moon optional Himmelskörper, auf dem sich das referenzierte Objekt befindet.
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).
article article=DMS optional Koordinate im spezifizierten Format (default DMS) oben rechts im Artikel.
text text=DMS optional Koordinate im spezifizierten Format im Fließtext.
map map=right optional Positionskarte
mapsize mapsize= x180 optional Größe der Karte
maplevel maplevel = adm1st optional Abweichende Karte auf der ISO Skala rauf und runter: Wertebereich [global, continental, national, adm1st, adm2nd]
maptype maptype = relief optional Anzeige einer physischen Karte anstelle der normalen, politischen Karte

Parameter im Detail

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:Geographische Lage gewünscht eingetragen.

|NS= 45.123456
|EW=-12.123456

|NS= 55/44/33.22/N
|EW= 11/22/33.44/W

In der DMS-Darstellung müssen Grad, Minuten und Sekunden einen positiven Wert haben. Das negative Vorzeichen muss zwingend über die Angabe von ›S‹ oder ›W‹ erfolgen. Ein negatives Vorzeichen ist nur in reiner Dezimal-Schreibweise möglich.

In Infoboxen, die auch Vorlagen 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.

Schweizer Landeskoordinaten

Längen- und Breitengrad können mit einer Substitution direkt aus den Schweizer Landeskoordinaten ermittelt werden.

Beispiel: Bern (600'000/200'000)

|NS= {{subst:CH1903-WGS84|600|200||koor=B}}
|EW= {{subst:CH1903-WGS84|600|200||koor=L}}
|region=CH-BE

type

Die Angabe type=XX ermöglicht die Festlegung der Art einer Koordinate. Dadurch lassen sich z. B. in GIS-Programmen thematische Darstellungen erzeugen, wenn aus der riesigen Masse an Koordinatenangaben z. B. nur alle Inseln oder Berge herausgefiltert werden sollen. Diese Angabe ist zwar nicht notwendig, aber erwünscht. Der Parameter type ist verwandt mit dem Konzept der Kategorien. Als Symbole werden kleine Bilder verwendet.

Text in der Vorlage Type
type=country für Länder
type=state für andere Staatengebilde, nicht-souveräne Staaten …
type=adm1st für Bundesländer, Kantone …
type=adm2nd für Landkreise, Verwaltungsgemeinden (Samtgemeinden) …
type=city für Städte und Stadtteile, Orte und Orts-Gemeinden, meist Datei:Reddot.png
type=isle für Inseln, Inselgruppen
type=airport für Flughäfen, Luftwaffenstützpunkte …
type=mountain für Berge, Hügel, Gebirgsketten, Pässe - siehe Datei:BlackMountain.png
type=waterbody für Flüsse, Seen, Gletscher, Kanäle, Wasserfälle, Geysire …
type=forest für Waldgebiete (en:WP, in der deutschsprachigen WP nicht verwendet) …
type=landmark für Sehenswürdigkeiten, Landmarken, Gebäude und alles andere was nicht oben rein passt.
type=event für Ereignisse (en:WP, in der deutschsprachigen WP nicht verwendet) …
type=example nur für interne Beispielzwecke (nicht im Artikelnamensraum)

pop und elevation

pop steht für Population (Bevölkerung). Der Parameter wird bei Objekten des Typs city, adm1st, adm2nd, state, country und isle an die GeoHack-Schnittstelle weitergegeben. Er ersetzt die frühere Angabe „city(5000)“ durch ein separates

|pop=5000

elevation steht für Höhe über dem Meeresspiegel. Relevant ist die amtliche Höhe von region (erster Parameter) in Metern. Dieser neue Parameter ersetzt die frühere Angabe „mountain(1234)“ durch ein separates

|elevation=1234

dim

Dimensions- bzw. Größen-Angabe, optional.

Es handelt sich um den ungefähren Objektdurchmesser bzw. die Diagonale in Metern. Diese Angabe beeinflusst die initiale Vergrößerung einer Kartenansicht und ersetzt die Scale-Angabe, welche nie präzise definiert war.

Beispiel eines Gebäudes mit 50 m diagonaler Ausdehnung:

|dim=50

region

Die Angabe region=XX oder region=XX-YY ermöglicht es, das georeferenzierte Objekt einem Staat und einer Region zuzuordnen. 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 Kodierung ist durch den ISO-Standard ISO 3166 festgehalten. Das ›XX‹ steht für die zwei Buchstaben des ISO 3166-1-Codes für Staaten, das ›YY‹ steht für den ISO-3166-2-Code für subnationale Einheiten wie Bundesländer oder Kantone. Ist der Ländercode bekannt, kann man den Regionalcode für jedes Land in der Kategorie:ISO 3166-2 nachschlagen.

Bisher sind diese hier nur für einige Staaten vollständig:

Einzelne Bundesländer können wie folgt - am Beispiel für Bayern - angesprochen werden:

|region     = DE-BY

Einige geographische Punkte lassen sich mehreren Staaten/Regionen zuordnen, weil sie genau auf der Grenze liegen; weitere Regionen können mit ›/‹ separiert angehängt werden. In den USA gibt es Four Corners = Vier-Staaten-Prinzip; Beispiel:

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

globe

Die Angabe globe=XX erlaubt Koordinaten auf anderen Himmelskörpern als der Erde wie Planeten oder Monde anzugeben. Der Himmelkörper wird mit dem englischen Begriff in Kleinschreibung angegeben. Eine vollständige Liste der verfügbaren Himmelskörper befindet sich unter Kategorie:Vorlage:Info globe.

Wenn globe nicht angegeben wird oder mit dem Wert globe=earth belegt wird, bezieht sich die Angabe auf die Erde. Auf anderen Himmelskörpern darf region=XX nicht belegt werden, da die Codes nach ISO 3166 ausschließlich regionen auf der Erde bezeichnen.

Objekt auf dem Mond

|globe     = moon
Ozeane

Für außerhalb staatlicher Hoheitsgebiete liegende Gebiete wurde bisher nur der Antarktis ein Code (AQ) zugeteilt. Codes für die Ozeane fehlen. Bis dies im ISO 3166 nachgeholt wird, hat sich die WP aus dem Bereich für private Nutzung (AA, QM–QZ, XA–XZ und ZZ) die Codes XA, XI, XN, XO, XP und XS angeeignet. Die Einteilung basiert auf der allgemein anerkannten Einteilung der Ozeane:

Zusätzlich wurde XO für geostationäre Objekte im Orbit vergeben.

Diese Codes ergänzen die ISO-3166-1-Kodierliste.

name

Der Name des Georeferenzierten Objekt kann, falls dieser nicht dem Lemma des Artikels entspricht, hier entsprechend spezifiziert werden. Im Fließtext muss der Parameter gesetzt werden; sind mehrere Koordinaten im Artikelfließtext genannt, so sollten diese durch sinnvolles Benennen unterscheidbar sein. Der Bezeichner ›coordinates‹ ist geschützt (CSS-id der Artikel-Koordinate).

Der Name ist gleichzeitig auch Link-Text (Tooltip) und HTML-Anker. Wird kein Name spezifiziert (CSS: id="text coordinates") wird der Link mit dem Artikel-Lemma {{FULLPAGENAME}} als Tooltip unterlegt.

sortkey

→ Hilfe: Sortierbare Tabellen

Der Sortierschlüssel legt fest, nach welchen Kriterien sortiert werden kann.

  • NS, für sortieren nach Breitengrad
  • EW, für sortieren nach Längengrad

Dabei ist Nord (positive Dezimalgrad) grösser als Süd (negative Dezimalgrad) und Ost (positive Dezimalgrad) grösser als West (negative Dezimalgrad). Wird kein Schlüssel angegeben, so sind die Koordinaten in sortierbaren Tabellen nicht sortierbar. Der Parameter ist nur in Tabellen von Nutzen und sollte auch nur in solchen gebraucht werden. Nebeneffekt des Sortierschlüssels ist, dass bei Minuten und Sekunden führende Nullen eingefügt werden.

map, article und text

Das Setzen oder Weglassen dieser Felder bestimmt die Darstellung als Positionskarte, Artikel- oder Fließtextkoordinate.

Feld Ausgabe
map article text Ort
X X X Positionskarte Artikel- und Fließtextkoordinate
X X Artikelkoordinate Fließtextkoordinate
X X Positionskarte und Fließtextkoordinate
X X Positionskarte und Artikelkoordinate
X Positionskarte
X Artikelkoordinate
X Fließtextkoordinate
Artikelkoordinate
Positionskarte

Der Inhalt von map bestimmt die Lage der Positionskarte im Text. Der Parameter wurde zusätzlich eingeführt um unnötige Redundanz bei Positionskarten zu vermeiden.

|map=right
Wert Erklärung
<!--leer--> keine Positionskarte
none
(default für nicht leer)
Die Positionkarte wird an Ort und Stelle eingesetzt.
right Position am rechten Rand
left Position am linken Rand

Die Positionkarte wird auf Grund der region-Angabe gewählt (erster Code).

mapsize

Vorlage:Positionskarte

|mapsize    = ###    (maximale) Kartenbreite
                 x### maximale Höhe,
              ###x### maximales umgebendes Rechteck
            = <!--leer--> thumbsize-Benutzereinstellung
              default 240 Pixel
maplevel

Der Kartenlevel dient der Positionskartenauswahl relativ zum toplevel des region-Codes (ISO 3166-1). Standardmäßig wird die Karte des Staates (genauer: des Gebildes mit eigenem Top-Level-Code in ISO-3166) eingebunden; diese Standard-Einbindung entspricht maplevel = national . Karten zu subnationalen Administrationsebenen auf Stufe 1 (Gouvernements, Kantone, Bundesländer, Provinzen usw.) und Stufe 2 (Départements usw.) Werden mit → maplevel=adm1st bzw. maplevel=adm2nd gewählt. Voraussetzung dafür ist, dass der region-Code auf der untersten Ebene vergeben wurde. Ist die Karte zu der gewünschten Administrationstiefe nicht vorhanden, so wird die nächsthöhere vorhandene Positionskarte als Ersatz eingebunden. Mit (maplevel = continental ) oder (maplevel = global ) können Karten der Kontinente bzw. der Erde erzwungen werden.

|maplevel   = [global, continental, national, adm1st, adm2nd]

Der Wertebereich wurde so gewählt, dass sich die den subnationalen Administrationseinheiten entsprechenden Koordinatentypen (type) und zugehörigen Kartenlevel entsprechen:

country/state ↔ national, adm1st ↔ adm1st, adm2nd ↔ adm2nd.
maptype

Vorlage:Positionskarte

|maptype    = relief
Wert Erklärung
<!--leer--> Die normale Karte wird angezeigt
relief Eine physische Karte wird angezeigt. Falls keine physische Karte verfügbar ist, wird die normale Karte angezeigt.
Artikel- und Fließtextkoordinate

Der Inhalt der Felder article und text 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 assoziiert so eine Ortsangabe.

Alte Vorlage Neue Vorlage Ausgabe
{{Koordinate Artikel…}} …}} Die Anzeige im Format DMS oben rechts (Standard).
{{Koordinate Text Artikel…}} …|text=DMS|article=DMS|…}} Anzeige der Koordinate im Text und oben rechts.
{{Koordinate Text…}} …|text=DMS|…}} Anzeige der Koordinate nur im Text.
Formate

Das gewünschte Format wird von einer Untervorlage der Form

{{Coordinate to XYZ   XYZ: das Zielformat (z. B. DMS)
 |NS = 50.3            maximal 6 Nachkommastellen
 |EW =-12.2            negativ ist Süd bzw. West
 |dim= 100             Der Durchmesser des Umkreises steuert die Rundung.
}}

bereitgestellt.

Die unterstützten Formate beschränken sich auf die am häufigsten benutzten Systeme. Dazu gehören z. B. von Rettungsdiensten verwendete Koordinatensysteme.

Wert article text Erklärung
rechnerische Umwandlungen
/ X X Verwende Standardausgabeformat. Benutzen, um zu definieren, dass und nicht wie eine Koordinate im Fließtext bzw. Artikelkopf angezeigt werden soll.
Im Fließtext wegen teurer Parserfunktionen nicht erwünscht.
DMS X X Degrees Minutes Seconds, WGS84 in Grad Minuten und Sekunden Standardausgabe
DM X WGS84 in Grad und Minuten
DEC X WGS84 in Dezimalgrad
UTM
nicht implementiert
X X Universial Transversal Mercator
CH1903 X X Schweizer Landeskoordinaten
OSGB36
nicht implementiert
X X Ordnance Survey Great Britain 1936
textuelle Ersetzungen
ICON0, ICON1 X Anzeige eines assoziativen Sonderzeichens (‚⊙‘, ‚▼‘) mit Verlinkung zum Geohack, um bei der Nutzung in Fließtext (Beispiel: Chao Phraya) den Lesefluss nicht zu unterbrechen.
individueller Text X z. B. für Bereichsangaben wie in Geographie Tunesiens

Rechnerische Umwandlungen und deren Kombinationen

Es können maximal zwei Formate angegeben werden. DM und DMS schließen 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).

Rundung

Eine automatische Rundung erfolgt bei der Standardausgabe Grad Minute Sekunde (DMS), wobei der Parameter dim, also die Größe des Objektes in die Rundung einfließt. Alle Spezialformate werden nicht gerundet. Die Dezimalausgabe wird ebenfalls nicht gerundet.

DMS[3] wird wie folgt gerundet:

Ausgabe dim-Wert [m]
D bei Dimensionen dim > 500000 auf Grad[4]
5° 10′ DM 10000 < dim <= 500000 auf Minuten[5]
5° 10′ 25″ DMS 250 < dim <= 10000 auf Sekunden default
5° 10′ 25,1″ DMSd 25 < dim <= 250 auf Zehntelsekunden[3]
5° 10′ 25,12″ DMSdc dim <= 25 auf Hundertstelsekunden[3]

An Äquator und Meridianen entspricht 1° ≈ 111 km, 1′ ≈ 1,85 km (≈ 1 sm), 1″ ≈ 30 m, 0,01″ ≈ 30 cm
Bei Eingabe von Dezimalwerten für die Koordinaten entspricht 10-6° einer Entfernung von 11 cm.

SORT

Dem Fließtext wird für die Verwendung in Tabellen ein unsichtbarer Sortierschlüssel vorangestellt. Der Schlüssel ist eine eindeutige Kodierung aus Breiten- und Längengrad.

Lagewunsch

Ist die Lage eines georeferenzierbaren Objekts nicht bekannt, so kann die Vorlage:Lagewunsch eingesetzt werden. Substitution dieser Vorlage setzt einen „leeren“ Aufruf der Vorlage:Coordinate ein und bereits bekannte Parameter können fortlaufend ergänzt werden. Über die Wartungskategorie Kategorie:Geographische Lage gewünscht und deren Unterkategorien sind diese Artikel auffindbar.

Achtung: Sorgt in einem Artikel bereits die Infobox für die Generierung eines Lagewunsches, so ist das nochmalige Setzen dieser Vorlage nicht notwendig. Dies ist fast bei allen Infoboxen der Fall, bei denen man eine Georeferenzierung eintragen kann. (→ Kategorie:Vorlage mit Koordinate)

Fehlerbehandlung

Folgende Fälle werden geprüft und mit Fehlermeldung sowie Wartungslink versehen:

  1. Prüfung auf numerischen Wert von Breiten- (NS) und Längengrad (EW) in CoordinateMAIN
  2. Prüfung auf Wertebereich von Breiten- (NS) und Längengrad (EW) im Format ›CH1903‹ in Coordinate to CH1903
  3. Prüfung des type-Parameters in Coordinate/CoordinateMAIN
  4. -
  5. Prüfung auf unbenannte Parameter
  6. Prüfung auf fehlenden Parameter region (in Infoboxen auch REGION-ISO, …)
  7. elevation Parameter fehlt (in Infoboxen auch HÖHE, Höhe, …) → Wartungslink
  8. name Parameter fehlt in Fließtextkoordinate (CoordinateMAIN)
  9. pop Formatierungsfehler (keine natürliche Zahl)
  • default Fehlermeldung (# unbekannte Fehlernummer)

Aus keiner Angabe von Breitengrad NS und Längengrad EW resultiert ein Lagewunsch.

Tutorial Infoboxen

In vielen Fällen erfolgt die Versorgung der Parameter für die Koordinaten direkt aus der Infobox und eine Übergabe als Parameter ist nicht notwendig, ein Beispiel dafür ist etwa die Typangabe type=city, die bei Ortsinfoboxen hart kodiert wird.

Namensempfehlung für Parameter

Folgende Schlüsselwörter werden bei der automatischen Vorlagenauswertung, der Elemente aus Kategorie:Vorlage mit Koordinate, erkannt:

NS
Breitengrad, BREITENGRAD, LATITUDE
EW
Längengrad, LÄNGENGRAD, LONGITUDE
type
COORDINATE_TYPE, KOORDINATE_TYP
pop
Einwohner, EINWOHNER
elevation
Gebrauchshöhe, ELEVATION, ALTITUDE
region
Region-ISO, REGION-ISO, REGION-CODE

Bitte, um Fehlzuweisungen zu vermeiden, diese Parameternamen nur im Kontext mit Koordinaten verwenden! (Die internen Parameter der Vorlage:Coordinate wie NS und EW werden nicht erkannt.)

Externe Schnittstellen

GeoHack

Vorlage:GeoTemplate

API-Auswertung

Organisation der Unterseiten und Untervorlagen (sub-templates)

Unterseiten

Dokumentation

Metadaten

Test

Struktur (sub-templates)

Nachfolgend wird die „Programmstruktur“ der Implementation aufgezeigt:

Hilfsfunktionen

Eingabehilfe CH1903-WGS84 substituierbare Hilfsvorlagen zur Eingabe in Schweizer Landeskoordinaten

Unter-Vorlagen

Allgemeine Vorlagen für Vorlagen
ParmPart: separiert die durch ›/‹ getrennten Parameterteile
Vorlage:Info ISO-3166-2: zur Navigation durch die Administrationslevel
Spezielle Koordinaten-Vorlagen für die Verwendung in Infobox-Vorlagen (indirekte Einbindung der Koordinatenvorlage)
Vorlage:CoordinateLAT Breitengrad (dezimal)
Vorlage:CoordinateLONG Längengrad (dezimal)
Vorlage:CoordinateSYSTEM Default-Koordinatensysteme
Interne Vorlagen (nur Vorlage:Coordinate bestimmt)
Vorlage:CoordinateMSG zur Fehlerbehandlung (Text und zugehöriger Wartungslink)
Vorlage:CoordinateRR DEFAULT bestimmen der Default-Koordinatensysteme (intern)

Hauptfunktion

Coordinate und ihre Einbindungen

  • Prüfung auf Pflichtfelder
    Lagewunsch: Vorlage:CoordinateNO
  • Vorbedingungen erfüllen (Error-Messages 3, 5, 7 und 9)
    • Aufbereitung von Breiten- und Längengrad in Dezimalgrad
    • article (text NOR article)
    • geschützter Wert ›coordinates‹ von Parameter name abfangen. (CSS id Seiteneffekt)
    • sortkey nur weitergeben wenn text nicht leer
  • CoordinateMAIN
  • CoordinateLINK
    • URL zu „Geohack“ und Parameter
    • Link-Text aus:

Ausgabeformat-Erweiterungen

Die gewünschten Formate werden von einer Untervorlage der Form

{{Coordinate to XYZ   XYZ: das Zielformat (z. B. DMS)
 |NS = 50.3            maximal 6 Nachkommastellen
 |EW =-12.2            negativ ist Süd bzw. West
 |dim= 100             Der Durchmesser des Umkreises steuert die Rundung.
 |label=               Name (Label) des Koordinatensystem ausgeben?                
 <!-- 
 |elevation            komplexere Transformationen benötigen die dritte Dimension.
 |region               z. B. für Helmert-Parameter
 -->
}}

bereitgestellt.

Dank konditionaler Vorlageneinbindung wird nur die jeweils notwendige Formatierung in der Vorlage eingesetzt. Die einbindende Vorlage CoordinateLINK bleibt wartbar und es können relativ einfach neue Formate hinzugefügt werden. Eventuell sind für zukünftige Formatierungen noch weitere Parameter erforderlich[6][7] (Helmert-Transformation).

  • Coordinate to CH1903/Doku
  • Coordinate to CH1903/Meta
  • Coordinate to CH1903 for maps
  • Coordinate to CH1903 for maps/Doku
  • Coordinate to DEC
  • Coordinate to DEC/Doku
  • Coordinate to DMS
  • Coordinate to DMS/Doku
  • Coordinate to DMS/Meta
  • Coordinate to DMS for maps
  • Coordinate to DMS for maps/Doku
  • Coordinate to DMS for maps/Meta
  • Siehe auch

    Einzelnachweise

    1. geo-microformats
    2. geo-extention-elevation
    3. 3,0 3,1 3,2 type ›landmark‹ wird nur bis zu einer maximalen dim von 1000m auf Zehntel- und Hunderstel-Sekunden gerundet
    4. default für type = ›country‹, ›state‹, ›adm1st‹
    5. default für type = ›adm2nd‹, ›city‹, ›mountain‹, ›isle‹
    6. Georeferenzierungen Deutschland
    7. Ordnance Survey Grait Britain Ausführliche Dokumentation zum Herunterladen (englisch)