Help:Extension:Kartographer/de

Die -Erweiterung ermöglicht es dir, interaktive und statische Karten auf Wikimedia-Wikiseiten zu erstellen. Diese Seite ist eine umfassende Anleitung für die Verwendung von Kartographer, einschließlich der vielen Optionen, die bei der Verwendung der Tags, der Karten direkt in Wikiseiten einbettet, und , der Links zu ganzseitigen interaktiven Karten erstellt, zur Verfügung stehen, und geht auf die von Kartographer unterstützten Elemente von GeoJSON ein. Am Ende der Seite findest du eine Vielzahl von Beispielen.

Einen weniger technischen Schnelleinstieg findest du unter. Hilfe zu Kartographer im VisualEditor findest du unter. Hilfe zu Kartographer und OpenStreetMaps findest du unter.

Grundlegende Kartensyntax
Zur Platzierung einer Karte oder eines Kartenlinks direkt auf einer Wiki-Seite bietet Kartographer zwei Tags an:, die eine Karte inline einbetten, die auf eine interaktive Karte im Vollbildmodus verlinkt, und  , das einen Fließtext (mit einer optionalen Markierung) erstellt, der auf eine interaktive Karte im Vollbildmodus verlinkt.

Einige Wikis integrieren diese Tags in Vorlagen, wie Mapbox und Mapframe. Informiere dich auf der Kartographer-Hilfeseite deines Wikis, um zu sehen, ob dein Wiki über Vorlagen verfügt - oder verwende die Tags direkt mit diesem Dokument als Anleitung.



Der -Tag bettet eine Karte in eine Wikiseite ein. Der Tag muss entweder leer sein oder GeoJSON enthalten. Siehe unten für weitere Informationen zum Schreiben von GeoJSON.

Das -Tag erzeugt einen Link zu einer Karte im Vollbildmodus.

(string)
 * (numeric)

* = required

Selbstschließende Tags
Wenn du kein GeoJSON verwendest, kannst du  und   als selbstschließende, eigenständige Tags verwenden.

Selbstschließend:

Eingeschlossenes GeoJSON:

GeoJSON
 { "type": "FeatureCollection", "features": [ {     "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.41816520690917,         37.79097260220947        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.40786552429199,         37.799654055191525        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.40185737609865,         37.796262984039544        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.38743782043457,         37.80535070427755        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.38005638122557,         37.795449103799726        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-letter", "marker-color": "208020" },     "geometry": { "type": "Point", "coordinates": [ -122.40941047668457,         37.81850557172186        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-letter", "marker-color": "208020" },     "geometry": { "type": "Point", "coordinates": [ -122.40357398986815,         37.81280993744834        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-letter", "marker-color": "208020" },     "geometry": { "type": "Point", "coordinates": [ -122.39842414855956,         37.8071138637568        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number-bar", "marker-color": "f01080" },     "geometry": { "type": "Point", "coordinates": [ -122.41181373596191,         37.78595317184089        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number-bar", "marker-color": "f01080" },     "geometry": { "type": "Point", "coordinates": [ -122.39542007446289,         37.787674400057654        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number-bar", "marker-color": "f01080" },     "geometry": { "type": "Point", "coordinates": [ -122.38649368286131,         37.78401144262929        ]      }    }  ] }

Die Tags und  können entweder leer sein oder gültiges GeoJSON enthalten, womit die Karte mit Markierungen versehen, Formen gezeichnet und ein Maskenbereich angewendet werden kann.

Für weitere Details zu diesem umfassenden Thema kannst du diese hilfreiche Einführung in GeoJSON sowie die vollständige GeoJSON-Spezifikation lesen.

Markierungen
Karten, die GeoJSON verwenden, können eine oder mehrere Markierungen enthalten, um auf ausgewählte Orte zu verweisen. Diese Markierungen werden mit markierungsspezifischen Schlüsselwörtern auf der Ebene "Eigenschaften" in GeoJSON festgelegt.

Kartographer unterstützt die Simplestyle-Spezifikation mit Maki-Symbolen, die unter CC0 license verfügbar sind. Siehe die vollständige Liste der unterstützten Symbole.

Ergebnis:

Automatische Zähler
Mehrere Markierungen auf einer Karte können mithilfe von Mustern und Zählern gruppiert und benannt werden. Im Folgenden findest du eine Zusammenfassung der Styling-Attribute für Elemente, die mit GeoJSON auf einer Karte platziert werden. Mehr Informationen findest du in der simplestyle-Spezifikation.

Eine Vielzahl von Beispielen findest du im Abschnitt Beispiele.

Formen
GeoJSON ermöglicht es dir, Linien und geometrische Flächen als Anmerkungen zu deiner Karte hinzuzufügen. Sie können einfache Inline-Formen definieren oder sie aus externen Datenbanken importieren.

Inline
GeoJSON ermöglicht es dir, Punkte ( Markierungen), einfache Linien und geometrische Flächen als Teil deiner Kartendefinition zu zeichnen. Die folgenden Beispiele beinhalten das "geometry" Attribut von GeoJSON-Objekten innerhalb eines -Objekts. Weitere Informationen findest du in der vollständigen GeoJSON Spezifikation.

Externe Daten
 { "type": "ExternalData", "service": "geoshape", "ids": "Q797" }

GeoJSON ermöglicht es dir, Umrisse von geografischen Objekten aus externen Quellen zu erhalten, indem du das Attribut "type" mit dem Wert "ExternalData" verwendest.

Karten können aus bekannten geografischen Objekten in der OpenStreetMap-Datenbank unter Verwendung ihrer Wikidata-ID stammen; sie können auch aus Wikidata-SPARQL-Abfragen oder aus Shapes in Wikimedia Commons (.map-Dateien) stammen.

Zusätzlich können Karten direkt auf unbearbeitete GeoJSON-Daten verlinken, die auf Wikimedia Commons gespeichert sind: siehe für Details.

Objekte können auf drei verschiedene Arten mit Formdaten aus einer externen Quelle gerendert werden:


 * - Zeichnet eine einfache Linie.
 * - Zeichnet ein Polygon mit einem schattierten Innenraum.
 * - Zeichnet ein Polygon und schattiert alles außerhalb des Polygons.

Formen via Wikipedia-ID
 { "type": "ExternalData", "service": "geoshape", "ids": "Q34713,Q701153" }

Die Wikidata-IDs sind in der OSM-Community noch relativ neu. Mit Stand von Anfang 2022 gibt es etwa 1,9 Millionen Elemente mit Wikidata-IDs. Du kannst deine eigenen unter https://www.openstreetmap.org/ hinzufügen - achte darauf, dass du das -Tag und den entsprechenden  -Wert hinzufügst. Die Daten liegen Kartographer in der Regel innerhalb von zwei Tagen vor. Weitere Informationen hierzu gibt es im OSM wiki.

Formen via Wikipedia query
 { "type": "ExternalData", "service": "geoshape", "query": "SELECT ?id ?head (SAMPLE(?img) as ?img_) (min(?partyId) as ?party) (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill) (concat(, ?headLabel, ) as ?title) (concat(?stateLabel, '\\n', '') as ?description) WHERE { ?id wdt:P31 wd:Q35657 . ?id wdt:P6 ?head . ?head wdt:P102 ?party . BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId) SERVICE wikibase:label { bd:serviceParam wikibase:language 'en' . ?head rdfs:label ?headLabel . ?id rdfs:label ?stateLabel . } OPTIONAL { ?head wdt:P18 ?img . } ?link schema:about ?head . ?link schema:isPartOf  .} GROUP BY ?id ?head ?headLabel ?link ?stateLabel" } Anstelle einer Wikidata Item ID kann eine Karte auch Geoshapes aus einer Wikidata-Abfrage in SPARQL erzeugen. (Mit Hilfe des Query Builder kannst du SPARQL-Abfragen erstellen.)

Ausführliche Informationen findest du unter.

Kartendaten von Commons
 { "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" } In GeoJSON gespeicherte Kartendaten, die auf Commons gespeichert sind, können in die Karte eingezeichnet werden.


 * Weitere Informationen: 

Maskenebene
 { "type": "ExternalData", "service": "geomask", "ids": "Q34713", "properties": { "fill": "#555555", "fill-opacity": 0.5, "stroke": "#000000", "stroke-width": 1, "stroke-opacity": 1 } }

Eine Maske ist einfach eine Form, die von innen nach außen verläuft, wobei die Außenseite der Form schattiert ist.

Mehrere Datentypen kombinieren
Du kannst ExternalData, Feature und FeatureCollection Objekte in demselben oder  Element kombinieren, um zum Beispiel Features mit Titeln und Beschreibungen über extern bezogenen Objekten hervorzuheben.

Kartendaten aus Commons können mit anderen Datentypen kombiniert werden, indem sie einfach in parallelen GeoJSON-Blöcken zusammengefasst werden. Siehe #Mixed types für verschiedene Kombinationen.

Formen gestalten
 { "type": "ExternalData", "service": "geoline", "ids": "Q2108", "properties": { "title": "Highway I-696", "description": "", "stroke": "#ffb100", "stroke-width": 8 } }

Zusätzlich zu den oben genannten Markierungsstilen unterstützen Linien und Flächen diese simplestyle-Eigenschaften:

Sich überschneidende Elemente
Kartenelemente, die sich überschneiden, werden in der Reihenfolge gezeichnet, in der sie im Code erscheinen. Wenn eine Karte zwei Linien enthält, die sich überschneiden, erscheint die erste definierte Linie unter der als nächstes definierten Linie. Dies gilt für alle im Code definierten Elemente, die auf der Karte gezeichnet werden.

Beispiele
 { "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": {"fill": "#ff0000","fill-opacity": 0.7,"stroke-width": 0}, "geometry": { "type": "Polygon", "coordinates": [ [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ], [ 77.926025390625, -24.43714786161562 ], [ 77.926025390625, -25.150257104114733 ] ] ] } }, { "type": "Feature", "properties": {"stroke": "#fffa00","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ] ] } }, { "type": "Feature", "properties": {"stroke": "#000000","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -24.43714786161562 ], [ 80.14251708984374, -25.150257104114733 ] ] } } ] }

Der Quelltext der obigen Karte enthält drei Elemente, die alle die Funktionalität "Feature" von GeoJSON nutzen. Das erste Element ist ein "Polygon" - das rote Rechteck. Darauf folgen zwei "LineString"-Features. Die gelbe Linie wird zuerst definiert und erscheint daher unter der schwarzen Linie. Beachte, dass die Hierarchie, die zum Zeichnen von Elementen verwendet wird, unabhängig davon gilt, ob es sich bei den Daten um rohes GeoJSON handelt oder ob sie von einer Wikidata-ID oder einer Commons-Datenseite stammen.

In der folgenden Karte wird die Reihenfolge gegenüber dem ersten Beispiel geändert: Die schwarze Linie wird zuerst definiert und somit an das Ende des Stapels verschoben:

 { "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": {"stroke": "#000000","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -24.43714786161562 ], [ 80.14251708984374, -25.150257104114733 ] ] } }, { "type": "Feature", "properties": {"fill": "#ff0000","fill-opacity": 0.7,"stroke-width": 0}, "geometry": { "type": "Polygon", "coordinates": [ [ [  77.926025390625,  -25.150257104114733  ],  [  80.14251708984374,  -25.150257104114733  ],  [  80.14251708984374,  -24.43714786161562  ],  [  77.926025390625,  -24.43714786161562  ],  [  77.926025390625,  -25.150257104114733  ]  ]  ]  } }, { "type": "Feature", "properties": {"stroke": "#fffa00","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ] ] } } ] }

Reference

 * Full GeoJSON specification (RFC7946)
 * GeoJSON on English Wikipedia
 * simplestyle spec used by Kartographer
 * Maki icon set used by Kartographer

Guides

 * HERE.com's intro to GeoJSON
 * A guide to the GeoJSON.io editor

Editors and tools

 * GeoJSON.io editor
 * Vector.rocks editor
 * GeoJSON linter to validate your GeoJSON

Gruppen für Wikivoyage
Das Wikivoyage-Projekt muss Karten anzeigen, deren Daten an anderer Stelle auf der Seite definiert sind. Es können mehrere interessante Punkte (Points of Interest, kurz POI) mit -Tags definiert werden, die alle auf einer einzigen gemeinsamen Karte am Rand der Seite erscheinen. (Siehe als Beispiel Salzburg.)

Gruppieren ermöglicht es Editoren, Daten zwischen mehreren $mapframe und $maplink-Tags zu teilen.

Normalerweise werden die Daten innerhalb eines $mapframe- oder $maplink-Tags nur auf der von diesem Tag erstellten Karte angezeigt und nirgendwo sonst.

Auf Wikivoyage jedoch, wenn ein $maplink-Tag das $group-Attribut enthält, werden die Daten innerhalb dieser Tags in eine benannte Gruppe zusammen mit allen anderen Daten mit demselben Gruppennamen eingeordnet. Tags mit demselben Gruppennamen werden auf einer einzigen Karte angezeigt; jedes Tag fügt der Gruppe schrittweise Daten hinzu.

Jedes -Tag auf einem Wikivoyage-Tag zeigt eine eingebettete Karte an, die die im Tag angegebenen Gruppen anzeigt.

Eine Karte kann auch zusätzliche Gruppen anzeigen, indem sie das Attribut  angibt. Es können mehrere Gruppennamen angegeben werden, die durch ein Komma getrennt werden. Ein Gruppenname darf nur lateinische Kleinbuchstaben enthalten. Dieses Raster veranschaulicht die Daten, die für jeden Tag angezeigt werden.

Example:

Sprachen und Fallbacks
Kartographer-Karten erhalten ihre Beschriftungen vom Open-Source-Mapping-Projekt OpenStreetMap (https://www.openstreetmap.org/). Standardmäßig versucht Kartographer, Kartenbeschriftungen in der Sprache des Wikis anzuzeigen, in dem die eingebettete Karte angezeigt wird. Wenn diese Sprache nicht verfügbar ist, verwendet die Karte die konfigurierte Fallback-Sprache des jeweiligen Wikis, dann die lokale Sprache in der Kartenregion, die in der Kartographer-Karte angegeben ist. Wenn keine davon verfügbar ist, zeigt Kartographer keine Beschriftung an.

Du kannst die Sprache angeben, die für Beschriftungen mit dem Attribut  verwendet werden soll, indem du ihren Wert auf den gewünschten Sprachcode festlegen. Beispiel:  zeigt Beschriftungen auf Japanisch an, falls verfügbar.

Um die lokale Sprache des Kartenbereichs zu verwenden, gebe  an. Für weitere Informationen zur Verwendung der lokalen Sprache in deinen Beschriftungen und zu mehrsprachigen OpenStreetMap-Daten im Allgemeinen lies diesen Beitrag. Kartographer-Karten beziehen ihre Daten - einschließlich Kartenbeschriftungsdaten in allen verfügbaren Sprachen - aus dem Open-Source-Mapping-Projekt $ 1. Wenn die Karte, die du anzeigen möchtest, keine Beschriftungen in der gewünschten Sprache enthält, kannst du jederzeit Beschriftungen in dieser Sprache hinzufügen, indem du sie selbst zu OpenStreetMap hinzufügst. Beachte, dass Länder- und Städtenamen aus Beschriftungsknoten in OpenStreetMap stammen, nicht aus den Daten, die an Grenzbeziehungen angehängt sind. Informationen zu den ersten Schritten findest du im OpenStreetMap Beginners' Guide und in best practices in naming conventions.

Simple
 { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] }, "properties": { "title": "Exploratorium", "description": "", "marker-symbol": "museum", "marker-size": "large", "marker-color": "0050d0" } }

Groups of automatic counters
 { "type": "FeatureCollection", "features": [ {     "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.41816520690917,         37.79097260220947        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.40786552429199,         37.799654055191525        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.40185737609865,         37.796262984039544        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.38743782043457,         37.80535070427755        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number", "marker-color": "302060" },     "geometry": { "type": "Point", "coordinates": [ -122.38005638122557,         37.795449103799726        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-letter", "marker-color": "208020" },     "geometry": { "type": "Point", "coordinates": [ -122.40941047668457,         37.81850557172186        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-letter", "marker-color": "208020" },     "geometry": { "type": "Point", "coordinates": [ -122.40357398986815,         37.81280993744834        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-letter", "marker-color": "208020" },     "geometry": { "type": "Point", "coordinates": [ -122.39842414855956,         37.8071138637568        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number-bar", "marker-color": "f01080" },     "geometry": { "type": "Point", "coordinates": [ -122.41181373596191,         37.78595317184089        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number-bar", "marker-color": "f01080" },     "geometry": { "type": "Point", "coordinates": [ -122.39542007446289,         37.787674400057654        ]      }    },    {      "type": "Feature", "properties": { "marker-symbol": "-number-bar", "marker-color": "f01080" },     "geometry": { "type": "Point", "coordinates": [ -122.38649368286131,         37.78401144262929        ]      }    }  ] }

Wikidata query
 { "type": "ExternalData", "service": "geoshape", "query": "SELECT ?id ?head (SAMPLE(?img) as ?img_) (min(?partyId) as ?party) (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill) (concat(, ?headLabel, ) as ?title) (concat(?stateLabel, '\\n', '') as ?description) WHERE { ?id wdt:P31 wd:Q35657 . ?id wdt:P6 ?head . ?head wdt:P102 ?party . BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId) SERVICE wikibase:label { bd:serviceParam wikibase:language 'en' . ?head rdfs:label ?headLabel . ?id rdfs:label ?stateLabel . } OPTIONAL { ?head wdt:P18 ?img . } ?link schema:about ?head . ?link schema:isPartOf  .} GROUP BY ?id ?head ?headLabel ?link ?stateLabel" }

Map data from Commons
 { "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" }

Mixed types
<mapframe text="Caderousse city wall" width="300" height="300" zoom="15" longitude="4.75600" latitude="44.10200"> [ {    "type": "ExternalData", "service": "geoshape", "ids": "Q13518258", "properties": { "stroke": "#ffb100", "stroke-width": 6, } },  {    "type": "Feature", "geometry": { "type": "Point", "coordinates": [4.75566, 44.104498] }, "properties": { "title": "Porte de Castellan" } },  {    "type": "Feature", "geometry": { "type": "Point", "coordinates": [4.75829, 44.10258] }, "properties": { "title": "Porte Léon Roche" } } ]

Mixed types with markers
<mapframe width="300" height="300" zoom="12" longitude="-73.965278" latitude="40.782222"> [ {    "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" }, {    "type": "ExternalData", "service": "geoshape", "ids": "Q160409", "properties": { "fill": "#07c63e", "title": "Central Park" } },  {    "type": "Feature", "properties": {"title": "Roosevelt Island", "marker-color": "f01080"}, "geometry": { "type": "Point", "coordinates": [ -73.94511222839355,       40.76734665426719      ]    }  } ]

Rendering options
Die folgende Tabelle zeigt, wie eine -Karte für die Anzeige auf einer Wikiseite formatiert werden kann. Die Tabelle enthält zwei Spalten: Die erste zeigt eine interaktive Karte über das -Tag und die zweite zeigt das Rendern eines Beispielbildes mit den gleichen Optionen.

Use the width value  in order to make the map take up the full width of the page. <mapframe width="full" height="200" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478"> <mapframe width="full" height="200" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478" frameless>

Gestaltung
<mapframe text="Interstate Highway I-696" width="300" height="300" longitude="-83.2297" latitude="42.4883" zoom="9"> { "type": "ExternalData", "service": "geoline", "ids": "Q2108", "properties": { "title": "Highway I-696", "description": "", "stroke": "#ffb100", "stroke-width": 8 } }

Siehe auch

 * Special:MyLanguage/Help:VisualEditor/Maps - How to add and edit maps with the visual editor
 * Kartographer mit OpenStreetMap verwenden
 * Maps project (2015-2017) - Dokumentation der Wikimedia Engineering Aktivitäten des Discovery Teams von 2015 bis 2017
 * Map improvements 2018 - Dokumentation der Wikimedia Engineering Aktivitäten des Collaboration Teams in 2018
 * Kartographer Entwicklerleitfaden
 * Nutzungsbedingungen für Karten
 * Nutzungsbedingungen für Karten