Wikivoyage

Wikivoyage:PHP-Kartentools

Index > Dokumentation > 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

Bearbeiten
  • 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

Bearbeiten
  • 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

Bearbeiten
  • 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

Bearbeiten
Gemeldet in Phabricator (?)
Task T203313

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

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

Bearbeiten

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

Bearbeiten 
https://wikivoyage.toolforge.org/w/geodata.php?group=de
  • group – Sprache des Wikis

Beispieldatei

Bearbeiten

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

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

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

Aufruf

Bearbeiten 
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

Bearbeiten

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

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

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

Bearbeiten 
https://wikivoyage.toolforge.org/w/poi2gpx.php?print=gpx&lang=...&name=...
  • lang – Sprache des Wikis
  • name – Name des Artikels

multipoi2gpx.php

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

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

Aufruf

Bearbeiten 
https://wikivoyage.toolforge.org/w/multipoi2gpx.php?lang=...&name=...
  • lang – Sprache des Wikis
  • name – Datei mit einer Liste von Artikelnamen.

poimap2.php

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

...

Aufruf

Bearbeiten 
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

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

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

Aufruf

Bearbeiten 
https://wikivoyage.toolforge.org/w/artmap.php?lang=...
  • lang – Sprache des Wikis

gpx2mapmask.php

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

...

Aufruf

Bearbeiten

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

  • Keine Parameter, da Web-Tool.

gpxmap.php

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

...

Aufruf

Bearbeiten

...

mapmask2gpx.php

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

...

Aufruf

Bearbeiten

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

  • Keine Parameter, da Web-Tool.

readpage.php

Bearbeiten

Quelltext

Bearbeiten

Beschreibung

Bearbeiten

...

Aufruf

Bearbeiten

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

Abgerufen von „https://de.wikivoyage.org/w/index.php?title=Wikivoyage:PHP-Kartentools&oldid=1531525“