Hilfe:Erweiterung:Kartographer

From mediawiki.org
This page is a translated version of the page Help:Extension:Kartographer and the translation is 100% complete.
Outdated translations are marked like this.
PD Hinweis: Wenn Du diese Seite bearbeitest, stimmst Du zu, dass Dein Beitrag unter der [CC0] veröffentlicht wird. Mehr Informationen findest du auf der Public Domain Hilfeseite. PD

Haupthilfeseiten:

Die Kartographer -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 ‎<mapframe>, der Karten direkt in Wikiseiten einbettet, und ‎<maplink>, 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.

Hilfe zu Kartographer und OpenStreetMaps findest du unter Hilfe:Erweiterung:Kartographer/OSM .

Wie man Kartographer benutzt

Seiten finden, die Kartographer verwenden

Um Seiten zu finden, die Kartographer-Karten enthalten, kannst du nach insource:mapframe suchen.

Artikel in der Nähe anzeigen

Screenshot einer Karte in Vollbildansicht. Unterhalb des Karteninhalts befindet sich eine Schaltfläche mit der Aufschrift "Artikel in der Nähe anzeigen".
Die Schaltfläche "Artikel in der Nähe anzeigen" in der Kartenansicht in voller Größe
Screenshot einer Karte in Vollbildansicht. Es gibt einige runde Marker in Grau und einige Marker in Rot. Ein runder Marker zeigt ein Popup mit einem Titel, einer Beschreibung und einem Bild.
Artikel in der Nähe und manuell hinzugefügte rote Markierungen auf einer Kartographer-Karte

Im Vollbildmodus kannst du auf die Schaltfläche „Artikel in der Nähe anzeigen“ klicken, um bis zu 300 geografisch nahe gelegene Artikel als Markierungen auf der Karte zu sehen. Mehrere Pins an der gleichen Stelle werden beim Herauszoomen in Gruppen zusammengefasst und beim Heranzoomen wieder getrennt.

Sobald du die Karte mit der Maus bewegst oder ein- und auszoomst, erscheint eine Schaltfläche „Ergebnisse neu laden“, um weitere Artikel in der Nähe anzuzeigen.

Die Artikel in der Nähe werden aus dem Wiki generiert, in dem du dich gerade befindest, wobei Relevanz und Nähe berücksichtigt werden. Die Markierungen für nahe gelegene Artikel sind rund. Sie werden zusätzlich zu den manuell hinzugefügten Markierungen angezeigt, die eine andere Form haben.

Wenn du auf die Markierung eines Artikels in der Nähe klickst, zeigt ein Pop-up den Titel, eine kurze Beschreibung und ein Bild des Artikels an. Klicke auf den Titel, um zu dem Artikel zu gelangen. Wenn der Artikel mit einem Eintrag auf Wikidata verlinkt ist, zeigt das Pop-up eine kurze Beschreibung aus Wikidata an. Um die Artikel in der Nähe auf der Karte auszublenden, klicke erneut auf die Schaltfläche „Artikel in der Nähe anzeigen“.

Projektseite (Englisch)

Wie man mit Kartographer Karten erstellt

Grundlegende Kartensyntax

Zur Platzierung einer Karte oder eines Kartenlinks direkt auf einer Wiki-Seite bietet Kartographer zwei Tags an: ‎<mapframe>, die eine Karte inline einbetten, die auf eine interaktive Karte im Vollbildmodus verlinkt, und ‎<maplink>, 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. Konsultiere die Kartographer-Hilfeseite deines lokalen Wikis, um herauszufinden, ob dein Wiki über Vorlagen verfügt -- oder verwende die Tags direkt mit diesem Dokument als Leitfaden.


‎<mapframe>

Map
San Francisco museums

Der ‎<mapframe>-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.

<mapframe text="San Francisco museums" width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013" />


‎<maplink>

Das ‎<maplink>-Tag erzeugt einen Link zu einer Karte im Vollbildmodus.

<maplink zoom="13" latitude="46.204391" longitude="6.143158"/>

46°12′16″N 6°8′35″O

Seine Eigenschaften und seine Verwendung sind im Wesentlichen identisch mit ‎<mapframe>; siehe unten für kleinere Unterschiede.

Attribute

Nachfolgend findest du eine Liste von Attributen für ‎<mapframe> und ‎<maplink>.

Streng genommen sind die einzigen Attribute, die erforderlich sind (in der Tabelle mit einem * gekennzeichnet), Breite und Höhe; ohne Angabe eines Ortes erzeugt Kartographer eine vergrößerte Weltkarte in der angegebenen Größe auf der Seite.

Wenn kein Zoom angegeben wird, wendet Kartographer eine automatische Zoomstufe an, die auf der Position von Markierungen oder Geometrien in der Karte basiert.

Verwendung in jedem Tag:

  • attribute="value"
Attribute Wert Beschreibung Beispiel
width* Pixel, "voll" Die Breite des Kartenausschnitts. "100%" also works as an alias for "full", but no other percentage. width=200, width="full"
height* Pixel Die Höhe des Kartenausschnitts. height=300
zoom 0-19 Der Detailgrad der Karte. Zoomstufe 0 zeigt die gesamte verfügbare Karte an, und Zoomstufe 19 zeigt den höchsten Detailgrad. Wenn kein Zoom-Level angegeben wird, wendet Kartographer einen automatischen Zoom-Level an, der auf der Position der vorhandenen Markierungen oder Geoformen basiert. zoom=12
latitude, longitude Dezimalgrade Die Position auf der Erde. Detaillierte Informationen findest du in diesem Artikel des GIS-Wikis. Wenn nicht angegeben, versucht Kartographer, den Mittelpunkt aus dem Inhalt eines Artikels abzuleiten. latitude=46.204391 longitude=6.143158
align "left", "center", "right" Die horizontale Position des Kartenausschnitts auf der Seite. Die Standardeinstellung dieses Wertes wird durch die Richtungsabhängigkeit der Seitensprache definiert (RTL: "links"; LTR: "rechts"). Bei einem Wert von "links" oder "rechts" fließen andere Wiki-Inhalte um die Karte herum (siehe den entsprechenden Abschnitt von Hilfe:Bilder ). align="right"
lang Sprachcode, "local" Die Sprache, die für Kartenbeschriftungen und Markierungen verwendet werden soll. Bei "lokal" wird die Sprache des Gebiets verwendet, das auf der Karte angezeigt wird. Hinweis: Nicht alle Beschriftungen sind in jeder Sprache verfügbar. Siehe auch #Languages_and_fallbacks. lang="es"
text wikitext
<mapframe>
Beschriftung unterhalb des Kartenrahmens. Bewirkt, dass das Attribut frameless ignoriert wird, wenn es angegeben ist.
<maplink>
Definiert den Text des Links, der, wenn er angeklickt wird, die Karte bildschirmfüllend anzeigt ($1|Beispiel). Wenn kein benutzerdefinierter Text angegeben wird, wird der Linktext als Koordinaten des Kartenmittelpunkts angezeigt, z.B. 12°18′0″N 45°36′0″O.
text="Map of New York marking the location of the Empire State Building"
frameless ignored
Nur ‎<mapframe>
Bewirkt, dass die eingebettete Karte ohne Rahmen gezeichnet wird, ähnlich wie bei Rahmenlosen Bildern. Wird ignoriert, wenn das Attribut text gesetzt ist, das das Zeichnen eines Rahmens erzwingt. Das Attribut ist für die Verwendung ohne Wert gedacht. Jeder Wert wird ignoriert. Beachte vor allem, dass frameless="0" nicht wie erwartet funktionieren wird. Stattdessen musst du das Attribut löschen.
frameless
class "no-icon"
Nur ‎<maplink>: Entfernt das Markierungssymbol, das normalerweise vor dem Linktext angezeigt wird, z. B. <maplink zoom="5" latitude="12.3" longitude="45.6" class="no-icon"/>.
class="no-icon"
* = required

Selbstschließende Tags

Wenn du kein GeoJSON verwendest, kannst du ‎<mapframe> und ‎<maplink> als selbstschließende, eigenständige Tags verwenden.

Selbstschließend:

<mapframe width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013" />

Eingeschlossenes GeoJSON:

<mapframe width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013">
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
}
</mapframe>


GeoJSON

Map
Several groups of automatic counters

Die Tags ‎<mapframe> und ‎<maplink> 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.

Die folgenden Beispiele verwenden das maplink-Tag. Wie bereits erwähnt, kann GeoJSON, das für maplink verwendet wird, ohne Änderung für mapframe verwendet werden.

Markierungen

Komplexe Karte - Markierung, Artikellink und Bild

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.

<maplink text="Colorado State Capitol with marker icon" longitude="-104.98491" latitude="39.73939" zoom="17">
{
    "type": "Feature", "properties": 
        { 
            "marker-symbol": "town-hall", 
            "marker-color": "46ea5f", 
            "marker-size": "medium"
        }, 
    "geometry": 
        { 
            "type": "Point",
            "coordinates": [-104.98485267162323, 39.73928364167763] 
        }
}
</maplink>

Ergebnis: Colorado State Capitol with marker icon

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.

Attribut Wert Beschreibung Beispiel
marker-symbol Icon-Name, "‑number", "‑letter" Legt fest, ob die inkrementellen Markierungen nach Zahlen (1, 2, 3...) oder Buchstaben (A, B, C...) erfolgen.

Automatische „-Zahlen“-Serien gehen von 1-99 und Buchstaben von A-Z. Wenn ein Gruppenname wie „-number-eat“ inkludiert wird, werden mehrere Serien erzeugt.
Ein Icon-Name muss aus dieser Liste sein.

"marker-symbol": "museum"
marker-color hexadecimal color Ein drei- oder sechsstelliger hexadezimaler Farbwert für jede Markierung. "marker-color": "#228b22"
marker-size small, medium, large Siehe Beispiele für jede Größe. "marker-size": "medium"
title wikitext Wenn eine Markierung angeklickt wird, wird der im Wert "Titel" angegebene Wikitext angezeigt. "title": "[[:en:Downtown_Aquarium,_Denver|Downtown Aquarium Denver]]"

description wikitext Wenn eine Markierung angeklickt wird, wird ein Wikitext oder ein in Wikitext angegebenes Bild im Wert "Beschreibung" angezeigt. "description": "[[File:Denver-DTA.jpg|150x150px]]"

Eine Vielzahl von Beispielen findest du im Abschnitt Beispiele.

Formen, Linien und Punkte

Mit GeoJSON kannst du Linien, geometrische Flächen und Punkte als Anmerkungen zu deiner Karte hinzufügen. Du kannst sie inline 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 Feature-Objekts. Weitere Informationen findest du in der vollständigen GeoJSON Spezifikation.

Objekt Koordinaten (Länge/Breite) Kartenelement GeoJSON-Beispiel Auswirkung
Point Einzelposition Marker
"geometry": {
"type": "Point",
"coordinates":
 [-122.629395, 45.505662]
}
LineString zwei oder mehr Positionen Linie, die zwei Punkte verbindet
"geometry": {
"type": "LineString",
"coordinates":
[
 [-122.321777, 47.598526],
 [-122.629395, 45.505662]
]}
Polygon vier oder mehr Positionen, erste und letzte identisch Polygon mit schattiertem Innenraum
"geometry": {
"type": "Polygon",
"coordinates": [
[
  [-122.365723, 48.209576],
  [-123.947754, 46.949528],
  [-122.695313, 44.776709],
  [-120.629883, 46.573148],
  [-122.365723, 48.209576]
]]}
Objekt Koordinaten (Länge/Breite) Kartenelement
MultiPoint mehrere Positionen mehrere Punkte (Markierungen)
MultiLineString mehrere Gruppen von LineString-Positionen mehrere Zeilen
MultiPolygon mehrere Gruppen von Polygon-Positionen mehrere Polygone

Externe Daten

Map
A geoshape of Alaska

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

Karten können auf bekannte geografische Objekte zurückgreifen, indem sie deren Wikidata-ID verwenden (auch über Wikidata SPARQL-Abfragen). Die Quelle für externe Polygone und Linien ist die OpenStreetMap-Datenbank, und die Koordinaten der Marker werden direkt von Wikidata abgerufen.

Außerdem können Karten direkt mit rohen GeoJSON-Dateien auf Wikimedia Commons (.map-Dateien) verlinkt werden: siehe Hilfe:Kartendaten für Details.

Objekte können mit Daten aus einer externen Quelle auf diese verschiedenen Arten gerendert werden:

  • "service": "geopoint" - Zeichnet eine Markierung.
  • "service": "geoline" - Zeichnet eine einfache Linie.
  • "service": "geoshape" - Zeichnet ein Polygon mit einem schattierten Innenraum.
  • "service": "geomask" - Zeichnet ein Polygon und schattiert alles außerhalb des Polygons.
  • "service": "page" - Pfad zu einer .map-Datei auf Wikimedia Commons, die gültiges GeoJSON enthält.
Externe Daten können nicht versioniert werden.
Via Wikidata-ID
Attribut Wert
type ExternalData
service geopoint, geoline, geoshape, or geomask
ids One or more Wikidata IDs, separated by commas

Polygone und Linien in der OpenStreetMap (OSM)-Datenbank werden mit Wikidata-IDs verknüpft. 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 bei https://www.openstreetmap.org/ hinzufügen - achte darauf, den wikidata Tag und den entsprechenden QID Wert hinzuzufügen. Ein Polygon oder eine Linie ist normalerweise innerhalb von zwei Tagen für Kartographer verfügbar. Ausführliche Informationen findest du unter Hilfe:Erweiterung:Kartographer/OSM .

Die Markierung wird gezeichnet, wenn der verlinkte Wikidata-Eintrag die Koordinatenangabe P625 hat.

Map
Combined map of Salzburg and Elixhausen
Map
Geopoints using QIDs Q667450 and Q15958518
<mapframe height="300" width="300" text="Combined map of Salzburg and Elixhausen">
{
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q34713,Q701153"
}
</mapframe>
<mapframe text="Geopoints using QIDs [[wikidata:Q667450|Q667450]] and [[wikidata:Q15958518|Q15958518]]" latitude="43.74" longitude="7.43" zoom="13" width="400" height="400">
{
  "type": "ExternalData",
  "service": "geopoint",
  "ids": "Q667450, Q15958518"
}
</mapframe>


Via Wikidata-Abfrage
Map
Governors of US states with their party affiliation. (query builder)
Map
Public art in Hoogvliet, Rotterdam. (query builder)

Anstelle einer Wikidata Item ID kann eine Karte auch Daten von einer Wikidata-Abfrage in SPARQL ableiten. (Du kannst SPARQL-Abfragen mit dem Query Builder erstellen).

Attribut Wert
type ExternalData
service geopoint, geoline, geoshape, or geomask
query a Wikidata SPARQL query
Variablennamen zur Verwendung im Wikidata Query Service
Variable Erlaubt bei Anmerkung
?id geopoint, geoline, geoshape, or geomask Required
?title geopoint, geoline, geoshape, or geomask Gives a heading on a popup. Accepts wikitext.
?description geopoint, geoline, geoshape, or geomask Further text on a popup. Accepts wikitext.
?geo geopoint Should be coordinates.
Marker variables behaves like described in auto-counters.
?marker_symbol geopoint
?marker_size geopoint
?marker_color geopoint
Fill and stroke variables behaves like described in styling shapes.
?fill geoshape, or geomask
?fill_opacity geoshape, or geomask
?stroke geoline, geoshape, or geomask
?stroke_opacity geoline, geoshape, or geomask
?stroke_width geoline, geoshape, or geomask
If you want to the popups to contain images or links to the respective articles, you can retrieve these information and add them to title or description fields. See following examples for details.
<mapframe longitude="-110" latitude="52" zoom="3" width="400" height="300" text="Governors of US states with their party affiliation">
{
  "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('[[w:', substr(str(?link),31,400),  '{{!}}', ?headLabel, ']]') as ?title) (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 400), '{{!}}200px]]') 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 <https://en.wikipedia.org/> .} GROUP BY ?id ?head ?headLabel ?link ?stateLabel"
}
</mapframe>
<mapframe text="Public art in Hoogvliet, Rotterdam" latitude="51.86" longitude="4.36" zoom="13" width="400" height="400">
{
  "type": "ExternalData",
  "service": "geopoint",
  "query": "SELECT DISTINCT ?id ?geo (?idLabel as ?title) (if(BOUND(?image), concat(?typeLabel, '\\n', '[[File:', substr(str(?image), 52, 400), '{{!}}200px]]'), ?typeLabel) as ?description) (if(?type = wd:Q860861, '#800000', if(?type = wd:Q245117, '#000080', '#008000')) as ?marker_color) WHERE { ?id wdt:P136 wd:Q557141; wdt:P625 ?geo; wdt:P276* wd:Q2103147; wdt:P31 ?type. OPTIONAL {?id wdt:P18 ?image}. SERVICE wikibase:label { bd:serviceParam wikibase:language 'en, nl'. ?id rdfs:label ?idLabel. ?type rdfs:label ?typeLabel} .} ORDER BY ?id"
}
</mapframe>


Kartendaten von Commons
Map

In GeoJSON gespeicherte Kartendaten, die auf Commons gespeichert sind, können in die Karte eingezeichnet werden.

Attribut Wert
type ExternalData
service page
title Pfad zu einer .map-Datei auf Wikimedia Commons, die gültiges GeoJSON enthält.

Beispiel: Nachbarschaften/New_York_City.map wird aus dieser Karte gezogen.

Weitere Informationen: Hilfe:Kartendaten
<mapframe width="300" height="400">
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>
Achtung! Achtung: The map loader does not currently support chained ExternalData calls. If a resource of type ExternalData is fetched that itself relies on ExternalData references, loading will fail. See task T155927 and task T193458.
Achtung! Achtung: Die Länge der Dateinamen von .map-Dateien ist auf 400 Zeichen und eine Dateigröße von 2MiB begrenzt. Beachte dies bei der Erstellung von Dateien für diesen Zweck in Wikimedia Commons.


Maskenebene
Map
Map of Salzburg with mask

Eine Maske ist eine Form, bei der die Schattierung umgekehrt ist: Die Form selbst ist ohne Schattierung und die Fläche drumherum ist schattiert.

<mapframe align="right" height="420" width="420" latitude="47.7992" longitude="13.0482" zoom="11"  text="Map of Salzburg with mask">
{
  "type": "ExternalData",
  "service": "geomask",
  "ids": "Q34713",
  "properties": {
    "fill": "#555555",
    "fill-opacity": 0.5,
    "stroke": "#000000",
    "stroke-width": 1,
    "stroke-opacity": 1
  }
}
</mapframe>
Mehrere Datentypen kombinieren

Du kannst ExternalData, Feature und FeatureCollection Objekte in demselben ‎<mapframe> oder ‎<maplink> 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

Map
Interstate Highway I-696

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

Attribute Wert Beschreibung
stroke hexadecimal color Die Farbe der Linie oder des Umrisses.
stroke-width Pixel Die Dicke der Formlinie.
stroke-opacity 0.0-1.0 Bestimmt die Transparenz der Formlinie. Bei einer Einstellung von 1 wird eine durchgehende Linie gezeichnet; 0 ist unsichtbar; bei größeren Werten (annähernd 1) ist weniger vom Hintergrund durch die Linie zu sehen.
fill hexadecimal color Die Farbe, die zum Ausfüllen der Form verwendet wird.
fill-opacity 0.0-1.0 Bestimmt die Transparenz des Füllbereichs. Bei einer Einstellung von 1 wird ein undurchsichtiger Bereich innerhalb der Form gezeichnet; 0 ist unsichtbar; bei größeren Werten (annähernd 1) wird weniger vom Hintergrund durch den Füllbereich sichtbar.


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
Map
<mapframe width="500" height="270" longitude="79.030" latitude="-24.794" zoom="8" align="center">
{
"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]
 ]
 }
 }
 ]
}
</mapframe>

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:

Map

GeoJSON resources

Reference
Guides
Editors and tools

Gruppen für Wikivoyage

Die Gruppierfunktion ist nur im Projekt Wikivoyage verfügbar.

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 ‎<maplink>-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.

Aber auf Wikivoyage, 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 eingefügt. Tags mit demselben Gruppennamen werden auf einer einzigen Karte angezeigt; jedes Tag fügt der Gruppe schrittweise Daten hinzu.

Jedes ‎<mapframe>-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 show="..." angibt. Es können mehrere Gruppennamen angegeben werden, die durch ein Komma getrennt werden müssen. Ein Gruppenname darf nur lateinische Kleinbuchstaben enthalten. Dieses Raster veranschaulicht die Daten, die für jeden Tag angezeigt werden.

Example:

<maplink>                               -- shows 1
<maplink group='food'>                  -- shows   2   4       8   10
<maplink group='bar'  show='bar'>       -- shows     3           9
<maplink group='food' show='bar'>       -- shows   2 3 4       8 9 10
<maplink              show='bar'>       -- shows     3   5       9
<maplink              show='food,bar'>  -- shows   2 3 4   6   8 9 10
<mapframe>                              -- shows             7
<mapframe group='food'>                 -- shows   2   4       8   10
<mapframe group='bar'  show='bar'>      -- shows     3           9
<mapframe group='food' show='bar'>      -- shows   2 3 4       8 9 10
<mapframe              show='bar'>      -- shows     3           9    11
<mapframe              show='food,bar'> -- shows   2 3 4       8 9 10    12
Wikivoyage pages also sometimes wrap the ‎<mapframe> and ‎<maplink> tags in templates. Consult Mapshape, Listing and See for a good starting place.

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 und 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 lang verwendet werden soll, indem du ihren Wert auf den gewünschten Sprachcode festlegen. Beispiel: lang="ja" zeigt Beschriftungen auf Japanisch an, falls verfügbar.

Um die lokale Sprache des Kartenbereichs zu verwenden, gib lang=local 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 OpenStreetMap. 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.

Beispiele

Einfach

Map
San Francisco museums
<mapframe text="San Francisco museums" width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013">
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
  "properties": {
    "title": "[[w:Exploratorium|Exploratorium]]",
    "description": "[[File:Giant_Mirror_at_the_Exploratorium.jpeg|200px]]",
    "marker-symbol": "museum",
    "marker-size": "large",
    "marker-color": "0050d0"
  }
}
</mapframe>


Markierungen und Zähler

Colorado State Capitol with a town hall marker, article link and image

<maplink text="Colorado State Capitol with a town hall marker, article link and image" longitude="-104.98491" latitude="39.73939" zoom="17">
{
      "type": "Feature",
      "properties": { "marker-symbol": "town-hall", "marker-color": "46ea5f", "marker-size": "medium", "title": "[[w:Colorado_State_Capitol|Colorado State Capitol]]", "description": "[[File:Coloradocapitolhill2.JPG|150px]]"},
      "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }
}
</maplink>


Nummerierte Markierungen

Colorado State Capitol with a number marker

<maplink text="Colorado State Capitol with a number marker" longitude="-104.98491" latitude="39.73939" zoom="17">{ "type": "Feature", "properties": {  "marker-color": "228b22", "marker-symbol": "-number"}, "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }}</maplink>


Buchstaben-Markierungen

Colorado State Capitol with a letter marker

<maplink text="Colorado State Capitol with a letter marker" longitude="-104.98491" latitude="39.73939" zoom="17">{ "type": "Feature", "properties": {  "marker-color": "508e33", "marker-symbol": "-letter"}, "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }}</maplink>


Mehrere Markierungen in einer Funktionssammlung

Denver Amusements

<maplink text="Denver Amusements" longitude="-105.01247406005858" latitude="39.74956567318853" zoom="14"> {"type": "FeatureCollection", "features":  [{ "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.00768899917603, 39.74859230437501] }, "properties": { "title": "[[w:Pepsi_Center|Pepsi Center]]", "marker-color": "420617", "marker-symbol": "-letter-see", "marker-size":"small"} }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01238822937012, 39.7526011757416] }, "properties": { "title": "[[w:Downtown_Aquarium%2C_Denver|Downtown Aquarium Denver]]", "marker-color": "508e33", "marker-symbol": "-letter-see","marker-size":"medium", "description": "[[File:Denver-DTA.jpg|150px]]" } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01247406005858, 39.74956567318853] }, "properties": { "title": "[[w:Confluence_Park|Confluence Park]]", "marker-color": "0d2751", "marker-symbol": "-letter-see", "marker-size":"large" } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01646518707275, 39.74656303364532] }, "properties": { "title": "South Platte Bike Trail", "marker-color": "61b9e2", "marker-symbol": "-number-see", "marker-size":"medium" } },]}</maplink>


Gruppen von automatischen Zählern
Map
Several groups of automatic counters
<mapframe text="Several groups of automatic counters" width="350" height="350" zoom="13" longitude="-122.39902496337889" latitude="37.80151060070086">
{
  "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
        ]
      }
    }
  ]
}
</mapframe>


ExternalData

Wikidata QID

State of Colorado, outlined

<maplink text="State of Colorado, outlined" zoom="7" > { "type": "ExternalData", "service": "geoshape", "ids": "Q1261" } </maplink>


Wikidata Abfrage
Map
Governors of US states with their party affiliation
<mapframe longitude="-110" latitude="52" zoom="3" width="500" height="500" text="Governors of US states with their party affiliation">
{
  "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('[[w:', substr(str(?link),31,500),  '{{!}}', ?headLabel, ']]') as ?title) (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 500), '{{!}}200px]]') 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 <https://en.wikipedia.org/> .} GROUP BY ?id ?head ?headLabel ?link ?stateLabel"
}
</mapframe>


Kartendaten von Commons
Map
<mapframe width="300" height="400">
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>


Gemischte Typen
Map
Caderousse city wall
<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"
    }
  }
]
</mapframe>


Gemischte Typen mit Markierungen
Map
<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
      ]
    }
  }
]
</mapframe>


Mixed types with SPARQL query
Map
Manual railway and queried
<mapframe width="300" height="300" text="Manual railway and queried stations">
[
{
"type": "ExternalData",
  "service": "geopoint",
  "properties": {
        "marker-symbol": "rail",
        "marker-color": "302060" },
  "query": "SELECT ?id ?geo ?idLabel (?idLabel as ?title)  WHERE { ?id wdt:P81 wd:Q1760190 ; wdt:P31 wd:Q2175765; wdt:P625 ?geo . SERVICE wikibase:label { bd:serviceParam wikibase:language 'sv'. } }"
},
{
  "type": "ExternalData",
  "service": "geoline",
  "properties": {
    "stroke": "#AA0000",
    "stroke-width": 3
  },
  "ids": "Q119890957, Q119891049"
}
]
</mapframe>



Rendering-Optionen

Die folgende Tabelle zeigt, wie eine ‎<mapframe>-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 ‎<mapframe>-Tag und die zweite zeigt das Rendern eines Beispielbildes mit den gleichen Optionen.

Optionen Rendern eines ‎<mapframe> Ein Bild rendern
  • Format: frame
  • Alignment: undefined
... text text text
Map
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: none
Not supported: see task T157502. ... text text text
text text text ...
  • Format: frame
  • Alignment: left
... text text text
Map
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: center
... text text text
Map
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: right
... text text text
Map
text text text ...
... text text text
text text text ...
  • Format: frameless
  • Alignment: undefined
... text text text Map text text text ...

Inconsistent, see task T157640.
... text text text text text text ...
  • Format: frameless
  • Alignment: none
Not supported: see task T157502. ... text text text
text text text ...
  • Format: frameless
  • Alignment: left
... text text text Map text text text ... ... text text text
text text text ...
  • Format: frameless
  • Alignment: center
... text text text Map text text text ... ... text text text
text text text ...
  • Format: frameless
  • Alignment: right
... text text text Map text text text ... ... text text text
text text text ...

Verwenden Sie den Breitenwert voll, damit die Karte die gesamte Breite der Seite einnimmt.

<mapframe width="full" height="200" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478"></mapframe>
Map
<mapframe width="full" height="200" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478" frameless></mapframe>

Map

Gestaltung

Map
Interstate Highway I-696
<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": "[[File:I-696 near M-10 in 1988.jpg|200px]]",
    "stroke": "#ffb100",
    "stroke-width": 8
  }
}
</mapframe>


Siehe auch