Vorlage:Positionskarte/Doku

Aus Rabenstein Wiki
< Vorlage:Positionskarte
Version vom 10. Dezember 2015, 14:14 Uhr von Mordan (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „<noinclude>{{Dokumentation/Dokuseite}}</noinclude> == Benutzung == <nowiki>{{</nowiki>Positionskarte|Kartenname <!-- Frame Rahmen --> |border = <…“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Vorlage:Dokumentation/Dokuseite

Benutzung

{{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 Vorlage:Vorlage 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 and Koordinaten einer Karte enthält. Koordinaten (dezimal) sind hier zu ermitteln: http://www.mcaviglia.ch/gmap/get_coor_ext.asp?l=de (siehe dazu auch WP:GEO)

Markierungen

Bilddateien, die als Markierung verwendet werden können, findet man in Vorlage:Commonscat

Vorlage:Positionskarte+

Vorlage:Positionskarte+

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 Fire.svg für Berge einen anderen Eindruck als RedMountain.svg (nochmals nebeneinander
Fire.svg RedMountain.svg), 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.

Neue Karten erstellen

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.

Wenn es sich um eine quadratische Plattkarte handelt, kann der Quelltext der Vorlage:Positionskarte Italien Sizilien übernommen und angepasst werden:

{{#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).
  • 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 Vorlage:Vorlage 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 Vorlage:Vorlage. Diese Kategorie enthält alle Kartenvorlagen mit dem Parameter zone, während eine andere Kategorie alle solche Vorlagen ohne ihn enthält.

Kartentypen

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
}}

Projektionsarten

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:

{{Positionskarte/Winkel-Tripel-Projektion
|{{{1}}}|{{{2}}}|{{{3}}}
|latitude=0
|longitude=11.5
|latitude1=50.4669
|image=World location map (W3).svg
|name=Welt
}}

Die folgenden Projektionsvorlagen sind verfügbar:

Kartenprojektion Projektionsvorlage Beispiel für Positionskartenvorlage
Plattkarte Vorlage:Vorlage Vorlage:Vorlage
Flächentreue Azimutalprojektion Vorlage:Vorlage Vorlage:Vorlage
Mittabstandstreue Azimutalprojektion in Pollage Vorlage:Vorlage Vorlage:Vorlage
Längentreue Kegelprojektion Vorlage:Vorlage Vorlage:Vorlage
Lineare Kegelprojektion (von hier) Vorlage:Vorlage (wird als Untervorlage der längentreuen Kegelprojektion verwendet)
Winkel-Tripel-Projektion Vorlage:Vorlage Vorlage:Vorlage
Längentreue Kegelprojektion A Vorlage:Vorlage Vorlage:Vorlage

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 Vorlage:Vorlage zu sehen ist.

Eingeklinkte Nebenkarten

Mit der Projektionsvorlage Vorlage:Vorlage 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 Vorlage:Vorlage 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 Vorlage:Vorlage. Allfällige Probleme mit dem Überschreiten des 180. Längengrades sind direkt in den Formeln abzufangen (Beispiel).

Quelle

Von en:Template:Location map übernommen.

Beispiele

Karte mit Standard-Bildunterschrift (Grad)

Husum
{{Positionskarte
 |Deutschland Schleswig-Holstein
 |label=Husum
 |lat=54/29/37
 |long=9/03/04
 |region=DE-SH
 |position=right
 |width=300
 |float=right
}}

Vorlage:Positionskarte+

Karte mit individueller Bildunterschrift

Husum
{{Positionskarte
 |Deutschland Schleswig-Holstein
 |label=Husum
 |lat=54/29/37
 |long=9/03/04
 |region=DE-SH
 |position=right
 |width=300
 |float=right
 |caption=Die Stadt Husum auf der Karte von Schleswig-Holstein.
 }}

Vorlage:Positionskarte+

Karte mit Text-Hintergrundfarbe

Husum
{{Positionskarte
 |Deutschland Schleswig-Holstein
 |label=Husum
 |lat=54/29/37
 |long=9/03/04
 |region=DE-SH
 |position=right
 |width=300
 |float=right
 |background=#FEFEE9
 }}

Vorlage:Positionskarte+

Karte mit verändertem Punkt und größerer Beschriftung

Husum
{{Positionskarte
 |Deutschland Schleswig-Holstein
 |label=Husum
 |label_size=120
 |lat=54/29/37
 |long=9/03/04
 |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
 }}

Vorlage:Positionskarte+

Vorlage:Commonscat

Alternativkarten-Variation für Infoboxen

Husum auf physischer Karte
{{Positionskarte
 |Deutschland Schleswig-Holstein
 |maptype=relief
 |label=Husum
 |lat=54/29/37
 |long=9/03/04
 |region=DE-SH
 |position=right
 |width=300
 |float=right
}}

Vorlage:Positionskarte+

Husum auf Satellitenkarte
{{Positionskarte
 |Europa
 |Alternativkarte=Europe bluemarble laea location map.jpg
 |label=Husum
 |lat=54/29/37
 |long=9/03/04
 |region=DE-SH
 |position=right
 |width=300
 |float=right
}}

Vorlage:Positionskarte+

Karte ohne Bildunterschrift

Tallinn (Estland)
{{Positionskarte
 |Estland
 |label=Tallinn
 |position=left
 |width=250
 |lat=59/25/
 |long=24/46/
 |region=EE
 |float=right
 |caption=
 }}

Vorlage:Positionskarte+

Südlich des Äquators, westlich des Nullmeridians

La Paz (Bolivien)
{{Positionskarte
 |Bolivien
 |label=La Paz
 |lat=16/29/39/S
 |long=68/08/51/W
 |region=BO
 |position=right
 |width=250
 |float=right
 |caption=Lage von La Paz in Bolivien
}}

Vorlage:Positionskarte+

La Paz (Bolivien) mit dem Parameter marktype
{{Positionskarte
 |Bolivien
 |label=La Paz
 |lat=16/29/39/S
 |long=68/08/51/W
 |region=BO
 |position=right
 |width=250
 |float=right
 |caption=Lage von La Paz in Bolivien
 |marktype=hauptstadt
}}

Vorlage:Positionskarte+

Platzierung der Beschriftung

Vorlage:Positionskarte+

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.

Positionskarte mit mehreren Markierungen

(s.a. Vorlage:Positionskarte+)

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
	   | long=09/34/51
           | region=DE
	  }}
          {{ Positionskarte~
	   | Deutschland
	   | label=der zweite Ort hat kein 
                   Label für den Ortsnamen
	   | position=none
	   | lat=52/52/14
	   | long=10/44/51
           | 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
	   | long=11/12/51
           | region=DE
	  }}
          {{ Positionskarte~
	   | Deutschland
	   | label=das Label des vierten 
                   Ortsnamens liegt rechts 
                   am Punkt an
	   | position=right
	   | lat=49/55/14
	   | long=10/54/51
           | region=DE
	  }}
          {{ Positionskarte~
           | Deutschland
	   | label=das Label des fünften 
                   Ortsnamens liegt oben 
                   am Punkt an
	   | position=top
	   | lat=47/50/08
	   | long=10/52/16
           | region=DE
	  }}
}}

Vorlage:Positionskarte+

Karte in einer Ecke

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). Vorlage:Positionskarte+

{{Positionskarte | Kroatien
| lat=44/26
| long = 15/3
| 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

Vorlage:Positionskarte+

{{Positionskarte | Kroatien
| lat=44/26
| long = 15/3
| 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. Vorlage:Positionskarte+

{{Positionskarte
|Frankreich Essonne
|lat=48.6173213
|long=2.4085969
|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. Vorlage:Positionskarte+

{{Positionskarte
|Frankreich Essonne
|lat=48/37/2.36/N
|long=2/24/30.95/E
|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. Vorlage:Positionskarte+

{{Positionskarte
|Frankreich Essonne
|lat=48.6173213
|long=2.4085969
|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. Vorlage:Positionskarte+

{{Positionskarte
|Frankreich
|lat=48.390833
|long=-4.485556
|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.

Verfügbare Karten

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.