Für das erstellen von Papierkarten aber auch für viele andere Anlässe braucht es die Daten der Karte in anderen Formaten und Anwendungen, wozu wir einen csv-Export anbieten.

Aus Spamschutzgründen und um unseren Server nicht zu überlasten, kann dies aber nicht jeder, sondern nur Regional- bzw. Themenpilot*innen. Wenn du also Daten runter laden willst, bspw. um dein kartiertes Netzwerk per Mail an zu schreiben, stelle sicher, dass du als Regional- oder Themenpilot*in registriert bist.

Datendownload anfordern

Schreib uns einfach kurz eine Mail-Nachricht, wenn du die Daten brauchst, mit folgenden Angaben:

  • wer du bist,
  • welche Region (Screenshot der Karte)
  • und/oder welchen Hashtag du brauchst.

Bitte beachte das der Betrieb der Kartenplattform aber insbesondere der Support Zeit braucht, die wir gerne investieren für einen nachhaltigen Wandel. Um das aber nachhaltig zu finanzieren, bitten wir alle Partner, die bestimmte Daten als Download brauchen, um eine Kostenbeteiligung von 500 €/Jahr. Damit kannst du dann jeder Zeit deine Daten online als Liste abrufen. Bei kleinen, rein ehrenamtlichen Initiativen entfällt diese Gebühr natürlich.

csv-Format

Sobald du dich unter kartevonmorgen.org eingelogged hast, schicken wir dir den Download Link und schalten dich frei. Dann kannst du drauf klicken, und es öffnet sich eine csv-Datei.

Das Format der csv-Datei ist Unicode (UTF-8) und Komma-getrennt. Wir empfehlen die Verwendung von Libre Office, da Excel die Zeilenumbrüche in den Kurzbeschreibungen meist missinterpretiert.

Den Download können wir für dich eingrenzen. Die Commands müssen in der URL mit einem “&” verbunden werden:

URL-CommandFunktion
bbox=46.377,5.537,54.92,17.27 *Regionale Eingrenzung mit den 4 Eckkoordinaten des gewünschten Bereichs. (Beispiel ist der Bereich des D-A-CH-Raums)
text=Begrifflicher Filter für ein beliebiges Wort, was vorkommen muss.
%20 = space separator
tags= (bei Entries)
tag= (bei Events)
Thematisch Eingrenzung nach Stichworten (Komma separiert für mehrere Stichworte die alle zutreffen müssen.) bei Events geht nur ein Stichwort.
start_min=1579564800Zeitliche Auswahl im Unixtimestamp-Format, den du hier berechnen kannst: https://www.epochconverter.com/)
*notwendige Befehle

Beispiel-URL wo nach refill oder Leitungswasser gesucht wird: https://kartevonmorgen.org/api/v0/export/entries.csv?bbox=41.27780646738183,-12.1728515625,59.55659188568175,27.905273437500004&text=tag:refill%20tag:leitungswasser

Admins können alle Felder exportieren (created_by + email + phone), jetzt auch ohne Token.

Rolecreated_byemail/phone
Guest/User (No export at all!)
Scout (without token)✔️
Scout (with token)✔️ (owned events)
❌ (other events)
✔️
Admin✔️✔️

❌ = exported field is empty

Erweiterte Suche

Die Suche enthält ein paar Tricks, um bessere Ergebnisse zu erziehlen. Grundsätzlich ist die Funktion schon bei den Iframes beschrieben, hier aber nochmal.

CommandSuchergebnis
Brot WeltEs wird alles angezeigt, wo entweder Brot oder Welt drin vorkommt. (Durchsucht Titel, Beschreibung und Stichworte)
+Brot +WeltAlles wo Brot und Welt drin vorkommt
-Brot +WeltEs muss Welt drin vorkommen, aber es ohne Brot.
#Filtern nach Stichworten
#bio BrotFiltert nach dem Stichwort #bio und durchsucht Titel, Beschreibung und Stichworte nach Brot
#bio #BrotFiltert nach Einträgen mit #bio und #Brot
Man kann nicht nach #bio oder #Brot gleichzeitig suchen. Dafür muss man dann die #-Zeichen ganz weglassen, dann ist es Oder-verknüpft.
#bio -kneipeBegriffsausschlüsse funktionieren in Kombination mit Stichwortfilter nicht.

Developped in 2019 (Issue)

Import von Daten

Aus Angst vor Dubletten und Datenmüll haben wir immer Sorge vor automatisierten Importen. Da viele Menschen zur Karte von morgen (und besonders zu der dahinter liegenden openfairDB) beitragen und Inhalte aktualisieren, ist es schwer auszuschließen, dass die zu importierenden Daten nicht bereits vorhanden sind. Bitte daher mit uns Kontakt aufnehmen, falls ein Import gewünscht ist. Es gibt ein Import-Scritp, dass evtl. helfen kann, ist aber auch mit Arbeit verbunden.

Grundsätzlich gilt, dass bis zu 200 Einträge viel schneller per Hand eingetragen werden können, als per Importer. Erst ab dann lohnt sich der automatische Upload wirklich.

Upload-Format

Von dir brauchen wir zum Import eine Tabelle nach diesem Beispielformat mit folgenden möglichen Fledern

  • id, created_at, created_by, version (wird in der Regel von unserer Datenbank vergeben)
  • title
  • description
  • lat, lng und/oder street, zip, city (optional: country, state)
  • homepage
    • contact_name
    • contact_email
    • contact_phone
    • opening_hours
    • founded_on
  • categories (Initiative, Unternehmen)
  • tags
  • license (Alle Daten müssen open source sein, damit wir sie in die openfairDB laden können.)
  • image_url, image_link_url
  • avg_rating
  • Facebook, Twitter, Instagram, Telegram, WhatsApp…

Vermeidung von Dupletten

Wir haben einen Dupletten-Checker entwickelt (issue), der beim Import via Rest-API genutzt werden kann, um bestehende, ähnliche Einträge zu finden. Diese müssen dann meist händisch geprüft werden.

In der openAPI.yaml siehst du, wie der funktioniert:

  • go to editor.swagger.io
  • go to File -> import URL
  • enter https://raw.githubusercontent.com/kartevonmorgen/openfairdb/master/openapi.yaml