API von bedarfsverkehr.at/mobil-am-land.at

Zugriffspunkt

Die API ist über https://bedarfsverkehr.at/w/api.php oder https://mobil-am-land.at/w/api.php zugänglich

Parameter

Die API benötigt/akzeptiert folgende Parameter:

Parameter	Wert	Beschreibung
action	askargs	Semantic MediaWiki-Query
format	json	Rückgabeformat (zur Fehlersuche steht auch "jsonfm", eine HTML-Repräsentation von JSON zur Verfügung)
parameters	limit=1000	Anzahl der zurückgegebenen Datensätze ist standardmäßig begrenzt, deshalb hohes Limit setzen
conditions	Bedienungsgebiet-GeoJSON::+	Abfragebedingungen, mehrere Bedingungen mit Pipe trennen
printouts	Bedienungsgebiet-GeoJSON	Rückgabewerte, mehrere Felder mit Pipe trennen

Die Beispielabfrage wählt alle Datensätze aus, für die ein Wert im Feld „Bedienungsgebiet-GeoJSON“ angegeben wurde und gibt den Wert für dieses Feld zurück: http://bedarfsverkehr.at/w/api.php?action=askargs&conditions=Bedienungsgebiet-GeoJSON%3A%3A%2B&printouts=Bedienungsgebiet-GeoJSON&parameters=limit%3D1000&format=jsonfm

Struktur des relevanten Teils der Antwort:

{
     "query": {
        "results": [
            {
                "printouts": [
                    {
                        "label": "Bedienungsgebiet-GeoJSON",
                        "0":"{\"type\":\"MultiPolygon\",\"coordinates\":[...]}"
                    }
                ],
		"fulltext": "Gmoabus Breitenbrunn"
            }
        ]
    }
}

query.results[0].fulltext enthält also den Namen des Angebots

Anmerkung zum Feld „Bedienungsgebiet-GeoJSON“: GeoJSON kann derzeit nur als Textfeld gespeichert werden, der zurückgegebene Wert muss also erst geparsed werden!

Auswahlkriterien für öffentlich zugängliche, hochflexible Bedarfsverkehre

Leider sind viele der in unserer Datenbank erfassten Bedarfsverkehre von Einschränkungen betroffen, weil sie nur für eine bestimmte Zielgruppe (z.B. Vereinsmitglieder, Senior*innen oder Gemeindebürger*innen) oder nur zu ausgewählten Betriebszeiten zur Verfügung stehen.

Manche Bedarfsverkehre verkehren nicht im Flächenbetrieb (von Haustür zu Haustür), sondern zwischen Haltepunkten und teilweise mit fixen Fahrplänen. Da Haltepunkte und Fahrpläne in unserer Datenbank derzeit nicht erfasst sind, können diese aktuell nur eingeschränkt beauskunftet werden.

Zur Auswahl von hochflexiblen, Taxi-artigen Bedarfsverkehren, die uneingeschränkt öffentlich zugänglich sind, können die folgenden „Conditions“ verwendet werden:

• Kategorie:Bedarfsverkehr
• aktiv::wahr
• FlexZeit::nach Bedarf
• FlexRaum::Tür-Tür
• Land::Österreich
• Bedienungsgebiet-GeoJSON::+

folgende „Printouts“ stehen (u.a.) zur Verfügung:

• Bestellnummer
• Homepage
• Öffnungszeiten
• Vorbestellzeit
• Bedienungsgebiet-GeoJSON
• Einschränkung
• LetzterCheck

vollständiger resultierender API-Call: http://bedarfsverkehr.at/w/api.php?action=askargs&conditions=Kategorie%3ABedarfsverkehr%7Caktiv%3A%3Awahr%7CFlexZeit%3A%3Anach%20Bedarf%7CFlexRaum%3A%3AT%C3%BCr-T%C3%BCr%7CLand%3A%3AÖsterreich%7CBedienungsgebiet-GeoJSON%3A%3A%2B&printouts=Bestellnummer%7CHomepage%7C%C3%96ffnungszeiten%7CVorbestellzeit%7CBedienungsgebiet-GeoJSON%7CEinschr%C3%A4nkung%7CLetzterCheck&parameters=limit%3D1000&format=json

Hinweis: Leider kennt die API keine Negativ-Conditions, deshalb müssen Angebote mit Einschränkungen (bei denen also das Feld „Einschränkung“ einen Inhalt hat) im Nachhinein herausgefiltert werden!

allgemeine Schnittstellen-Dokumentation von Semantic MediaWiki

Die API wird über die MediaWiki-Erweiterung Semantic MediaWiki bereitgestellt. Weitere Informationen finden sich daher auch in der Dokumentation des SMW-API Moduls „askargs“.

Liste aller Datenbankfelder

Betrieb

Feld	Kurzbeschreibung
aktiv	ist der Bedarfsverkehr aktuell in Betrieb oder erst geplant bzw. eingestellt? (wahr/falsch)
App-Android	URL zum Download der Android-App zur Buchung des Angebots
App-iOS	URL zum Download der iOS-App zur Buchung des Angebots
Bestellnummer	Telefonnummer(n), unter der der Bedarfsverkehr bestellt werden kann (mehrere Werte möglich)
Betreiberkonstellation	mögliche Werte: Verein mit bezahlten Fahrer*innen Verein mit ehrenamtlichen Fahrer*innen kommunaler Eigenbetrieb Verkehrsunternehmen Taxiunternehmen Bürgerbus (freiwillige Fahrer*innen im Fahrzeug eines Verkehrsunternehmens) Sonstiges
Betriebsstunden	Zahl der wöchentlichen Betriebsstunden
Betriebszeit	grobe Einteilung der Qualität der Betriebszeiten, mögliche Werte: 24/7 täglich werktags [Mo-Sa] wochentags [Mo-Fr] mehrmals wöchentlich 2x wöchentlich 1x wöchentlich mehrmals monatlich nur an bestimmten Tagen nur zu bestimmten Zeiten Angebote, die nur in den Nachtstunden verkehren oder nur saisonal zur Verfügung stehen haben den Wert „nur zu bestimmten Zeiten“.
Betriebszeiten	Betriebsszeiten in einem für Menschen lesbaren Format
Einschränkung	hier wird vermerkt, wenn ein Angebot nur mit Einschränkungen zur Verfügung steht. Mögliche Werte (mehrere Werte möglich): eingeschränkte Zielgruppe [siehe auch Attribut Zielgruppe] eingeschränkter Tiketverkauf [nur im Vorverkauf] lange Vorbestellzeit [>60 min, siehe Attribut Vorbestellzeit] eingeschränkte Betriebszeiten [falls nicht mindestens wochentags, siehe Attribut Betriebszeit]
FahrplanLink	URL des Fahrplans
FlexRaum	räumliche Flexibilität, mögliche Werte: Haltestelle-Haltestelle Haltestelle-Tür Tür-Tür
FlexZeit	zeitliche Flexibilität, mögliche Werte: mit Fahrplan mit Fahrplan nach Bedarf nach Bedarf
HaltestellenplanLink	URL des Haltestellenplans
Hat Einschränkung	ist dieses Angebot mit Einschränkungen (Zielgruppe, Betriebszeiten etc.) verbunden (siehe Attribut Einschränkung)? (wahr/falsch)
Homepage	Webseite des Angebots
Modell	Organisationsmodell (analog zu den Beschreibungen im Handbuch On-Demand)
Öffnungszeiten	Betriebszeiten in maschinenlesbarem Format
Online-Buchung	URL für Online-Buchung
Personal	mögliche Werte: bezahlt freiwillig
Software	eingesetzte Software, z.B. Cover, Via, Trapeze, DABS, ISTmobil
Stand	mögliche Werte: geplant in Umsetzung in Betrieb eingestellt
Vorbestellzeit	wie viele Minuten im Voraus muss das Angebot bestellt werden?
Vorbestellzeit-Text	Vorbestellzeit wie im Formular eingegeben (kann auch in Stunden oder Tagen eingegeben werden)
Zielgruppe	mögliche Werte uneingeschränkt eingeschränkt Jugendliche Senior*innen Gemeindebürger*innen Vereinsmitglieder Frauen Männer Sonstige Tourist*innen Pendler*innen Sonstiges
Verbundintegration	ist das Angebot in irgendeiner Form in den Verbund integriert (wahr/falsch)

Metainformation

Feld	Kurzbeschreibung
LetzterCheck	wann wurde das Angebot zuletzt überprüft?
Quelle	woher stammen die in der Datenbank vorhandenen Informationen? (Liste)
VAO ID	unter welcher ID wurde der Bedarfsverkehr in die VAO aufgenommen (oder „eingebunden“, falls ID nicht verfügbar)

Ort

Feld	Kurzbeschreibung
Bedienungsgebiet	mögliche Werte: Gemeinde Region Wird automatisch auf Region gesetzt, wenn das Bedienungsgebiet mehr als eine Gemeinde umfasst.
Bedienungsgebiet-GeoJSON	Polygon des Bedienungsgebiets (für Bedarfsverkehre mit Flächenbetrieb)
Bedienungsgebiet-RelationID	RelationID der Gemeindegrenzen auf OpenStreetMap
Bundesland	Bundesland
GKZ	Gemeindekennzahl der betroffenen Gemeinden (Liste)
Haltestellenkategorie	höchste Haltestellenkategorie (der ÖV-Güteklassen) im Bediengebiet
Land	Land, in dem sich der Bedarfsverkehr befindet
Ort	betroffene Gemeinden (Liste)
Raumtyp	Raumtypen der betroffenen Gemeinden (Liste) Wien Großstädte ohne Wien zentrale Bezirke periphere Bezirke Diese Einteilung erfolgt analog zur Kategorisierung bei Österreich unterwegs 2013/14.
Urban-Rural-Typ	Ziffer der Urban-Rural-Kategorisierung der betroffenen Gemeinden (Liste)
Urban-Rural-Typ-Kategorie	Ziffer der Urban-Rural-Hauptkategorisierung der betroffenen Gemeinden (Liste) [1-4]
Urban-Rural-Typ-Text	(sortierbare) textliche Beschreibung der Urban-Rural-Kategorisierung der betroffenen Gemeinden (Liste), z.B. „I Ländlicher Raum, zentral“
Urban-Rural-Typ-Kategorie-Text	(sortierbare) textliche Beschreibung der Urban-Rural-Hauptkategorisierung der betroffenen Gemeinden (Liste), z.B. „d Ländlicher Raum“

Statistik

Für eine Übersicht siehe auch die Seite Kennzahlen für Bedarfsverkehr.

Feld	Kurzbeschreibung
App-Anteil
Beförderungsfälle	Anzahl der Beförderungsfälle pro Jahr
Beförderungsfälle je EinwohnerIn und Jahr	Anzahl der Beförderungsfälle pro EinwohnerIn und Jahr
Betriebsbeginn	Datum des Betriebsbeginns
Besetztkilometer	jährlich besetzt gefahrene Kilometer
Betriebsende	Datum des Betriebsende (falls Angebot eingestellt)
Betriebskosten	jährliche Betriebskosten
BetriebskostenjeBF	durchschnittliche Betriebskosten je Beförderungsfall
durchschnittliche gebuchte Reiseweite	Strecke, die ein Fahrgast durchschnittlich zurücklegen wollte
EinwohnerInnen im Bediengebiet	EinwohnerInnen im Bedienungsgebiet
EinwohnerKat	mögliche Werte: A unter 1.000 B 1.000-2.000 C 2.000-5.000 D 5.000-10.000 E über 10.000
EinwohnerTausend	EinwohnerInnen im Bedienungsgebiet (in Tausend)
Einwohnerzahl	EinwohnerInnen im Bedienungsgebiet
Fahrgäste je Fahrt
Fahrgeldeinnahmen	jährliche Fahrgeldeinnahmen
Fahrgeldeinnahmen je Beförderungsfall
Fahrzeugkilometer je Beförderungsfall	je Beförderungsfall zurückgelegte Fahrzeugkilometer
Fahrten	Anzahl der durchgeführten Fahrten je Jahr
Fläche Bediengebiet	Fläche des Bediengebiets in km²
Gemeindezahl	Anzahl der betroffenen Gemeinden
Gästebetten	Anzahl der Gästebetten in den betroffenen Gemeinden
Jahr	Jahr des Betriebsbeginns
Kilometerleistung	jährlich zurückgelegte Kilometer
Kostendeckung	Anteil der Fahrgeldeinnahmen an den Gesamtkosten
Kosten je Beförderungsfall	Kosten je befördertem Fahrgast
Kosten je Fahrzeugkilometer	Kosten je gefahrenem Kilometer
Leerkilometer
Leerkilometeranteil
Modal Split	Anteil des Angebots am Modal Split im Bediengebiet (berechnet auf Grundlage der EinwohnerInnen im Bediengebiet und der durchschnittlichen Wegezahl der österreichischen Gesamtbevölkerung)
ÖV-Anteil
Personenkilometer gebucht
Systemeffizienz

Tarif

Feld	Kurzbeschreibung
Einzelticket	Preis eines Einzeltickets
EinzelticketPreissegment	Preissegment des Einzeltickets (ganzzahlige Rundung)
ExklusiverVorverkauf	sind Tickets nur im Vorverkauf erhältlich (wahr/falsch)
Jahreskarte	Preis einer Jahreskarte
Monatskarte	Preis einer Monatskarte
Tageskarte	Preis einer Tageskarte
Tarifanmerkungen	Textfeld zur Beschreibung tariflicher Besonderheiten
Vorverkauf	Anmerkungen zum Vorverkauf
Wochenkarte	Preis einer Wochenkarte

nicht mehr verfügbare Datenbankfelder (oder deprecated)

Feld	Kurzbeschreibung
Betriebsform (deprecated)	ähnlich funktionierende Systeme werden als „Betriebsformen“ in Gruppen zusammengefasst (z.B. Anruf-Sammeltaxi, Rufbus, Gemeindebusse, Citytaxi etc.)
Fahrzeug/Transportkapazität (deprecated)	Art des eingesetzten Fahrzeugs
Lage (deprecated)	Koordinaten eines Punkts im Bediengebiet
Tarifmodell (deprecated)	mögliche Werte: Nulltarif Tarifintegration in ÖPNV Zahlung pro Fahrt entfernungsabhängig zeitabhängig Vielnutzungstarife
Merkmal	besondere Merkmale, z.B. Einsatz eines Elektrofahrzeugs oder ÖPNV-Tarifintegration
Kontakt	Angaben zur Kontaktperson