Help:Extension:Kartographer/Getting started/de

Übersicht
Kartographer ist eine Erweiterung für MediaWiki, mit der du eingebettete Karten und Links zu Vollbildkarten auf Wiki-Seiten erstellen kannst, genauso einfach wie das Schreiben einer einzigen Zeile Wikitext oder das Klicken auf einen Menüpunkt im VisualEditor.

Diese Anleitung konzentriert sich auf Karten im Wikitext; für Hinweise zu Karten im VisualEditor siehe.

Some wikis wrap Kartographer's functionality in templates (often named  and  ). Check the Kartographer help page on your local wiki for commonly used templates.

Quick start: example


Dieser Code erzeugt eine einfache 250x250 Karte in einem Rahmen, wie die, die du in diesem Abschnitt siehst, mit der Beschriftung "Downtown San Francisco".

 Um eine Karte hinzuzufügen, die in einem kleinen Fenster (oder Rahmen) auf einer Wikiseite erscheint, verwenden Sie den Tag. Wenn du auf die kleine Karte klickst, öffnet sich eine interaktive Karte im Vollbildmodus.


 * Auf Wikipedia und anderen Wikimedia-Wikis ist die eingebettete Karte statisch. Durch Anklicken des statischen Bildes wird eine interaktive Karte im Vollbildmodus geöffnet.
 * Auf Wikivoyage und test2wiki ist diese eingebettete Karte interaktiv. Durch Klicken, Halten und Bewegen des Cursors lässt sich die Karte verschieben; ein Doppelklick oder ein Klick auf das Vollbild-Symbol in der oberen Ecke öffnet eine interaktive Karte im Vollbildmodus.

In seiner einfachsten Form verwendet  die folgenden Informationen, um eine Karte eines bestimmten Gebiets anzuzeigen:


 * einen Standort (Breitengrad und Längengrad)
 * die Größe des Rahmens (Breite und Höhe)

Example:

For a complete explanation of the syntax as well as a list of available attributes, see the main help page.

Instead of an interactive map on the wiki page itself, you can also create text (with an optional marker) that links to a fullscreen interactive map, using.

A minimal  tag is even shorter -- all you need is a location.

Example:

. You can choose the marker's exact location on the map, the symbol used, its color and size, a title, a descriptive image, and more -- including whether to use letters or numbers across multiple markers.

The example below is a good starting place; for a comprehensive list of attributes and options, see the auto-counters section of the main help page.

 {     "type": "Feature", "properties": { "marker-symbol": "town-hall", "marker-color": "46ea5f", "marker-size": "medium", "title": "Colorado State Capitol", "description": ""}, "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] } }

Shapes
GeoJSON allows you to draw shapes on top of a map. You can define simple shapes inline or import shape data from places like Wikidata and OpenStreetMap.

Though we include some illustrative examples below, much of this work is most easily done in a GeoJSON editor. If your wiki has VisualEditor enabled, refer to our guide to using VisualEditor to create maps or use this editor.

Inline
Using GeoJSON, Kartographer lets you define points (markers), lines and polygons to be drawn over your defined map area using special syntax and longitude/latitude coordinates.

 { "type": "FeatureCollection", "features": [ {     "type": "Feature", "properties": {}, "geometry": { "type": "LineString", "coordinates": [ [           -122.321777,            47.598526          ],          [            -122.629395,            45.505662          ]        ]      }    }  ] }

For more information, consult the Inline section of the main help page.

External data
In addition to displaying and marking up maps, Kartographer can also draw on the vast resources of geodata that Wikidata and OpenStreetMap have to offer. That data can help you highlight areas of your map using geoshapes, geographical data that describes the physical properties of an area.

Geoshapes can be rendered in three different ways, using the  attribute:


 * : Draws a simple line.
 * : Draws a polygon with a shaded interior.
 * : Draws a polygon and shades everything outside the polygon.

 { "type": "ExternalData", "service": "geoshape", "ids": "Q1019" }

A simple example: In addition to placing a single geoshape on your map, you can also use SPARQL queries to bring in several related geoshapes from Wikidata. (For help writing SPARQL, take a look at Wikidata's Query Builder.)

For more information, see the External data section of the main help page.

Further resources
The world of Kartographer maps and geographical data is large, and even our main help page can't cover every aspect of it. Consult this list of resources for more information.


 * Kartographer's main help page
 * Using Kartographer with OpenStreetMap
 * Adding and editing maps in VisualEditor
 * GeoJSON resource list