wikishia:Bilderwünsche/bwAPI
Die bwAPI (kurz für Bilderwunsch Application Programming Interface) stellt Zusatzfunktionen in Verbindung mit Vorlage:Vorlage bereit.
Aufruf
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 Wikishia: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
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: Datei:Farm-Fresh inbox download.png alle Bilderwünsche in einer CSV-Datei
- OV2: Datei:Farm-Fresh inbox download.png alle Bilderwünsche in einer OV2-Datei
- KML: Datei:Farm-Fresh inbox download.png 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.