Vorlage:Maplink/Doku

Diese Vorlage dient dazu, das Einbinden von Karten aus der Kartographer-Erweiterung zu vereinfachen. Momentan ist in der deutschen Wikipedia jedoch nur <maplink> freigeschaltet.

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. Mögliche Bereiche, in denen die Vorlage verwendet werden könnte:

Straßen
Wasserwege
Bahnstrecken
Stadtpläne
Flugwege
Lebensräume von Tieren
Grenzen

und viele mehr...

Verwendung

Grundlegende Verwendung:

<maplink text="Datenseite">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink/Doku"},"type":"ExternalData","title":"ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map","service":"page"}</maplink> 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)
<maplink text="Umriss oder Linie">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink/Doku"},"type":"ExternalData","service":"geoline","ids":"Q1040"}</maplink> 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.)
<maplink text="Fläche">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink/Doku"},"type":"ExternalData","service":"geoshape","ids":"Q1040"}</maplink> 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.)
<maplink text="Invertierte Fläche">{"properties":{"stroke-width":6,"stroke":"#ff0000","title":"Maplink/Doku"},"type":"ExternalData","service":"geomask","ids":"Q1040"}</maplink> 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:
...Lua-Fehler in Modul:Mapframe, Zeile 201: attempt to index field 'wikibase' (a nil value):
{{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.)

...<maplink longitude="6.6440194" latitude="49.759681" text="über Koordinaten">{"type":"Feature","geometry":{"coordinates":[6.6440194,49.759681],"type":"Point"},"properties":{"title":"Maplink/Doku","marker-color":"5E74F3"}}</maplink>:
{{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. Diese Funktion ist momentan noch nicht verfügbar, da <mapframe> in der deutschen Wikipedia noch nicht freigeschaltet ist.
{{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 kleinerer 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

Lua-Fehler in Modul:Mapframe, Zeile 201: attempt to index field 'wikibase' (a nil value)

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

Siehe auch

Hilfe:Kartographer - Einbindung ohne Vorlage.

Vorlage:Maplink/Doku