Cookies helfen uns bei der Bereitstellung von mobil-am-land.at. Durch die Nutzung von mobil-am-land.at erklären Sie sich damit einverstanden, dass wir Cookies speichern. Weitere Informationen

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

Aus mobil-am-land.at
Wechseln zu: Navigation, Suche

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
  • Bundesland::+
  • 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%7CBundesland%3A%3A%2B%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
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
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)

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
Merkmal besondere Merkmale, z.B. Einsatz eines Elektrofahrzeugs oder ÖPNV-Tarifintegration