{{Positionskarte|Kartenname
<!-- Frame Rahmen -->
|border = <!-- Rahmenfarbe oder none -->
|background = <!-- Hintergrundfarbe, Voreinstellung #F9F9F9 (transparent) -->
|caption = <!-- Bildunterschrift -->
|float = <!-- left oder right Die Karte wird links oder rechts ausgerichtet
center Die Karte auf Block-Ebene (Tabelle) dargestellt und zentriert.
inline In aktuellen Browsern wird die Karte auf Inline-Ebene dargestellt und nicht
zentriert, kann aber mit text-align ausgerichtet werden. In veralteten
Browsern, die die CSS-Eigenschaft display:inline-table nicht unterstützen
(IE <= 7, Firefox <= 2), bleibt es bei der Block-Darstellung mit 1em
Mindestabstand nach links und rechts!
none Wie center, jedoch mit 1em Mindestabstand nach links und rechts statt Zentrierung. -->
|width = <!-- ### (maximale) Kartenbreite
x### maximale Höhe,
###x### maximales umgebendes Rechteck
= ›leer‹ thumbsize-Benutzereinstellung
default 240 Pixel -->
|maptype = relief <!-- Verwendet eine physische Karte zur Darstellung, sofern diese existiert.
Andernfalls wird die normale Karte verwendet -->
|Alternativkarte = <!-- Croatia map modern.png (ändert die Karte im Hintergrund, Rahmenkoordinaten
werden vom allgemeinen Kartenamen übernommen – der Befehl sollte nur von
Vorlagen, z.B. Infoboxen mit unterschiedlichen regionalen Hervorhebungen,
verwendet werden) -->
|label = <!-- Text zum markierten Punkt -->
|label_size = <!-- Schriftgröße in Prozent -->
|position = <!-- left oder right oder top oder bottom oder center oder none
oder eine Zahl zwischen 1 und 12 (entsprechend der Uhrzeit auf einem analogen Ziffernblatt)
Position der Beschriftung bezüglich des Markierungspunktes,
Voreinstellung je nach Lage auf der Karte 2, 4, 8 oder 10 -->
|wrap = <!-- auto oder manual, Voreinstellung auto - Zeilenumbruch der Labels
auto:automatisch, manual:Zeilenumbruch wird durch Eingabe von "<br />" im Labeltext erzwungen -->
|mark = <!-- dateiname für den Markierungspunkt, Voreinstellung ist Red pog.svg -->
|marktype = <!-- wählt eine Markierungsart aus, welche in {{Positionskarte/marktype}} definiert ist. -->
|marksize = <!-- Größe des Markierungspunktes in Pixeln, Voreinstellung 8 -->
|marktarget = <!-- Linkziel der Markierung, Standardeinstellung ist die Geo-Referenzierung -->
|background = <!-- Hintergrundfarbe für den Beschriftungstext, Voreinstellung transparent -->
<!-- Coordinates Koordinaten -->
|lat = <!-- Breitengrad in Dezimalwert oder D/M/S →Vorlage:Coordinate#NS -->
|long = <!-- Längengrad in Dezimalwert oder D/M/S →Vorlage:Coordinate#EW -->
|type = <!-- Typ →Vorlage:Coordinate#type -->
|pop = <!-- Einwohner →Vorlage:Coordinate#pop -->
|elevation = <!-- Höhe →Vorlage:Coordinate#elevation -->
|dim = <!-- Dimension →Vorlage:Coordinate#dim -->
|region = <!-- ISO 3166-1/2 Code →Vorlage:Coordinate#region -->
|globe = <!-- Himmelskörper →Vorlage:Coordinate#globe -->
|name = <!-- Name des Objekts →Vorlage:Coordinate#name -->
}}
Der Kartenname in der ersten Zeile bezieht sich auf die Vorlage:Positionskarte Kartenname, die Dateiname und Koordinaten einer Karte enthält.
Koordinaten (dezimal) sind mit diversen Tools zu ermitteln (siehe dazu auch WP:GEO).
Großglockner (Position ist Mittelpunkt Dreieck). Wiki-Syntax: {{Positionskarte |Österreich
|mark=Fire.svg
|marksize=10
|lat=47/4/30/N
|long=12/41/40/E
|region=AT
|caption=[[Großglockner]] (Position ist Mittelpunkt Dreieck).}}
Positionskarte (Österreich)
Großglockner (Position ist Mittelpunkt Basislinie). Wiki-Syntax: {{Positionskarte |Österreich
|mark=RedMountain.svg
|marksize=18
|lat=47/4/30/N
|long=12/41/40/E
|region=AT
|caption=[[Großglockner]] (Position ist Mittelpunkt Basislinie).}}
Die Markierungen werden dabei mit ihrem Mittelpunkt auf die gewünschte Koordinate gesetzt. Damit dies korrekt funktioniert, müssen bei den Markierungen Breite und Länge gleich sein, das umschließende Rechteck also quadratisches Format haben. Dabei ist zu beachten, dass der optische Mittelpunkt nicht immer identisch mit geometrischen Mittelpunkt ist. So bewirkt die Verwendung von für Berge einen anderen Eindruck als (nochmals nebeneinander ), die Mitte ist im ersten Fall der Schwerpunkt, im zweiten Fall der Mittelpunkt der Basis und wird damit der optischen Erwartung für einen Berg weit besser gerecht. Im Beispiel liegt die tatsächliche Position knapp unterhalb der Grenze zum Land Salzburg. Beim zweiten Icon Bild:RedMountain.svg wird die Mitte der Basis in die Mitte der Bilddatei gelegt, indem umgebende Bereiche transparent ergänzt werden.
Untervorlagen müssen nach dem Muster „Vorlage:Positionskarte Kartenname“ benannt sein. Voraussetzung, um eine neue Untervorlage zu erstellen, ist ein Bild, das eine Karte zeigt, deren Kartennetzentwurf bekannt ist oder zumindest möglichst genau geschätzt werden kann.
{{#switch: {{{1}}}
| name = Sizilien
| lemma = Autonome Region Sizilien
| top = 38.9
| bottom = 35.4
| left = 11.8
| right = 15.8
| image = Italy Sicily location map.svg
| zone = italienische Region
}}
name beschreibt das Gebiet, das die Karte zeigt, lemma ist der Titel des zugehörigen Wikipedia-Artikels. Der Parameter lemma kann auch entfallen, falls er mit name übereinstimmt.
top, bottom, left und right sind die Koordinaten der Kartengrenzen. Die Koordinaten müssen dezimal eingegeben werden. Die Himmelsrichtung wird über das Vorzeichen gesteuert (Nord und Ost positiv, Süd und West negativ). Die Angaben können ermittelt werden, indem die Desktop-Anwendung von Google Earth verwendet wird, die Positionskarte als Overlay hinzugefügt sowie passend ausgerichtet wird und anschließend die Koordinaten dieses Overlays als Dezimalwert umgerechnet werden.
image ist der Name der Bilddatei.
zone definiert den Bereich der betreffenden Karte. Wenn es um ein Land geht, dann hat er den Wert Land. Zurzeit (also, seit Juni 2014) wird er von {{Positionskarte}} verwendet, wenn man den optionalen Parameter Karte in einer Ecke benutzt. Wenn der genannte Parameter leer bleibt, dann erscheint automatisch eine Karte in der Ecke mit Hilfe von {{Obige Karte}}. Diese Kategorie enthält alle Kartenvorlagen mit dem Parameter zone, während eine andere Kategorie alle solche Vorlagen ohne ihn enthält.
Falls zu einer Untervorlage neben der normalen, politischen Positionskarte auch noch eine physische Karte mit gleichen Kartengrenzen und gleichem Kartennetzentwurf existiert, soll diese mit der Parameterkombination image|relief angegeben werden. Bei fehlenden zweiten Parameter oder unbekannten Kartentypen wird stets die normale, politische Positionskarte als Default angegeben:
{{#switch:{{{1}}}
| name = Italien
| top = 47.4
| bottom = 35.3
| left = 6.2
| right = 19.0
|image={{#switch: {{{2|}}}
|relief=Italy relief location map.jpg
|#default=Italy location map.svg
}}
| zone = Land
}}
Quadratische Plattkarten bieten sich an, wenn das darzustellende Gebiet nicht allzu weit vom Äquator entfernt ist und keine allzu große Ausdehnung aufweist. Sie sind besonders einfach zu handhaben und können in sehr vielen Wikis verwendet werden. Karten, die den 180. Längengrad überschreiten, werden automatisch erkannt und korrekt behandelt; dies gilt jedoch nicht in allen anderen Wikis.
Für einige Gebiete wie Kanada oder Russland sind andere Kartennetzentwürfe besser geeignet; die Polarregionen sind gar nicht als quadratische Plattkarten darstellbar. Der Kartenausschnitt der anderen Kartennetzentwürfe lässt sich allerdings nicht über die Parameter top, bottom, left und right beschreiben sondern erfordert spezifische Parameter. Mithilfe dieser Parameter und mathematischen Formeln kann die geographische Position in eine relative Position auf dem Bild umgerechnet werden. Die neue Vorlage muss dazu auf Anfrage die Parameter x und y die relative Position der Markierung in Prozent berechnen. x reicht von 0 am linken bis 100 am rechten, y von 0 am oberen bis 100 am unteren Rand der Karte. Bei der Berechnung wird der Breitengrad als Parameter {{{2}}} und der Längengrad als Parameter {{{3}}} übergebenen.
Für die gängigen Projektionsarten stehen Projektionsvorlagen bereit, die diese Umrechnung übernehmen. Dazu wird die entsprechende Projektionsvorlage zusammen mit den spezifischen Parametern des Kartenausschnitts eingebunden. Beispiel:
Für weitere Projektionsarten oder Spezialfälle kann die relative Position auch mit je einer Formel für x und y direkt in der Vorlage bestimmt werden, wie zum Beispiel im Quelltext der {{Positionskarte Antarktis}} zu sehen ist.
Mit der Projektionsvorlage {{Positionskarte/Einklinker}} können auch Positionskarten mit Nebenkarten verwendet werden. Dabei können sowohl Haupt- als auch Nebenkarte als Plattkarte oder in jeder beliebigen andern der oben aufgelisteten Projektionsarten abgebildet werden. Die Verzweigung, ob die Position auf der Haupt- oder auf der Nebenkarte angezeigt wird, muss in der Vorlage anhand einer frei gewählten, mathematisch möglichst leicht überprüfbaren Bedingung erfolgen. Im Beispiel {{Positionskarte Brasilien Pernambuco}} werden alle Positionen östlich 33° westlicher Länge auf der Nebenkarte angezeigt.
Alternativ dazu können Einklinker auch per Formel direkt in der Vorlage abgebildet werden, wie zum Beispiel Jan Mayen in {{Positionskarte Norwegen Svalbard und Jan Mayen}}. Allfällige Probleme mit dem Überschreiten des 180. Längengrades sind direkt in den Formeln abzufangen (Beispiel).
{{Positionskarte
|Deutschland Schleswig-Holstein
|label=Husum
|lat=54/29/37/N
|long=9/03/04/E
|region=DE-SH
|position=right
|width=300
|float=right
|caption=Die Stadt Husum auf der Karte von Schleswig-Holstein.
}}
Husum (Schleswig-Holstein)
Husum
Die Stadt Husum auf der Karte von Schleswig-Holstein.
{{Positionskarte
|Deutschland Schleswig-Holstein
|label=Husum
|label_size=120
|lat=54/29/37/N
|long=9/03/04/E
|region=DE-SH
|mark=Paris plan pointer b jms.svg
|marksize=12
|position=right
|width=300
|float=right
|caption=Die Stadt Husum auf der Karte von Schleswig-Holstein
}}
Husum (Schleswig-Holstein)
Husum
Die Stadt Husum auf der Karte von Schleswig-Holstein
Mögliche Platzierung der Beschriftung mit dem Parameter position
Als Voreinstellung wird in den unteren zwei Dritteln der Karte die Beschriftung schräg über der Position 10 bzw. 2 (je nach Kartenhälfte) und im oberen Drittel dann schräg unter der Position 8 bzw. 4 angezeigt.
Obwohl die Positionskarten das Markieren mehrerer Punkte ermöglichen, sind sie als Zeichenwerkzeug denkbar ungeeignet, zum Beispiel um den Verlauf eines Flusses durch viele Punkte zu markieren. Jeder eingezeichnete Punkt erhöht die Ladezeiten. In solchen Fällen bietet es sich alternativ an, eine eigene Karte oder auch eine Positionskarte mit einer maßgeschneiderten Markierung zu verwenden.
Ein paar Orte in Deutschland
{{ Positionskarte+
| Deutschland
| width=375
| float=right
| caption=Ein paar Orte
| places={{ Positionskarte~
| Deutschland
| label=das Label des ersten Ortsnamens liegt links am Punkt an
| position=left
| lat=53/10/14/N
| long=09/34/51/E
| region=DE
}}
{{ Positionskarte~
| Deutschland
| label=der zweite Ort hat kein Label für den Ortsnamen
| position=none
| lat=52/52/14/N
| long=10/44/51/E
| region=DE
}}
{{ Positionskarte~
| Deutschland
| label=das Label des dritten<br />Ortes liegt unten am Punkt an<br />mit manuellem Zeilenumbruch
| position=bottom | wrap=manual
| lat=51/55/14/N
| long=11/12/51/E
| region=DE
}}
{{ Positionskarte~
| Deutschland
| label=das Label des vierten Ortsnamens liegt rechts am Punkt an
| position=right
| lat=49/55/14/N
| long=10/54/51/E
| region=DE
}}
{{ Positionskarte~
| Deutschland
| label=das Label des fünften Ortsnamens liegt oben am Punkt an
| position=top
| lat=47/50/08/N
| long=10/52/16/E
| region=DE
}}
}}
Positionskarte (Deutschland)
das Label des ersten Ortsnamens liegt links am Punkt an
das Label des dritten Ortes liegt unten am Punkt an mit manuellem Zeilenumbruch
das Label des vierten Ortsnamens liegt rechts am Punkt an
das Label des fünften Ortsnamens liegt oben am Punkt an
Seit dem 1. Juni 2014 gibt es eine neue Funktionalität, und zwar eine kleine Karte in der Ecke oberhalb der großen Karte.
Wenn die Hauptkarte die eines Landes ist, dann läßt der Parameter "Karte in einer Ecke" ohne gegebenen Wert eine Karte der ganzen Welt erscheinen. Beachte bitte, daß dies nur funktioniert, wenn die betreffende Kartenvorlage den Parameter "zone" enthält (Siehe die betreffende Kategorie).
Pag (Kroatien)
Pag
Pag ist auf einer Insel.
{{Positionskarte | Kroatien
| lat=44/26//N
| long = 15/3//E
| region = HR
| label = Pag
| position = right
| mark = Green pog.svg <!--grüner Punkt-->
| width = 200
| float = right
| caption = Pag ist auf einer Insel.
| Karte in einer Ecke=
}}
Mit dem Parameter "Karte in einer Ecke", allerdings mit Wert
Pag (Kroatien)
Pag
Pag ist auf einer Insel.
{{Positionskarte | Kroatien
| lat=44/26//N
| long = 15/3//E
| region = HR
| label = Pag
| position = right
| mark = Green pog.svg <!--grüner Punkt-->
| width = 200
| float = right
| caption = Pag ist auf einer Insel.
| Karte in einer Ecke=Europa
}}
Wenn die Hauptkarte die Karte einer Region oder eines Subterritoriums ist, dann erscheint ohne angegeben Wert von "Karte in einer Ecke" das betreffende Land.
Courcouronnes (Département Essonne)
Lokalisierung von Courcouronnes in Essonne.
{{Positionskarte
|Frankreich Essonne
|lat=48.6173213
|long=2.4085969
|region=FR-91
|label=Courcouronnes
|position=none
|Karte in einer Ecke=
|maptype=relief
|caption=Lokalisierung von Courcouronnes in Essonne.
}}
Die automatische Platzierung der Eckkarte funktioniert seit dem 3. Juni 2014 auch, wenn die Koordinaten im GMS-Format übergeben werden.
Courcouronnes (Département Essonne)
Lokalisierung von Courcouronnes in Essonne.
{{Positionskarte
|Frankreich Essonne
|lat=48/37/2.36/N
|long=2/24/30.95/E
|region=FR-91
|label=Courcouronnes
|position=none
|Karte in einer Ecke=
|maptype=relief
|caption=Lokalisierung von Courcouronnes in Essonne.
}}
Um eine Karte der Welt anzuzeigen, ist es nötig den Wert Welt im neuen Parameter "Karte in einer Ecke" zu definieren.
Courcouronnes (Département Essonne)
Lokalisierung von Courcouronnes in Essonne.
{{Positionskarte
|Frankreich Essonne
|lat=48.6173213
|long=2.4085969
|region=FR-91
|label=Courcouronnes
|position=none
|Karte in einer Ecke=Welt
|caption=Lokalisierung von Courcouronnes in Essonne.
}}
Es ist sogar möglich eine andere Karte nach dem folgenden Beispiel zu definieren.
Brest (Frankreich)
Lokalisierung von Brest in Frankreich.
{{Positionskarte
|Frankreich
|lat=48.390833
|long=-4.485556
|region=FR-29
|label=Brest
|position=none
|Karte in einer Ecke=Europa
|maptype=relief
|caption=Lokalisierung von Brest in Frankreich.
<!--die folgenden Parameter sind nur wirksam zusammen mit "Karte in einer Ecke"-->
|Karte=Frankreich
|Zugabe={{Positionskarte~|Europa|lat=48.390833|long=-4.485556|label=Brest|position=none|marksize=3}}
|Datei=France in Europe (relief) (-mini map).svg
|Stil=;
}}
Hinweis: nutze Stil=; um den roten Rahmen, der standardmäßig definiert ist, zu unterdrücken.
Seit dem 13. Juni 2019 läßt sich der rote Rahmen mit dem Wert none des Parameters Rahmen ausblenden. Und zwar so:
Brest (Frankreich)
Lokalisierung von Brest in Frankreich.
{{Positionskarte
|Frankreich
|lat=48.390833
|long=-4.485556
|region=FR-29
|label=Brest
|position=none
|Karte in einer Ecke=Europa
|maptype=relief
|caption=Lokalisierung von Brest in Frankreich.
<!--die folgenden Parameter sind nur wirksam zusammen mit "Karte in einer Ecke"-->
|Karte=Frankreich
|Zugabe={{Positionskarte~|Europa|lat=48.390833|long=-4.485556|label=Brest|position=none|marksize=3}}
|Datei=France in Europe (relief) (-mini map).svg
|Rahmen=none
}}
Eine Liste der verfügbaren Vorlagen nach dem Muster "Vorlage:Positionskarte Kartenname" findet sich unter Kategorie:Vorlage:Positionskarte. Die Sortierung erfolgt nach Ländernamen. Für verfügbare Positionskarten eines Landes kann auch in die Ländervorlagenkategorie geschaut werden.
Utilities
Bei technischen Fragen zu dieser Vorlage kannst du dich auch an die Vorlagenwerkstatt wenden. Inhaltliche Fragen und Vorschläge gehören zunächst auf die Diskussionsseite. Sie können ggf. auch an eine passende Redaktion, Portal usw. gerichtet werden.
Commons: Map pointers – Sammlung vo Buidl, Videos und Audiodateien
für Berge einen anderen Eindruck als 
(nochmals nebeneinander 
.svg)
![verweis=[[WP:HS]]](/wiki/Datei:Red_pog.svg){kind=small}
![verweis=[[WP:HS]]](/wiki/Datei:Red_circle.svg)
_(-mini_map).svg)
