Zum Inhalt springen

Vorlage:Mapshape/Doku

Aus Wikivoyage

Funktion

[Bearbeiten]

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

[Bearbeiten]
  • 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

[Bearbeiten]

Einsatz als Kartenmaske, Bezug aus OpenStreetMap

[Bearbeiten]
Karte
Sachsen-Anhalt

1 Magdeburg, 2 Halle (Saale), 3 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

[Bearbeiten]
{{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

[Bearbeiten]
Karte
New York City

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

[Bearbeiten]

Siehe auch

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

TemplateData

[Bearbeiten]

Die Vorlage überlagert eine dynamische Karte mit einer Kontur.

Vorlagenparameter[Vorlagendaten bearbeiten]

Diese Vorlage bevorzugt Inline-Formatierung von Parametern.

ParameterBeschreibungTypStatus
Wikidata-IDswikidata 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 Textoptional
Kartenobjekt auf Wikimedia Commonswikicommons 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 Textoptional
Typtype

Typ des hinzuzufügenden Layers. Möglich sind geomask, geoshape und geoline. Nur für wikidata.

Standard
geomask
Beispiel
geoshape
Mehrzeiliger Textoptional
Gruppegroup

Gruppe, zu der der Layer hinzugefügt werden soll.

Standard
mask
Beispiel
track
Mehrzeiliger Textoptional
Beschriftungtitle name

Beschriftung des Objekts. Nur für wikidata.

Beispiel
Metrolinie 3
Mehrzeiliger Textoptional
Beschreibungdescription

Beschreibung des Objekts anstelle eines Bildes. Nur für wikidata.

Beispiel
Das ist ein beschreibender Text.
Mehrzeiliger Textoptional
Bildimage

Bild für die Objektbeschreibung.

Beispiel
Flag of Saxony-Anhalt.svg
Mehrzeiliger Textoptional
Füllfarbefill

Farbe für eine Flächenfüllung im RGB-Format. Nur für wikidata.

Standard
#555555
Beispiel
#ff0000
Mehrzeiliger Textoptional
Deckkraft der Füllfarbefill-opacity

Deckkraft der Füllfarbe. Der Wert liegt zwischen 0 und 1. Nur für wikidata.

Standard
0.5
Beispiel
0.6
Zahlenwertoptional
Umrissfarbestroke stroke-color stroke-colour

Farbe des Umrisses oder der Linie im RGB-Format. Nur für wikidata.

Standard
#000000
Mehrzeiliger Textoptional
Deckkraft des Umrissesstroke-opacity

Deckkraft des Umrisses. Der Wert liegt zwischen 0 und 1. Nur für wikidata.

Standard
0.5
Beispiel
0.6
Zahlenwertoptional
Breitestroke-width

Breite des Umrisses oder der Linie in Pixeln. Nur für wikidata.

Standard
2
Beispiel
4
Zahlenwertoptional