Wikivoyage:PHP-Kartentools

Aus Wikivoyage
Index > Dokumentation > PHP-Kartentools
Zur Navigation springen Zur Suche springen

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 alle Artikel auf einer Weltkarte. Auf devoy durch 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 Poi2gpx.js ersetzt.
  • poimap2.gpx – Kartendarstellung. Auf devoy vollständig durch {{Maplink}} und {{Mapframe}} bzw. 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://tools.wmflabs.org/wikivoyage/
  • 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]

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://tools.wmflabs.org/wikivoyage/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://tools.wmflabs.org/wikivoyage/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://tools.wmflabs.org/wikivoyage/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://tools.wmflabs.org/wikivoyage/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://tools.wmflabs.org/wikivoyage/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://tools.wmflabs.org/wikivoyage/w/artmap.php?lang=...
  • lang – Sprache des Wikis

gpx2mapmask.php[Bearbeiten]

Quelltext[Bearbeiten]

Beschreibung[Bearbeiten]

...

Aufruf[Bearbeiten]

https://tools.wmflabs.org/wikivoyage/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://tools.wmflabs.org/wikivoyage/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.