Vorlage:Maplink/Doku

Diese Seite ist die Dokumentations-Unterseite der Vorlage:Maplink.

Diese Vorlage dient dazu, das Einbinden von Karten aus der Kartographer-Erweiterung (<maplink> und <mapframe>) zu vereinfachen.

Wozu?

Die Wirkung von maplink ist die Generierung einer Verlinkung auf eine Karte im Vollbildmodus, ggf. mit eingezeichneten Positionen. Dabei können sowohl einzelne Marker, als auch Linien und Polygone dargestellt werden. Mit mapframe wird anstelle des Links eine Vorschaukarte angezeigt.

Mögliche Bereiche, in denen die Vorlage verwendet werden könnte:

• Strecken:
  • Straßen
  • Radwege
  • Wasserwege
  • Bahnstrecken
  • Flugwege
• Grenzen/Umrisse
  • Stadtpläne
  • Lebensräume von Tieren

und viele mehr...

Verwendung

Grundlegende Verwendung:

• Datenseite auf Commons (z.B. Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):

  {{maplink|from=}} (Namen der .map Datenseite unter from= eintragen, aber ohne den Data: Präfix)

• Unverarbeitete GeoJSON-Daten (momentan kein Beispiel in der deutschen Wikipedia verfügbar, aber in en):

  {{maplink|raw=}} (Namen der GeoJSON-Seite unter raw= eintragen)

• Umriss oder Linie von einem OpenStreetMap-Objekt:

  {{maplink|type=line|id=}} (Unter id= wird die Wikidata-ID eines Objekts eingetragen. Dazu muss das OSM-Objekt aber auch mit einem Wikidata-Tag versehen sein. Soll auf der Karte das Objekt, mit dem der Artikel verbunden ist, dargestellt werden, muss id= nicht unbedingt ausgefüllt werden.)

• Fläche von einem OpenStreetMap-Objekt:

  {{maplink|type=shape|id=}} (Unter id= wird die Wikidata-ID eines Objekts eingetragen. Dazu muss das OSM-Objekt aber auch mit einem Wikidata-Tag versehen sein. Soll auf der Karte das Objekt, mit dem der Artikel verbunden ist, dargestellt werden, muss id= nicht unbedingt ausgefüllt werden.)

• Invertierte Fläche von einem OpenStreetMap-Objekt:

  {{maplink|type=shape-inverse|id=}} (Unter id= wird die Wikidata-ID eines Objekts eingetragen. Dazu muss das OSM-Objekt aber auch mit einem Wikidata-Tag versehen sein. Soll auf der Karte das Objekt, mit dem der Artikel verbunden ist, dargestellt werden, muss id= nicht unbedingt ausgefüllt werden.)

• Einzelner Punkt:

  ...über Wikidata:
  {{maplink|type=point|id=}} (Unter id= wird die Wikidata-ID eines Objekts eingetragen. Dazu muss das OSM-Objekt aber auch mit einem Wikidata-Tag versehen sein. Soll auf der Karte das Objekt, mit dem der Artikel verbunden ist, dargestellt werden, muss id= nicht unbedingt ausgefüllt werden.)

  ...über Koordinaten:
  {{maplink|type=point|coord={{Coordinate|NS=49.759681|EW=6.6440194|text=DMS|name=Beschreibung|region=mindestens nach ISO-3166-1}}}}

  • Die Parameter text & name sollten unbedingt mit Werten versorgt sein, wenn es nicht nur eine einzige Koordinate (=Artikelkoordinate) ist, weil sonst eine Fehlermeldung erzeugt wird({{#coordinates:}}: Es kann nicht mehr als eine primäre Auszeichnung angegeben werden.
  • Parameter region ist Plichtparameter
• Soll die Karte im Artikel in einem Rahmen dargestellt werden, ist der Parameter |frame=yes notwendig.

  {{maplink|frame=yes|type=line|id=Q1040|text=Mapframe example}}

Parameter

Darstellung allgemein

display

Bestimmt, wie die Vorlage dargestellt wird. Akzeptierte Werte sind:

inline - Zeigt nur den inline-Link (Standardeinstellung, also unnötig)

title - Zeigt nur den title-Link (wenn |title= festgelegt ist)

inline,title - Zeigt den inline-Link und den title-Link

title,inline - Zeigt den inline-Link und den title-Link

text

Text, der im Artikel als Link dargestellt wird (bzw. Text unter der Karte bei mapframe); Standardwert ist "Karte"

icon

Mit dem Wert "no" wird das Kartensymbol links neben dem Linktext ausgeblendet

zoom

Bestimmt den Zoomlevel, von 1 bis 19 (größere Zahl bedeutet größerer Maßstab); Die Standardeinstellung passt sich automatisch an die dargestellten Objekte an. Anhaltswerte: 6, 7 – Staat; 12 – Stadt; 16 – Stadtplan

Einzelne Objekte

Auf einer Karte können auch mehrere Objekte dargestellt werden. Für jedes zusätzliches Objekt muss der Reihe nach eine Zahl am Ende des Parameternamens hinzugefügt werden. Für ein zweites Objekt müsste man also |type2=, |id2=, usw. benutzen, für ein drittes |type3=, |id3=, usw.

type

Die Art des Objektes. Akzeptierte Werte sind:

line – eine Linie von OSM (z.B. Straßenverlauf oder Fluss)

shape – eine Fläche von OSM (z.B. Administrative Grenze oder Nationalpark)

shape-inverse – eine Fläche von OSM, wobei jedoch statt der Fläche alles andere markiert wird

data – eine geoJSON-Datenseite auf Commons (In diesem Fall ist der Parameter eigentlich überflüssig)

point – ein einfacher Punkt (Koordinaten)

id

(oder ids)

Wikidata-ID (Q-Nummer) von einem Objekt. Dabei muss aber auch ein OSM-Objekt mit dem entsprechenden Wikidata-Tag versehen sein. Mehrere IDs werden mit einem Komma getrennt. Standardwert ist das Wikidata-Objekt, das mit dem Artikel verbunden ist.

from

JSON-Datei (.map) von Commons (wobei der Präfix Data: weggelassen werden sollte)

title

Titel des Objekts (für Objekte von OSM); Wird angezeigt, wenn man auf der Karte auf das Objekt klickt; Standardwert ist der Artikelname

description

Beschreibung des Objekts (für Objekte von OSM); Wird angezeigt, wenn man auf der Karte auf das Objekt klickt; optional

stroke-color

(oder stroke-colour)

Farbe, in der ein Objekt von OSM dargestellt wird; Standardwert ist #ff0000 (rot)

stroke-width

Stärke des Umrisses/der Linie, durch die ein Objekt von OSM dargestellt wird; Standardwert ist 6

coord

Koordinaten eines Punktes, wenn er nicht durch Wikidata festgelegt wurde. Dazu wird die Vorlage {{Coord|NS=|EW=}} verwendet.

marker

Name des Maki Marker-Symbols. Siehe mw:Maps/Icons für mögliche Werte. Als Standardwert ist kein Symbol eingestellt

marker-color

(oder marker-colour)

Hexadezimalcode für den Farbwert des Markers. Standardwert ist 5E74F3 (blau)

Beispiele

Mehrere Objekte

{{Maplink
|zoom=16
|type=shape|id=Q517334|title=Fläche|description=Beschreibung der Fläche
|type2=line|id2=Q2244476|title2=Linie|description2=Beschreibung der Linie
|type3=point|id3=Q627815|title3=Punkt|description3=Beschreibung des Punkts
}}

Strecke von Commons

{{Maplink
|
|frame=yes
|plain=yes
|frame-align=left
|from=Olympic Marathon Paris 2024.map
|type=data
|frame-width=350
|frame-height=250
}}

Beispielseite: Olympische Sommerspiele 2024/Leichtathletik – Marathon (Männer) - Einbindung erfolgt in der Infobox

Siehe auch

• Hilfe:Kartographer - Einbindung ohne Vorlage.