Kontakt

Offener RSS-Feed für Veranstaltungen



Durch verschiedene Anforderungen wurden wir immer wieder vor die Frage gestellt, ob es keinen gemeinsamen Standart zum Austausch von Veranstaltungsdaten gibt. Bisher hatten wir dazu keine Antwort, bis wir entschlossen haben, diesen eben selber für uns zu generieren. Deshalb bietet PRO nun einen einfachen offenen XML-Austausch auf Basis eines erweiterten RSS-Feeds an. Dieser Standart ist offen und darf von jedem frei genutzt und erzeugt werden.

Für Erweiterungen des Standarts steht PRO gern zur Verfügung. Vorschläge senden Sie bitte an: post@larsfranke-pro.de.

Schnittstellenbeschreibung:

Die Basis der Schnittstelle stellt ein normaler RSS-Feed da. Informationen dazu finden Sie unter anderem hier: http://www.rssboard.org/rss-specification. Zusätzlich haben wir einige Tags hinzugefügt:


<title></title> = RSS-Standartfeld: Name der Veranstaltung.

<description></description> = RSS-Standartfeld für Beschreibungen

<description_short></description_short> = Kurzbeschreibung bis 150 Zeichen

<description_long></description_long> = Langbeschreibung bis 800 Zeichen

<plz></plz> = Postleitzahl von Mittelpunkt der Veranstaltung

<stadt></stadt> = Stadt in welcher die Veranstaltung stattfindet. Zwingend anzugeben!

<strasse></strasse> = Strasse oder Platz oder Bezeichnungen wie Innenstadt von Veranstaltung

<raum></raum> = Raum oder Halle der Veranstaltung

<link></link> = Link zu Seite mit weiteren Informationen

<image></image> = Bild zur Veranstaltung

<kategorie></kategorie> = Feste Kategorie. Beschreibung siehe unten. Zwingend anzugeben!

<wochentag></wochentag> = Wenn die Veranstaltung gleichbleibend immer an einem regelmäßigen Wochentag stattfindet. Bei wechselnden Veranstaltungen an diesem Tag, die Veranstaltung bitte einzeln übergeben! Jede oder So,Mo,Di,Mi,Do,Fr,Sa
Beispiel: Mo,Do = Jeden Montag und Donnerstag

<monatswoche></monatswoche> = Wenn die Veranstaltung an einer bestimmten Woche im Monat stattfindet. Wochennummer getrennt mit Komma oder "Jede"
Beispiel: 1 = 1. Woche im Monat oder 1,3 = 1. und 3. Woche im Monat

<datum_von></datum_von> = Ab welchem Datum beginnt die Veranstaltung. Zwingend anzugeben!

<datum_bis></datum_bis> = Bis wann geht die Veranstaltung. Nur anzugeben, wenn es mehr als 1 Tag ist

<uhrzeit_von></uhrzeit_von> = Ab wieviel Uhr beginnt die Veranstaltung. Unausgefüllt = 0-24 Uhr

<uhrzeit_bis></uhrzeit_bis> = Bis wann geht die Veranstaltung

<einlass></einlass> = Wenn der Einlass zu einer Veranstaltung von uhrzeit_von abweicht.

<einlass_alter></einlass_alter> = Ab welches Alter darf die Veranstaltung besucht werden.

<eintrittspreis></eintrittspreis> = Eintrittspreis für kostenpflichtige Veranstaltung

<shoplink></shoplink> = Shoplink zum Bestellen von Karten oder weiteres zu dieser Veranstaltung

<lat></lat> = Geografischer Breitengrad
<lng></lng> = Geografischer Längengrad


Folgende Kategorien sind bisher fest definiert:


Wochenmarkt = Üblicher Wochenmarkt für Obst, Gemüse, Fleisch, Blumen und Fisch
Flohmarkt = Nur Flohmärkte
Antikmarkt = Nur Antikmärkte
Veranstaltungsmarkt = Beispielsweise Ostermärkte, Herbstmärkte ausgenommen Weihnachtsmarkt
Weihnachtsmarkt = Weihnachtsmarkt
Jahrmarkt = Kirmes, Freimarkt, Kirchweih. Immer dann wenn überwiegend Fahrgeschäfte eingesetzt werden
Late-Night = Late-Night oder Mitternachtsshopping
Verkaufsoffen = Nur verkaufsoffene Sonntage
Theater = Theaterstücke oder Aufführung mit Schauspiel
Comedy = Satire und Comedy
Musikevent = Musikveranstaltungen wie Konzerte oder Open-Air
Lesung = Lesung- oder Vortrag
Disco = Tanz- oder Diskoveranstaltungen
Kurse = Kurse beispielsweise von Volkshochschulen
Gastronomie = Gastronomische Veranstaltungen (überwiegend Essen und Trinken)
Tagung = Tagungen, Workshops
Sitzungen = Sitzungen, Ratsversammlungen
Sport = Sportveranstaltungen


Sollten sie weitere Kategorien verwenden, lassen Sie uns diese Informationen zukommen und wir erweitern diese Dokumentation entsprechend. Achten Sie bitte darauf, das diese Kategorien eindeutig sind und sich nicht mit vorhandenen Kategorien überschneiden.

Einfaches Beispiel für einen RSS-Feed mit zwei Wochenmärkten:


<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
  <title>Beispiel: Beispiel Veranstaltungen</title>
  <link>http://www.beispieldomain.de</link>
  <language>de-de</language>
  <copyright>Stadt Beispiel</copyright>
  <pubDate>Mon, 16 Apr 12 14:07:31 +0200</pubDate>
  <atom:link href="http://www.beispieldomain.de/waserleben.xml" rel="self" type="application/rss+xml" />

  <image>
    <url>http://www.beispieldomain.de/pics/logo.jpg</url>
    <link>http://www.beispieldomain.de</link>
  </image>
  
  <item>
    <title>Wochenmarkt</title>
    <description>
     <![CDATA[
     Dienstag auf dem Berliner Platz von 8 - 14 Uhr
     ]]>
    </description>
    <description_long>
     <![CDATA[
     Ein Gang über den Markt auf dem Berliner Platz ist zu jeder Jahreszeit farbenfroh. Spargel, Mangold, Pastinaken oder Kürbisse bieten die regionalen Händler frisch vom Feld und passend zur jeweiligen Saison an ihren Ständen an – konventionell oder biologisch erzeugt. So mancher Besucher wird von der Vielfalt der heimischen Produkte überrascht sein. Und im direkten Gespräch mit den Standbetreibern gibt es oft noch Tipps für schmackhafte Rezepte dazu.
     ]]>
    </description_long>
    <plz>33330</plz>
    <stadt>Beispielstadt</stadt>
    <strasse>Berliner Platz</strasse>
    <link>http://www.beispielstadt.de/Z3VldGVyc2xvaGQ0Y21zOjQ2NjI4.x4s</link>
    <image>http://www.beispielstadt.de/servlet/picturepool/imageprovider?uid=37554</image>
    <kategorie>Wochenmarkt</kategorie>
    <wochentag>Di</wochentag>
    <monatswoche>Jede</monatswoche>
    <uhrzeit_von>8:00</uhrzeit_von>
    <uhrzeit_bis>14:00</uhrzeit_bis>
  </item>
  
  <item>
    <title>Wochenmarkt</title>
    <description>
     <![CDATA[
     Jeden 2. und 4. Freitag im Monat in Beispielstadt - Beispielstraße von 7 - 13 Uhr
     ]]>
    </description>
    <description_long>
     <![CDATA[
     Ein Gang über den Markt auf dem Beispielplatz ist zu jeder Jahreszeit farbenfroh. Spargel, Mangold, Pastinaken oder Kürbisse bieten die regionalen Händler...
     ]]>
    </description_long>
    <plz></plz>
    <stadt>Beispielstadt</stadt>
    <strasse>Beispielstraße</strasse>
    <link>http://www.beispielstadt.de/Z3VldGVyc2xvaGQ0Y21zOjQ2NjI4.x4s</link>
    <image>http://www.beispielstadt.de/servlet/picturepool/imageprovider?uid=37554</image>
    <kategorie>Wochenmarkt</kategorie>
    <wochentag>Fr</wochentag>
    <monatswoche>2,4</monatswoche>
    <uhrzeit_von>7:00</uhrzeit_von>
    <uhrzeit_bis>13:00</uhrzeit_bis>
  </item>  
</channel>



Weitere Beispiele: