Wikivoyage:Mapshapes

Dieser Artikel enthält technische Hintergrundinformationen zum Modul Mapshapes. Er unterstützt die Vorlage {{Mapshapes}} zur Ausgabe eines Satzes von Kartenkonturen in einer dynamischen, mit Mapframe erzeugten Karte.

Benötigte Module

Wikidata utilities – Grundlegende Funktionen für den schnellen Zugriff auf Wikidata.
Mapshape utilities – Gemeinsam genutzte Funktionen für Kartenanwendungen.
Mapshape utilities/i18n – Zeichenketten für die Internationalisierung.

Verwendbarkeit

Unterstützte Skins: Alle, weil skin-unabhängig.

Eignung für andere Wikis: nur Wikivoyage.

Eignung für mobile Geräte: ja.

Aufruf

Das Modul wird von der Vorlage {{Mapshapes}} aufgerufen.

Funktionen

Die Verwendung des Moduls mit Beispielen kann man unter {{Mapshapes}} einsehen.

function ms.show( frame )

Vorgaben:
- frame
  - tabelle: Parametertabelle, die vom #invoke-Aufruf übergeben wird.
Zurückgelieferter Wert:
- string: <Maplink>-Quellcode mit gültigem geoJSON-Code.

Internationalisierung

Die Lokalisierung kann im Modul Mapshape utilities/i18n vorgenommen werden.

Anforderungen an Wikidata und OpenStreetMap (OSM) für die Darstellung von Linien des (öffentlichen) Nah- und Fernverkehrs

Voraussetzung für eine korrekte Darstellung einer oder mehrerer Kartenkonturen ist, dass eine korrekte Struktur von Wikidata- und OSM-Daten vorliegt. Dazu ist es notwendig:

Der Wurzel- oder Elterneintrag auf Wikidata eines Verkehrssystems muss Links zu seinen Bestandteilen, den Kindern, enthalten. Dazu werden die Eigenschaften P527, „besteht aus“, P2670, „enthält Elemente von“, oder P1535, „verwendet von“, verwendet. Beispiel: Q190271.

Jede einzelne Linie muss hierzu enthalten (z. B. Q1292805):
- Farbe (P462) und/oder die sRGB-Farbraumnummer (P465). Letztere wird bevorzugt.
- OpenStreetMap-Relations-ID (P402), die auf Daten in OSM verweist.

In den OSM-Daten muss ein Verweis auf eine Wikidata-Entität vorhanden sein. Dazu wird der wikidata-Key benutzt, z. B. 7772996.

Falls dies geschehen ist, wird die Vorlage alle Einzellinien der aus dem Wurzeleintrag auf Wikidata mit der korrekten Farbe zur Anzeige bringen. Problematisch sind gegenwärtig noch sog. Superrelationen auf OSM, die von der Mediawiki-Software noch nicht dargestellt werden können.

Anleitung

Während die Bearbeitung von Wikidata-Einträgen noch relativ einfach ist, kann sich die Bearbeitung von OSM-Daten insbesondere für Anfänger sehr aufwändig gestalten. Bitte nehmen Sie sich Zeit für die Einarbeitung und zerstören Sie bitte nicht die Datenbank.

In dieser Anleitung wird gezeigt, was getan werden muss, um ein Verkehrssystem am Beispiel von Nürnberg von Grund auf einzurichten. Voraussetzung ist, dass die nötigen Daten für die einzelnen Linien eines Verkehrsnetzes bereits in Wikidata vorhanden und auf OSM eine Relation für die entsprechende Linie angelegt wurde. Das kommt bereits recht häufig vor, so dass nur die Links für das gesamte Liniennetz hinzugefügt werden müssen.

Anfänglich bedeutet dies etwas Detektivarbeit, die sich aber immer wieder wiederholt.

Zuerst muss man einen Wikipedia-Artikel finden, der das Verkehrsnetz beschreibt. Das kann in der Wikipedia bzw. in Wikidata selbst oder mit Hilfe einer Suchmaschine geschehen. Auf Google kann man z. B. „$city metro wiki“ eintippen, wobei ist $city durch die entsprechende Stadt zu ersetzen ist. So gelangt man zum Wikipedia-Artikel U-Bahn Nürnberg. Der zugehörige Wikidata-Eintrag befindet sich auf der linken Seite von Wikipedia unter „Werkzeuge“ / Wikidata-Datenobjekt und führt zu Q697512.
Falls es die Eigenschaft besteht aus schon gibt, kann dieser Schritt übersprungen werden. Anderenfalls müssen Sie die Eigenschaft selbst anlegen und sie mit allen ihren Bestandteilen befüllen. Meist ist es am einfachsten, in den Wikipedia-Artikel zurückzukehren und von dort bzw. der entsprechenden Kategorie aus zu den Artikeln aller Bestandteile zu gehen, um die Wikidata-Einträge zu erhalten. Wenn es zu den einzelnen Bestandteilen keine Einzelartikel gibt, muss die Suche auf Wikidata erfolgen. Nun sammelt man alle Wikidata-Einträge (z. B. Q3433210 für die U1 und alle folgenden) und trägt sie in die Eigenschaft besteht aus nacheinander ein.
Trage die Wikidata-OSM-Links ein.

Wenn die Einträge in OSM noch fehlen, so muss man einige Tage warten, bis sie in Wikivoyage wirksam werden. Ansonsten sollten die Daten bereits nach einer Bearbeitung ohne Änderung (Null-Edit) verfügbar sein.

Leider ist das Auffinden von OSM-Relations nicht ganz einfach. Meist hilft auch hier eine Suchmaschine wie Google, in die man z. B. „OSM relation $city metro“ eingibt. Für einige Verkehrsverbünde und Städte gibt es auch Listen aller ÖV-Linien mit ihren Relations-IDs in PTNA.

Wartungskategorien

Category:Wartung:Karten – zeigt Fehler beim Parameteraufruf wie fehlende und falsch geschriebene Parameter an.
- Category:Mapshapes: Parameter 1 fehlt‎ – Die Angabe der Wikidata-ID des Elternelements ist zwingend erforderlich.
- Category:Mapshapes: Unbekannte Parameter‎ – Mapshapes wurde mit unbekannten Parametern aufgerufen.
Category:Seiten mit Skriptfehlern – enthält auch Seiten mit Wertefehlern einzelner Parameter, die zu fehlerhaften oder unterdrückten Kartendarstellungen führen.

Stilvorlagen

Stilvorlagen werden nicht benötigt.

JavaScript

(Zusätzliche) JavaScript-Skripte zur Unterstützung des Moduls kommen nicht zum Einsatz.

Weitere Beispiele

Siehe Vorlage {{Mapshapes}}.