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.

For a less technical quick start, check out Getting started. For help with Kartographer in the VisualEditor, check out Help:VisualEditor/Maps. For help with Kartographer and OpenStreetMaps, check out Help:Extension:Kartographer/OSM.

Basic map syntax
To place a map or a map link directly on a wiki page, Kartographer offers two tags:, which embeds a map inline that links to a full-screen interactive map, and  , which creates rich text (with an optional marker) that links to a full-screen interactive map.

Some wikis wrap these tags in templates, such as Mapbox and Mapframe. Consult your local wiki's Kartographer help page to see if your wiki has templates -- or use the tags directly with this document as your guide.



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

Self-closing tags
When not using GeoJSON, you can use  and   as self-closing, standalone tags.

Self-closing:

Enclosing 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
Multiple markers on a map can be grouped and named using patterns and counters. Below is a summary of styling attributes for items placed on a map using GeoJSON. For more information, see the simplestyle spec.

For a rich variety of examples, see the Examples section.

Shapes
GeoJSON allows you to add lines and geometric areas as annotations to your map. You can define simple inline shapes or import them from external databases.

Inline
GeoJSON allows you to draw points (markers), simple lines and geometric areas as part of your map definition. The following examples include the "geometry" attribute of GeoJSON objects inside a object. Consult the full GeoJSON specification for more information.

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

GeoJSON allows you to obtain outlines of geographical objects from external sources using the "type" attribute with the value "ExternalData".

Maps can draw from well-known geographical objects in the OpenStreetMap database by using their Wikidata ID; they can also come from Wikidata SPARQL queries or from shapes in Wikimedia Commons (.map files).

Additionally, maps can link directly to raw GeoJSON stored on Wikimedia Commons: see for 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" } Instead of a Wikidata Item ID, a map can also derive geoshapes from a Wikidata query in SPARQL. (You can create SPARQL queries using the Query Builder.)

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
You can combine ExternalData, Feature, and FeatureCollection objects together in the same or  element, for example to highlight features with titles and descriptions on top of externally sourced objects.

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

In addition to the marker styling above, lines and areas support these simplestyle properties:

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 und -Tags zu teilen.

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

Auf Wikivoyage jedoch, wenn ein -Tag das -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-Optionen
The following table shows how a map can be formatted for display on a wiki page. The table contains two columns: the first shows an interactive map via the tag, and the second shows the rendering of an example image with the same options.

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

 * 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