Wikipedia:Bilderwünsche/bwAPI

Screenshot der bwAPI

Die bwAPI (kurz für Bilderwunsch Application Programming Interface) stellt Zusatzfunktionen in Verbindung mit {{Bilderwunsch}} bereit, d. h. es generiert eine Landkarte, in der Bilderwünsche angezeigt werden.

Aber Achtung: Das Programm bwAPI wird seit Mitte 2019 nicht mehr „synchronisiert“, d. h. es zeigt nur die alten Bilderwünsche von 2019 an. Das in diesem Artikel weiter unten vorgestellte Programm toollabs:bldrwnsch leistet ähnliches und ist aktuell.

Aufruf

Blau: Bilderwünsche
Rot: Bilderangebote

Der Aufruf der bwAPI ist durch Klick auf eine Koordinate in einem Artikel möglich. In der dort angezeigten Vorlage:GeoTemplate finden sich im Abschnitt Anwendungen mit Wiki-Aspekt mehrere Links zum Tool mit unterschiedlichem Suchradius.

Die Karte kann außerdem direkt unter toollabs:request/bwAPI – optional mit der Eingabe von Koordinaten – aufgerufen werden.

Für unterwegs steht eine mobile Web-App unter toollabs:request/bwAPI/mobile zur Verfügung, welche es erlaubt, die eigene Position per GPS abzurufen und entsprechende Bilderwünsche im unmittelbaren Umkreis anzuzeigen. Um das Smartphone mit der Darstellung nicht zu überlasten, werden in dieser Anwendung maximal 500 Ergebnisse für den jeweiligen Kartenausschnitt abgerufen.

Das Tool toollabs:bldrwnsch stellt eine alternative, freie Implementierung der Bilderwünsche-Extraktion mit Frontend dar und kann sowohl auf Desktops als auch auf mobilen Geräten verwendet werden. Zudem stellt das Tool alle Bilderwünsche in verschiedenen Formaten zum Download bereit: toollabs:bldrwnsch/Bilderwuensche.gpx als GPX • toollabs:bldrwnsch/Bilderwuensche.geojson als GeoJSON • toollabs:bldrwnsch/Bilderwuensche.json als JSON • toollabs:bldrwnsch/Bilderwuensche.kml bzw. toollabs:bldrwnsch/Bilderwuensche.kmz als KML

Karte

Grundidee der bwAPI war die Visualisierung von Bilderwünschen im Umkreis zu einer Koordinate. Der Kreis stellt den eingegebenen Umkreis dar, die blauen Markierungen sind jeweils ein Bilderwunsch. Rote Markierungen symbolisieren einen Eintrag auf Wikipedia:Bilderangebote oder einem Gegenstück in einem anderen Projekt oder einer anderen Sprachversion.

Während die Fotografen immer angezeigt werden, sind Bilderwünsche nur innerhalb vom Radius sichtbar. Wenn man Bilderwünsche außerhalb des Radius sehen möchte, muss man diesen vergrößern oder neu suchen. Details zum jeweiligen Bilderwunsch können mit einem Klick auf die blauen Marker angezeigt werden. Angezeigt wird der betroffene Artikel und – sofern hinterlegt – konkrete Hinweise zum Bilderwunsch.

Ab einem gewissen Radius wird die Karte sehr langsam, daher ist es meist sinnvoll, per Doppelklick auf einen anderen Punkt, eine neue Umkreissuche zu starten.

Exportfunktionen

Bilderwünsche im Radius exportieren in die Formate OV2, CSV, und KML

Ausschnitt

Über die Schaltflächen am Rand der Karte können die Bilderwünsche im ausgewählten Radius in verschiedenen Formate exportiert werden:

• CSV: Bilderwünsche mit allen Spalten, wie sie in der Datenbank stehen, flexibel nutzbar für Anwendungen, die den CSV-Import unterstützen
• KML: nutzbar für Google MyMaps, Google Earth oder Marble bzw. unter Android z.B. Maps.ME oder Locus Map.
• OV2: binäres Dateiformat für den Import als POIs in TomTom-Navigationsgeräte (Import über My Drive Connect oder MyDrive). Das passende Symbol zur Anzeige im Navi gibt es hier.

Alle Bilderwünsche

Daneben kann die Datenbank aller Bilderwünsche zur Weiterverarbeitung exportiert werden:

• CSV: alle Bilderwünsche in einer CSV-Datei
• OV2: alle Bilderwünsche in einer OV2-Datei
• KML: alle Bilderwünsche in einer KML-Datei

Datenbasis

Die Bilderwünsche werden gesammelt auf s5.labsdb in der Datenbank s52861__bwAPI_p bereitgestellt. Alle Daten werden stündlich mit Wikipedia synchronisiert. Das Auslesen geschieht über einen Wartungslink in Vorlage:Bilderwunsch/encode.