Wikivoyage:PHP-Kartentools – Reiseführer auf Wikivoyage
Zum Inhalt springen
Aus Wikivoyage
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:
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
Quelltext von geodata.php
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
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
Quelltext von geomap.php
(HTML und JavaScript)
Beschreibung
Bearbeiten
Durch Suche auf einer Karte, unterstützt von
OSM Nominatim
können Koordinaten bestimmt und in verschiedenen Ausgabeformen bereitgestellt werden.
Aufruf
Bearbeiten
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
Quelltext von poi2gpx.php
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
lang
– Sprache des Wikis
name
– Name des Artikels
multipoi2gpx.php
Bearbeiten
Quelltext
Bearbeiten
Quelltext von multipoi2gpx.php
Beschreibung
Bearbeiten
Gibt die Daten aller Marker und listings/vCards in eine GPX-Datei aus.
Aufruf
Bearbeiten
lang
– Sprache des Wikis
name
– Datei mit einer Liste von Artikelnamen.
poimap2.php
Bearbeiten
Quelltext
Bearbeiten
Quelltext von poimap2.php
Beschreibung
Bearbeiten
...
Aufruf
Bearbeiten
lat
– geografische Breite
lon
– geografische Länge
zoom
– Zoomwert, 1–19
layer
– Art des Kartenlayers. Gültige Werte: default=M, gültig: M=
apnik (OSM), W=
ikivoyage, N= Traffic line
etwork, O= Mapquest
pen, A= Mapquest
erial, P=
ois of Interest, L=
abels, H=
iking, S= hill
hading, C=
ycling, D=
estinations.
lang
– Sprache des Wikis
name
– Name des Artikels
artmap.php
Bearbeiten
Quelltext
Bearbeiten
Quelltext von artmap.php
Beschreibung
Bearbeiten
Das Werkzeug erstellt eine Karte, auf der die Wikivoyage-Artikel aus dem zugehörigen Wiki angezeigt werden.
Aufruf
Bearbeiten
lang
– Sprache des Wikis
gpx2mapmask.php
Bearbeiten
Quelltext
Bearbeiten
Quelltext von gpx2mapmask.php
Beschreibung
Bearbeiten
...
Aufruf
Bearbeiten
Keine Parameter, da Web-Tool.
gpxmap.php
Bearbeiten
Quelltext
Bearbeiten
Quelltext von gpxmap.php
Beschreibung
Bearbeiten
...
Aufruf
Bearbeiten
...
mapmask2gpx.php
Bearbeiten
Quelltext
Bearbeiten
Quelltext von mapmask2gpx.php
Beschreibung
Bearbeiten
...
Aufruf
Bearbeiten
Keine Parameter, da Web-Tool.
readpage.php
Bearbeiten
Quelltext
Bearbeiten
Quelltext von readpage.php
Beschreibung
Bearbeiten
...
Aufruf
Bearbeiten
Keiner. Wird als Untermodul von anderen PHP-Skripten benutzt.
Abgerufen von „
Kategorie
PHP-Kartentools
Wikivoyage
PHP-Kartentools
Abschnitt hinzufügen