Vorlage:Mapshape/Doku

Funktion

Diese Vorlage überlagert eine dynamische Karte mit einer Kontur. Der Bereich inner- oder außerhalb einer Umgrenzung wird abgeschattet oder ein Linienzug wird dargestellt. Die Koordinaten für diesen Layer werden aus der OpenStreetMap-Datenbank bezogen. Die Wikidata-ID wird benötigt, um in der OpenStreetMap-Datenbank nach der aktuell gültigen Relations-ID zu suchen. Z. B. erhält man aus der Wikidata-Datensatz-ID Q797 die OpenStreetMap-Relations-ID 1116270 und die zugehörenden Polygonzüge oder Linienverläufe. Der Eintrag der OpenStreetMap-Relations-ID in Wikidata ist sinnvoll, um die zugehörige ID für die menschliche Suche zu vereinfachen. Allerdings müssen OpenStreetMap-Relations-ID nicht stabil sein, so dass der Wikidata-Link zu OpenStreetmap zur falschen Relations-ID führen kann. Die OpenStreetMap-Daten werden auch dann gefunden, wenn die Relations-ID nicht in Wikidata spezifiziert wurde.

Die Suche nach der Wikidata-ID im OSM-Datensatz erfolgt nicht auf OSM selbst, sondern in der Datenbankkopie auf den Servern der Wikimedia Foundation. Diese wird etwa alle drei Tage aktualisiert. Deshalb kann es vorkommen, dass die Anzeige bei Wikivoyage erst nach wenigen Tagen verfügbar ist.

Es können auch mehrere Wikidata-IDs spezifiziert werden, die dann mit Kommas zu trennen sind.

Siehe auch mw:Help:Extension:Kartographer#External data für weitere Einzelheiten.

Es besteht im deutschen Wikivoyage auch die Möglichkeit, Mapshape-Aufrufe direkt in den Vorlagen {{Mapframe}} und {{Maplink}} zu notieren.

Parameter

• Erforderlicher Parameter:
  • |wikidata= Die Wikidata-Id für die Kartenform. Mehrere IDs können genutzt werden, wenn sie durch Kommas getrennt werden.
    • |id= Alias für wikidata.
    • |ids= Alias für wikidata.
    • |1= Alias für wikidata, d.h., der Parametername kann weggelassen werden.
  • |wikicommons= Der Dateiname einer GeoJSON-kodierten Kartenvorlage auf Wikimedia Commons. Die Parameter wikidata und wikicommons können nicht zusammen benutzt werden. Im Fall von wikicommons wird nur der optionale Parameter group unterstützt.
    • |page= Alias für wikicommons.
    • |from= Alias für wikicommons.

• Optionale Parameter:
  • |type= Der Typ des hinzuzufügenden Layers. Standard ist geomask. Gültige Werte sind:
    • geomask – Stellt einen Polygonzug dar. Abschattung außerhalb einer Umgrenzung.
    • geoshape – Stellt einen Polygonzug dar. Abschattung innerhalb einer Umgrenzung.
    • geoline – Stellt einen Linienzug dar.
  • |group= Definiert eine Gruppe, zu der der Layer hinzugefügt werden soll. Standard ist mask. Der Parameter ist zum Beispiel sinnvoll, wenn mehrere Karten in einem Artikel zum Einsatz kommen. In solch einem Fall sollte der show-Paramter der zugehörigen Vorlage {{Mapframe}} zur zugehörigen Kartenform passen. Sollen die Daten in einer GPX-Datei ausgegeben werden, so setze man group auf track.
  • |title= Beschriftung des Objekts.
    • |name= Alias für title.
  • |image= Bild für die Objektbeschreibung.
  • |fill= Farbe der Füllung im RGB-Format. Standard ist #555555.
  • |fill-opacity= Deckkraft der Füllung. Der Wert liegt zwischen 0 und 1. Standard ist 0.5.
  • |stroke= Farbe der Umrandung im RGB-Format. Standard ist #000000. Falls vorhanden, wird die Farbe für die Umrandung aus dem Wikidata-Datensatz der ersten Wikidata-ID bezogen, und zwar wird die Eigenschaft Farbe (P462) oder die sRGB-Farbraumnummer (P465) verwendet. Letztere wird bevorzugt.
  • |stroke-opacity= Deckkraft der Umrandung. Der Wert liegt zwischen 0 und 1. Standard ist 0.5.
  • |stroke-width= Breite der Umrandung in Pixeln. Standard ist 2.

Beispiele

Einsatz als Kartenmaske, Bezug aus OpenStreetMap

52.1333311.616671 Magdeburg​, 51.4666711.966672 Halle (Saale)​, 51.8359312.242833 Dessau​

{{Mapframe|51.99001|11.87408|zoom=7|name=Sachsen-Anhalt|width=300|height=400}}
{{Mapshape|wikidata=Q1206|title=Sachsen-Anhalt|image=Flag of Saxony-Anhalt.svg}}
{{marker|type=city|name=[[Magdeburg]]|lat=52.13333|long=11.61667|image=DomzuMagdeburg.jpg}},
{{marker|type=city|name=[[Halle (Saale)]]|lat=51.46667|long=11.96667|image=Halle3.jpg}},
{{marker|type=city|name=[[Dessau]]|lat=51.83593|long=12.24283|image=Bauhaus.JPG}}

Parameter type, show und group

{{Mapframe|51.99001|11.87408|zoom=7|name=Sachsen-Anhalt|width=300|height=400}}
{{Mapshape|wikidata=Q1206|type=geoshape}}

Mehrfacher Karteneinsatz unter Nutzung verschiedener show- und group-Parameter.

{{Mapframe|52.16|-112.15|zoom=3|show=map1}}
{{Mapshape|wikidata=Q797|type=geoshape|group=map1}}

{{Mapframe|34.006|-118.401|zoom=13|show=map3}}
{{Mapshape|wikidata=Q493378|group=map3}}

Bezug des Kartenobjekts aus Wikimedia Commons

Die nachfolgende Anwendung wurde aus Kompatibilitätsgründen mit dem englischen Wikivoyage implementiert. Die Parameter wikidata und wikicommons können nicht zusammen benutzt werden.

{{Mapframe|40.7920|-73.975|zoom=11|name=New York City|width=300|height=400}}
{{Mapshape|wikicommons=Neighbourhoods/New York City.map}}

Wartungskategorien

• Kategorie:Wartung:Karten – zeigt Fehler beim Parameteraufruf wie fehlende und falsch geschriebene Parameter an.
  • Kategorie:Mapshape: Unbekannte Parameter‎ – Mapshape wurde mit unbekannten Parametern aufgerufen.
  • Kategorie:Mapshape: wikidata oder wikicommons fehlt – Einer der beiden Parameter wikidata oder wikicommons ist zwingend notwendig.
  • Kategorie:Mapshape: wikidata und wikicommons nicht gleichzeitig – Mapshape wurde mit den Parametern wikidata und wikicommons bzw. ihren Aliasen gleichzeitig aufgerufen, was einen Fehler darstellt.
• Kategorie:Seiten mit Skriptfehlern – enthält auch Seiten mit Wertefehlern einzelner Parameter, die zu fehlerhaften oder unterdrückten Kartendarstellungen führen.

Siehe auch

• {{Mapframe}} – Vorlage, um eine dynamische Karte in einen Artikel einzufügen.
• {{Mapshapes}} – Vorlage, um eine Gruppe von Kartenformen auszugeben.
  

TemplateData

Die Vorlage überlagert eine dynamische Karte mit einer Kontur.

Vorlagenparameter[Vorlagendaten bearbeiten]

Diese Vorlage bevorzugt Inline-Formatierung von Parametern.

Parameter		Beschreibung	Typ	Status
Wikidata-IDs	wikidata id ids 1	Kommaseparierte Liste von Wikidata-IDs mit einem Objekt auf OpenStreetMap. wikidata und wikicommons können nicht zusammen verwendet werden. Standard Wikidata-ID des Artikels Beispiel Q1206 oder Q1205,Q1206	Mehrzeiliger Text	optional
Kartenobjekt auf Wikimedia Commons	wikicommons page from	Dateiname einer GeoJSON-kodierten Kartenvorlage auf Wikimedia Commons. wikidata und wikicommons können nicht zusammen verwendet werden. Beispiel Neighbourhoods/New York City.map	Mehrzeiliger Text	optional
Typ	type	Typ des hinzuzufügenden Layers. Möglich sind geomask, geoshape und geoline. Nur für wikidata. Standard geomask Beispiel geoshape	Mehrzeiliger Text	optional
Gruppe	group	Gruppe, zu der der Layer hinzugefügt werden soll. Standard mask Beispiel track	Mehrzeiliger Text	optional
Beschriftung	title name	Beschriftung des Objekts. Nur für wikidata. Beispiel Metrolinie 3	Mehrzeiliger Text	optional
Beschreibung	description	Beschreibung des Objekts anstelle eines Bildes. Nur für wikidata. Beispiel Das ist ein beschreibender Text.	Mehrzeiliger Text	optional
Bild	image	Bild für die Objektbeschreibung. Beispiel Flag of Saxony-Anhalt.svg	Mehrzeiliger Text	optional
Füllfarbe	fill	Farbe für eine Flächenfüllung im RGB-Format. Nur für wikidata. Standard #555555 Beispiel #ff0000	Mehrzeiliger Text	optional
Deckkraft der Füllfarbe	fill-opacity	Deckkraft der Füllfarbe. Der Wert liegt zwischen 0 und 1. Nur für wikidata. Standard 0.5 Beispiel 0.6	Zahlenwert	optional
Umrissfarbe	stroke stroke-color stroke-colour	Farbe des Umrisses oder der Linie im RGB-Format. Nur für wikidata. Standard #000000	Mehrzeiliger Text	optional
Deckkraft des Umrisses	stroke-opacity	Deckkraft des Umrisses. Der Wert liegt zwischen 0 und 1. Nur für wikidata. Standard 0.5 Beispiel 0.6	Zahlenwert	optional
Breite	stroke-width	Breite des Umrisses oder der Linie in Pixeln. Nur für wikidata. Standard 2 Beispiel 4	Zahlenwert	optional