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

API von bedarfsverkehr.at/mobil-am-land.at: Unterschied zwischen den Versionen

Aus bedarfsverkehr.at
Wechseln zu: Navigation, Suche
 
(42 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 59: Zeile 59:
 
* FlexZeit::nach Bedarf
 
* FlexZeit::nach Bedarf
 
* FlexRaum::Tür-Tür
 
* FlexRaum::Tür-Tür
* Bundesland::+
+
* Land::Österreich
 
* Bedienungsgebiet-GeoJSON::+
 
* Bedienungsgebiet-GeoJSON::+
  
Zeile 72: Zeile 72:
 
* LetzterCheck
 
* 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
+
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!
 
'''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!
Zeile 81: Zeile 81:
  
 
=== Liste aller Datenbankfelder ===
 
=== Liste aller Datenbankfelder ===
 +
 +
==== Betrieb ====
  
 
{| class="table table-bordered table-sm sortable" style="font-size:small"
 
{| class="table table-bordered table-sm sortable" style="font-size:small"
|-
 
 
! Feld
 
! Feld
! Gruppe
+
! Kurzbeschreibung
! Beschreibung
 
 
|-
 
|-
 
| aktiv
 
| aktiv
| Betrieb
 
 
| ist der Bedarfsverkehr aktuell in Betrieb oder erst geplant bzw. eingestellt? (wahr/falsch)
 
| ist der Bedarfsverkehr aktuell in Betrieb oder erst geplant bzw. eingestellt? (wahr/falsch)
 
|-
 
|-
 
| App-Android
 
| App-Android
| Betrieb
 
 
| URL zum Download der Android-App zur Buchung des Angebots
 
| URL zum Download der Android-App zur Buchung des Angebots
 
|-
 
|-
 
| App-iOS
 
| App-iOS
| Betrieb
 
 
| URL zum Download der iOS-App zur Buchung des Angebots
 
| URL zum Download der iOS-App zur Buchung des Angebots
|-
 
| Beschreibung
 
| Betrieb
 
| beschreibender Text zum Bedarfsverkehr (aktuell wird das Feld mit der Beschreibung der „Betriebsform“ befüllt)
 
 
|-
 
|-
 
| Bestellnummer
 
| Bestellnummer
| Betrieb
+
| Telefonnummer(n), unter der der Bedarfsverkehr bestellt werden kann (mehrere Werte möglich)
| Telefonnummer, unter der der Bedarfsverkehr bestellt werden kann
 
 
|-
 
|-
 
| Betreiberkonstellation
 
| Betreiberkonstellation
| Betrieb
 
 
| mögliche Werte:  
 
| mögliche Werte:  
*Verein
+
*Verein mit bezahlten Fahrer*innen
*Verein mit Konzession
+
*Verein mit ehrenamtlichen Fahrer*innen
*Verein ohne Konzession
 
 
*kommunaler Eigenbetrieb
 
*kommunaler Eigenbetrieb
 
*Verkehrsunternehmen
 
*Verkehrsunternehmen
 
*Taxiunternehmen
 
*Taxiunternehmen
*Bürgerbus
+
*Bürgerbus (freiwillige Fahrer*innen im Fahrzeug eines Verkehrsunternehmens)
 +
*Sonstiges
 
|-
 
|-
| Betriebsform
+
| Betriebsstunden
| Betrieb
+
| Zahl der wöchentlichen Betriebsstunden
| ähnlich funktionierende Systeme werden als „Betriebsformen“ in Gruppen zusammengefasst (z.B. Anruf-Sammeltaxi, Rufbus, Gemeindebusse, Citytaxi etc.)
 
 
|-
 
|-
 
| Betriebszeit
 
| Betriebszeit
| Betrieb
 
 
| grobe Einteilung der Qualität der Betriebszeiten, mögliche Werte:
 
| grobe Einteilung der Qualität der Betriebszeiten, mögliche Werte:
 
*24/7
 
*24/7
 
*täglich
 
*täglich
*werktags
+
*werktags [Mo-Sa]
*wochentags
+
*wochentags [Mo-Fr]
 
*mehrmals wöchentlich
 
*mehrmals wöchentlich
 
*2x wöchentlich
 
*2x wöchentlich
Zeile 136: Zeile 125:
 
*nur an bestimmten Tagen
 
*nur an bestimmten Tagen
 
*nur zu bestimmten Zeiten
 
*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
 
| Einschränkung
| Betrieb
+
| hier wird vermerkt, wenn ein Angebot nur mit Einschränkungen zur Verfügung steht. Mögliche Werte (mehrere Werte möglich):
| hier wird vermerkt, wenn ein Angebot nur für eine bestimmte Zielgruppe (z.B. SeniorInnen, Vereinsmitglieder) oder nur zu beschränkten Zeiten zur Verfügung steht
+
* 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
 
| FahrplanLink
| Betrieb
 
 
| URL des Fahrplans
 
| URL des Fahrplans
|-
 
| Fahrzeug/Transportkapazität
 
| Betrieb
 
| Art des eingesetzten Fahrzeugs
 
 
|-
 
|-
 
| FlexRaum
 
| FlexRaum
| Betrieb
 
 
| räumliche Flexibilität, mögliche Werte:
 
| räumliche Flexibilität, mögliche Werte:
 
*Haltestelle-Haltestelle
 
*Haltestelle-Haltestelle
 
*Haltestelle-Tür
 
*Haltestelle-Tür
*Tür-Haltestelle
 
*Haltestelle-Tür-Haltestelle
 
 
*Tür-Tür
 
*Tür-Tür
 
|-
 
|-
 
| FlexZeit
 
| FlexZeit
| Betrieb
+
| zeitliche Flexibilität, mögliche Werte:
| zeitliche Flexibilität:
 
 
*mit Fahrplan
 
*mit Fahrplan
 
*mit Fahrplan nach Bedarf
 
*mit Fahrplan nach Bedarf
Zeile 166: Zeile 154:
 
|-
 
|-
 
| HaltestellenplanLink
 
| HaltestellenplanLink
| Betrieb
 
 
| URL des Haltestellenplans
 
| URL des Haltestellenplans
 +
|-
 +
| Hat Einschränkung
 +
| ist dieses Angebot mit Einschränkungen (Zielgruppe, Betriebszeiten etc.) verbunden (siehe Attribut ''Einschränkung'')? (wahr/falsch)
 
|-
 
|-
 
| Homepage
 
| Homepage
| Betrieb
 
 
| Webseite des Angebots
 
| Webseite des Angebots
 
|-
 
|-
| Merkmal
+
| Modell
| Betrieb
+
| Organisationsmodell (analog zu den Beschreibungen im [[Handbuch:Modelle|Handbuch On-Demand]])
| besondere Merkmale, z.B. Einsatz eines Elektrofahrzeugs oder ÖPNV-Tarifintegration
 
 
|-
 
|-
 
| Öffnungszeiten
 
| Öffnungszeiten
| Betrieb
 
 
| Betriebszeiten in maschinenlesbarem Format
 
| Betriebszeiten in maschinenlesbarem Format
 
|-
 
|-
 
| Online-Buchung
 
| Online-Buchung
| Betrieb
 
 
| URL für Online-Buchung
 
| URL für Online-Buchung
 
|-
 
|-
 
| Personal
 
| Personal
| Betrieb
 
 
| mögliche Werte:
 
| mögliche Werte:
 
*bezahlt
 
*bezahlt
Zeile 192: Zeile 177:
 
|-
 
|-
 
| Software
 
| Software
| Betrieb
 
 
| eingesetzte Software, z.B. Cover, Via, Trapeze, DABS, ISTmobil
 
| eingesetzte Software, z.B. Cover, Via, Trapeze, DABS, ISTmobil
 +
|-
 +
| Stand
 +
| mögliche Werte:
 +
*geplant
 +
*in Umsetzung
 +
*in Betrieb
 +
*eingestellt
 
|-
 
|-
 
| Vorbestellzeit
 
| Vorbestellzeit
| Betrieb
 
 
| wie viele Minuten im Voraus muss das Angebot bestellt werden?
 
| 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
 
| Zielgruppe
| Betrieb
 
 
| mögliche Werte
 
| mögliche Werte
 
*uneingeschränkt
 
*uneingeschränkt
 
*eingeschränkt
 
*eingeschränkt
 
*Jugendliche
 
*Jugendliche
*SeniorInnen
+
*Senior*innen
*GemeindebürgerInnen
+
*Gemeindebürger*innen
 
*Vereinsmitglieder
 
*Vereinsmitglieder
*Frauen  
+
*Frauen
 +
*Männer
 +
*Sonstige
 +
*Tourist*innen
 +
*Pendler*innen
 +
*Sonstiges
 
|-
 
|-
| Ansprechpartner
+
| Verbundintegration
| Kontakt
+
| ist das Angebot in irgendeiner Form in den Verbund integriert (wahr/falsch)
| Kontaktinformationen
+
|}
 +
 
 +
==== Metainformation ====
 +
 
 +
{| class="table table-bordered table-sm sortable" style="font-size:small"
 +
! Feld
 +
! Kurzbeschreibung
 
|-
 
|-
 
| LetzterCheck
 
| LetzterCheck
| Metainformation
 
 
| wann wurde das Angebot zuletzt überprüft?
 
| wann wurde das Angebot zuletzt überprüft?
 
|-
 
|-
 
| Quelle
 
| Quelle
| Metainformation
 
 
| woher stammen die in der Datenbank vorhandenen Informationen? (Liste)
 
| woher stammen die in der Datenbank vorhandenen Informationen? (Liste)
 
|-
 
|-
 
| VAO ID
 
| VAO ID
| Metainformation
+
| unter welcher ID wurde der Bedarfsverkehr in die VAO aufgenommen (oder „eingebunden“, falls ID nicht verfügbar)
| unter welcher ID wurde der Bedarfsverkehr in die VAO aufgenommen
+
|}
 +
 
 +
==== Ort ====
 +
 
 +
{| class="table table-bordered table-sm sortable" style="font-size:small"
 +
! Feld
 +
! Kurzbeschreibung
 
|-
 
|-
 
| Bedienungsgebiet
 
| Bedienungsgebiet
| Ort
+
| mögliche Werte:
| mögliche Werte (wird automatisch auf Region gesetzt, wenn das Bedienungsgebiet mehr als eine Gemeinde umfasst):
 
 
*Gemeinde
 
*Gemeinde
 
*Region
 
*Region
 +
Wird automatisch auf Region gesetzt, wenn das Bedienungsgebiet mehr als eine Gemeinde umfasst.
 
|-
 
|-
 
| Bedienungsgebiet-GeoJSON
 
| Bedienungsgebiet-GeoJSON
| Ort
 
 
| Polygon des Bedienungsgebiets (für Bedarfsverkehre mit Flächenbetrieb)
 
| Polygon des Bedienungsgebiets (für Bedarfsverkehre mit Flächenbetrieb)
 
|-
 
|-
 
| Bedienungsgebiet-RelationID
 
| Bedienungsgebiet-RelationID
| Ort
 
 
| RelationID der Gemeindegrenzen auf OpenStreetMap
 
| RelationID der Gemeindegrenzen auf OpenStreetMap
 
|-
 
|-
 
| Bundesland
 
| Bundesland
| Ort
 
 
| Bundesland
 
| Bundesland
 
|-
 
|-
 
| GKZ
 
| GKZ
| Ort
 
 
| Gemeindekennzahl der betroffenen Gemeinden (Liste)
 
| Gemeindekennzahl der betroffenen Gemeinden (Liste)
 
|-
 
|-
| Lage
+
| Haltestellenkategorie
| Ort
+
| höchste Haltestellenkategorie (der ÖV-Güteklassen) im Bediengebiet
| Koordinaten eines Punkts im Bediengebiet
+
|-
 +
| Land
 +
| Land, in dem sich der Bedarfsverkehr befindet
 
|-
 
|-
| Ort
 
 
| Ort
 
| Ort
 
| betroffene Gemeinden (Liste)
 
| betroffene Gemeinden (Liste)
 
|-
 
|-
| BF
+
| Raumtyp
| Statistik
+
| 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]].
 +
 
 +
{| class="table table-bordered table-sm sortable" style="font-size:small"
 +
! Feld
 +
! Kurzbeschreibung
 +
|-
 +
| App-Anteil
 +
|
 +
|-
 +
| Beförderungsfälle
 
| Anzahl der Beförderungsfälle pro Jahr
 
| Anzahl der Beförderungsfälle pro Jahr
 
|-
 
|-
| BFjeEWJahr
+
| Beförderungsfälle je EinwohnerIn und Jahr
| Statistik
 
 
| Anzahl der Beförderungsfälle pro EinwohnerIn und Jahr
 
| Anzahl der Beförderungsfälle pro EinwohnerIn und Jahr
 
|-
 
|-
 
| Betriebsbeginn
 
| Betriebsbeginn
| Statistik
 
 
| Datum des Betriebsbeginns
 
| Datum des Betriebsbeginns
 +
|-
 +
| Besetztkilometer
 +
| jährlich besetzt gefahrene Kilometer
 
|-
 
|-
 
| Betriebsende
 
| Betriebsende
| Statistik
 
 
| Datum des Betriebsende (falls Angebot eingestellt)
 
| Datum des Betriebsende (falls Angebot eingestellt)
 
|-
 
|-
 
| Betriebskosten
 
| Betriebskosten
| Statistik
 
 
| jährliche Betriebskosten
 
| jährliche Betriebskosten
 
|-
 
|-
 
| BetriebskostenjeBF
 
| BetriebskostenjeBF
| Statistik
 
 
| durchschnittliche Betriebskosten je Beförderungsfall
 
| durchschnittliche Betriebskosten je Beförderungsfall
 +
|-
 +
| durchschnittliche gebuchte Reiseweite
 +
| Strecke, die ein Fahrgast durchschnittlich zurücklegen wollte
 +
|-
 +
| EinwohnerInnen im Bediengebiet
 +
| EinwohnerInnen im Bedienungsgebiet
 
|-
 
|-
 
| EinwohnerKat
 
| EinwohnerKat
| Statistik
 
 
| mögliche Werte:
 
| mögliche Werte:
 
*A unter 1.000
 
*A unter 1.000
Zeile 290: Zeile 328:
 
|-
 
|-
 
| EinwohnerTausend
 
| EinwohnerTausend
| Statistik
 
 
| EinwohnerInnen im Bedienungsgebiet (in Tausend)
 
| EinwohnerInnen im Bedienungsgebiet (in Tausend)
 
|-
 
|-
 
| Einwohnerzahl
 
| Einwohnerzahl
| Statistik
 
 
| EinwohnerInnen im Bedienungsgebiet
 
| EinwohnerInnen im Bedienungsgebiet
 +
|-
 +
| Fahrgäste je Fahrt
 +
|
 
|-
 
|-
 
| Fahrgeldeinnahmen
 
| Fahrgeldeinnahmen
| Statistik
 
 
| jährliche Fahrgeldeinnahmen
 
| jährliche Fahrgeldeinnahmen
 
|-
 
|-
| Gefahrene Kilometer
+
| Fahrgeldeinnahmen je Beförderungsfall
| Statistik
+
|
| jährlich zurückgelegte Kilometer
+
|-
 +
| Fahrzeugkilometer je Beförderungsfall
 +
| je Beförderungsfall zurückgelegte Fahrzeugkilometer
 +
|-
 +
| Fahrten
 +
| Anzahl der durchgeführten Fahrten je Jahr
 
|-
 
|-
| Gemeindefläche
+
| Fläche Bediengebiet
| Statistik
+
| Fläche des Bediengebiets in km²
| Fläche der Gemeinde
 
 
|-
 
|-
 
| Gemeindezahl
 
| Gemeindezahl
| Statistik
 
 
| Anzahl der betroffenen Gemeinden
 
| Anzahl der betroffenen Gemeinden
 
|-
 
|-
| Gästebeten
+
| Gästebetten
| Statistik
 
 
| Anzahl der Gästebetten in den betroffenen Gemeinden
 
| Anzahl der Gästebetten in den betroffenen Gemeinden
 
|-
 
|-
 
| Jahr
 
| Jahr
| Statistik
 
 
| Jahr des Betriebsbeginns
 
| Jahr des Betriebsbeginns
 
|-
 
|-
| Stand
+
| Kilometerleistung
| Statistik
+
| jährlich zurückgelegte Kilometer
| mögliche Werte:
+
|-
*geplant
+
| Kostendeckung
*in Umsetzung
+
| Anteil der Fahrgeldeinnahmen an den Gesamtkosten
*in Betrieb
+
|-
*eingestellt
+
| 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 ====
 +
 
 +
{| class="table table-bordered table-sm sortable" style="font-size:small"
 +
! Feld
 +
! Kurzbeschreibung
 
|-
 
|-
 
| Einzelticket
 
| Einzelticket
| Tarif
 
 
| Preis eines Einzeltickets
 
| Preis eines Einzeltickets
 
|-
 
|-
 
| EinzelticketPreissegment
 
| EinzelticketPreissegment
| Tarif
 
 
| Preissegment des Einzeltickets (ganzzahlige Rundung)
 
| Preissegment des Einzeltickets (ganzzahlige Rundung)
 
|-
 
|-
 
| ExklusiverVorverkauf
 
| ExklusiverVorverkauf
| Tarif
 
 
| sind Tickets nur im Vorverkauf erhältlich (wahr/falsch)
 
| sind Tickets nur im Vorverkauf erhältlich (wahr/falsch)
 
|-
 
|-
 
| Jahreskarte
 
| Jahreskarte
| Tarif
 
 
| Preis einer Jahreskarte
 
| Preis einer Jahreskarte
 
|-
 
|-
 
| Monatskarte
 
| Monatskarte
| Tarif
 
 
| Preis einer Monatskarte
 
| Preis einer Monatskarte
 
|-
 
|-
 
| Tageskarte
 
| Tageskarte
| Tarif
 
 
| Preis einer Tageskarte
 
| Preis einer Tageskarte
 
|-
 
|-
| Tarifmodell
+
| Tarifanmerkungen
| Tarif
+
| Textfeld zur Beschreibung tariflicher Besonderheiten
 +
|-
 +
| Vorverkauf
 +
| Anmerkungen zum Vorverkauf
 +
|-
 +
| Wochenkarte
 +
| Preis einer Wochenkarte
 +
|}
 +
 
 +
==== nicht mehr verfügbare Datenbankfelder (oder deprecated) ====
 +
 
 +
{| class="table table-bordered table-sm sortable" style="font-size:small"
 +
! 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:
 
| mögliche Werte:
 
*Nulltarif
 
*Nulltarif
Zeile 363: Zeile 450:
 
*Vielnutzungstarife
 
*Vielnutzungstarife
 
|-
 
|-
| Tarifanmerkungen
+
| <s>Merkmal</s>
| Tarif
+
| <s>besondere Merkmale, z.B. Einsatz eines Elektrofahrzeugs oder ÖPNV-Tarifintegration</s>
| Textfeld zur Beschreibung tariflicher Besonderheiten
 
|-
 
| Wochenkarte
 
| Tarif
 
| Preis einer Wochenkarte
 
 
|-
 
|-
 +
| <s>Kontakt</s>
 +
| <s>Angaben zur Kontaktperson</s>
 
|}
 
|}

Aktuelle Version vom 25. Oktober 2023, 14:48 Uhr

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