Wikivoyage:PHP-Kartentools

Seit dem 02. Dezember 2012 stehen dynamische Karten auf Wikivoyage zur Verfügung, die vom Nutzer Mey2008 entwickelt wurden. Die serverseitigen PHP-Skripte wurden bis 2018 auf dem Server des Wikivoyage e. V. gehostet, zusätzlich noch auf dem Server der Wikimedia Foundation (WMF). Später wurden diese Skripte durch die WMF-eigene Entwicklung Kartographer ersetzt. Ein kleiner Teil der Skripte ist noch in Nutzung.

Im Folgenden gibt es eine unvollständige Notdokumentation. Vom ursprünglichen Autor wurde keine Dokumentation angelegt.

Noch genutzt Skripte

• geodata.php – Update der Liste der in der Nähe befindlichen Orte und deren Artikel. Die vom Tool erstellten JavaScript-Skripte wie de-articles.js werden von Kartographer.js verwendet.
• geomap.php – Koordinatenpicker, genutzt im vCard-Editor.

Nicht mehr genutzte Skripte

• artmap.php – Karte: Darstellung aller Artikel auf einer Weltkarte. Auf devoy durch Gadget-MapTools.js ersetzt.
• cleantracks.php – Entfernt GPX-Daten aus einer GPX-Datei.
• gpx2mapmask.php – Web-Tool: Konvertiert eine GPX-Datei in einen Mapmask-Aufruf.
• gpxmap.php – Karte: GPX-Download, Anzeige auf einer Weltkarte.
• mapmask2gpx.php – Web-Tool: Konvertiert einen Mapmask-Aufruf in eine GPX-Datei.
• monmap.php – Karte: Anzeige aller Marker.
• multipoi2gpx.php –
• poi2gpx.php – Auflistung der Points of Interest (POI) in einer GPX-Datei. Auf devoy durch Gadget-Poi2gpx.js ersetzt.
• poimap2.gpx – Kartendarstellung. Auf devoy vollständig durch {{Maplink}} und {{Mapframe}} bzw. Gadget-MapTools.js ersetzt.
• readpage.gpx – Sucht nach Markern und Listings/vCards in einer Seite. Wird von poi2gpx.php und anderen PHP-Skripten genutzt.

Hosting

• Server: https://wikivoyage.toolforge.org/
• Administratoren: Syced.
• Verzeichnisstruktur:

w/ – Wurzelverzeichnis mit den PHP-Skripten.

data/ – Von geodata.php erzeugte Listen für die Anzeige der Orte in der Umgebung.

ico24/ – Symbole für die Kartendarstellung.

lib/ – Leaflet-Bibliotheken und -Abbildungen.

locale/ – Zeichenketten für die Internationalisierung/Lokalisierung.

trans/ – Übersetzungen für die Marker-/Listing-/vCard-Typen.

geodata.php

Gemeldet in Phabricator (?)
Task T203313

Quelltext

• Quelltext von geodata.php

Beschreibung

Es ist möglich, dass Update manuell zu starten. Es ist immer noch dasselbe Skript (geodata.php), das seinerzeit von Mey2008 entwickelt wurde.

Als Basis dienen z. B. die Dumps auf dumps.wikimedia.org, die sich z. B. in der Datei dewikivoyage-latest-pages-articles.xml.bz2 (gegenwärtig etwa 50 MB) befinden. Diese Dateien werden zweimal monatlich aktualisiert (um den 1. und den 20. jeden Monats).

Es wird jeder einzelne Artikel im Quelltext-Modus geparst. Für einen Artikel werden zwei Dinge benötigt: ein Bild und die Koordinate im Artikel! Die Koordinate wird in devoy aus der Vorlage {{GeoData}} geholt, sonst aus der Vorlage Geo. Das Bild wird ebenfalls aus dem Quelltext geholt, und es muss zwingend die Erweiterung *.jpg haben. Wenn kein Bild vorhanden ist, wird das Bild WV-logo-artmap.jpg gewählt.

Da die Daten ausschließlich aus dem Quelltext geholt werden, müssen sie dort auch zwingend notiert werden. Daten, die automatisch aus Wikidata bezogen werden, werden nicht berücksichtigt!

Die Ergebnisdatei wird im Ordner w/data/ abgelegt.

Anmerkung

Nach dem 1. Dezember 2017 wird das Skript nicht mehr automatisch aufgerufen bzw. neu erstellte Dateien werden mit der Dateiversion vom 1. Dezember 2017 überschrieben.

Manueller Aufruf

https://wikivoyage.toolforge.org/w/geodata.php?group=de

• group – Sprache des Wikis

Beispieldatei

Es werden Dateien wie de-articles.js im Ordner w/data/ angelegt.

var addressPoints = [
[12.500,105.000,"Kambodscha","4/4b/AngkorWatSunrise.jpg"],
[9.117,7.500,"Abuja","7/7e/WV-logo-artmap.jpg"],
...
];

Jede Zeile enthält ein Array mit vier Angaben: Breite, Länge, Artikelname und Bildname bzw. -Ordner.

geomap.php

Quelltext

• Quelltext von geomap.php (HTML und JavaScript)

Beschreibung

Durch Suche auf einer Karte, unterstützt von OSM Nominatim können Koordinaten bestimmt und in verschiedenen Ausgabeformen bereitgestellt werden.

Aufruf

https://wikivoyage.toolforge.org/w/geomap.php?lang=...&page=...&location=...

• lang – Sprache des Wikis
• page – Lemma des Artikels
• location – Ortsangabe, meist Adresse

Zukünftige Weiterentwicklung

Im Rahmen des Community Wishlist Surveys 2019 wurde ein Geolocator für die Wikidata-Eigenschaft Koordinates vorgeschlagen. Der Vorschlag kam auf den 24. Platz, so dass seine Realisierung durchaus im Bereich des Möglichen ist. Dieses Werkzeug könnte auch ein geeignetes Werkzeug für Wikivoyage sein.

poi2gpx.php

Quelltext

• Quelltext von poi2gpx.php

Beschreibung

Gibt die Daten aller Marker und listings/vCards in eine GPX-Datei aus. Fügt je nach Wikisprache eine Datei GPX/Name oder Name/GPX an.

Aufruf

https://wikivoyage.toolforge.org/w/poi2gpx.php?print=gpx&lang=...&name=...

• lang – Sprache des Wikis
• name – Name des Artikels

multipoi2gpx.php

Quelltext

• Quelltext von multipoi2gpx.php

Beschreibung

Gibt die Daten aller Marker und listings/vCards in eine GPX-Datei aus.

Aufruf

https://wikivoyage.toolforge.org/w/multipoi2gpx.php?lang=...&name=...

• lang – Sprache des Wikis
• name – Datei mit einer Liste von Artikelnamen.

poimap2.php

Quelltext

• Quelltext von poimap2.php

Beschreibung

...

Aufruf

https://wikivoyage.toolforge.org/w/poimap2.php?lat=...&lon=...&zoom=...&layer=...&lang=...&name=...

• lat – geografische Breite
• lon – geografische Länge
• zoom – Zoomwert, 1–19
• layer – Art des Kartenlayers. Gültige Werte: default=M, gültig: M= Mapnik (OSM), W=Wikivoyage, N= Traffic line Network, O= Mapquest Open, A= Mapquest Aerial, P= Pois of Interest, L= Labels, H= Hiking, S= hill Shading, C= Cycling, D= Destinations.
• lang – Sprache des Wikis
• name – Name des Artikels

artmap.php

Quelltext

• Quelltext von artmap.php

Beschreibung

Das Werkzeug erstellt eine Karte, auf der die Wikivoyage-Artikel aus dem zugehörigen Wiki angezeigt werden.

Aufruf

https://wikivoyage.toolforge.org/w/artmap.php?lang=...

• lang – Sprache des Wikis

gpx2mapmask.php

Quelltext

• Quelltext von gpx2mapmask.php

Beschreibung

...

Aufruf

https://wikivoyage.toolforge.org/w/gpx2mapmask.php

• Keine Parameter, da Web-Tool.

gpxmap.php

Quelltext

• Quelltext von gpxmap.php

Beschreibung

...

Aufruf

...

mapmask2gpx.php

Quelltext

• Quelltext von mapmask2gpx.php

Beschreibung

...

Aufruf

https://wikivoyage.toolforge.org/w/mapmask2gpx.php

• Keine Parameter, da Web-Tool.

readpage.php

Quelltext

• Quelltext von readpage.php

Beschreibung

...

Aufruf

Keiner. Wird als Untermodul von anderen PHP-Skripten benutzt.