Your Quickest Route to VBN

Frequently Asked Questions (FAQ)

The Quickest Route to Expert Advice. In the FAQs you will find all of the answers to the most common questions to VBN.

Show more

24h Information Service

Response to your individual concern. This is how you can reach us by telephone, email and post:

24h Information Service: 04 21/59 60 59
Administration: 04 21/59 60 0
Email: info[at]vbn.de

Show more

Timetable and price information

Show timetables

Verkehrshinweise

Informieren Sie sich hier über aktuelle Fahrplanänderungen für den Zugverkehr und für den Bus- und Straßenbahnverkehr, aufgrund von Baustellen und Umleitungen im VBN-Gebiet, die länger als 24 Stunden bestehen.

Zugverkehr

Bus- und Straßenbahnverkehr

Timetable and price information

Show timetables

Verkehrshinweise

Informieren Sie sich hier über aktuelle Fahrplanänderungen für den Zugverkehr und für den Bus- und Straßenbahnverkehr, aufgrund von Baustellen und Umleitungen im VBN-Gebiet, die länger als 24 Stunden bestehen.

Zugverkehr

Bus- und Straßenbahnverkehr

Developer Information

Open data and service at VBN

The VBN provides schedule and infrastructure data to interested application developers as both raw datasets (Open Data) and as an online service (Open Service). 

While Open Data is primarily schedule data, Open Service differs in that a complete service (e.g. for route calculation) is offered.

Both may be used freely.

Providing target data in GTFS format (Open Data) 

Connect Fahrplanauskunft GmbH provides public transport schedule data in GTFS format, so-called target data. This data is available for all of Bremen and Lower Saxony.

The target data includes:

  • Name and website of participating public transport companies
  • Information on the availability of connections (daily, only on business days, etc.)
  • Information on the journey, e.g., operator, line, means of transport
  • Geographic coordinates of stops and journeys
  • Departure and arrival times of journeys
  • Directory of stops (in planning: displaying information on accessibility)

Target data is updated regularly and provided for download at night.

GTFS stands for „General Transit Feed Specification“. Further information about GTFS is provided by Google at: https://developers.google.com/transit/gtfs/

If you are interested in having target data processed digitally, you may request this from Connect Fahrplanauskunft GmbH: https://www.connect-fahrplanauskunft.de/index.php?id=opendata

Example of an excerpt of "trips.txt"

[Translate to English:] "route_id","service_id","trip_id","trip_headsign","trip_short_name","direction_id","block_id","shape_id","wheelchair_accessible","bikes_allowed"
[…]
35738_0,209,112931443,"Hauptbahnhof","",0,3376,9879,1,
35738_0,209,112931444,"Hauptbahnhof","",0,3377,9879,1,
35738_0,209,112931445,"Hauptbahnhof","",0,3378,9879,1,
35738_0,209,112931446,"Bremen Humboldtstraße","",0,3379,9878,1,
35738_0,209,112931447,"Bremen Humboldtstraße","",0,3380,9878,1,
35738_0,209,112931448,"Bremen Humboldtstraße","",0,3381,9878,1,
35738_0,646,112931449,"Hastedt/Bennigsenstr.","",0,3382,9884,1,
35738_0,646,112931450,"Hastedt/Bennigsenstr.","",0,3383,9884,1,
[…]

Providing real-time information in GTFS-Realtime (Open Data) format

In addition, for certain connections, we also offer forecast data (on-time departure and arrival or delay in minutes) in GTFS-Realtime format. Forecast data provided for journeys and the number of participating transport companies is regularly expanded.

We offer forecast data in both JSON and Protobuf formats.
JSON format: http://gtfsr.vbn.de/gtfsr_connect.json (license information)
Protobuf format: http://gtfsr.vbn.de/gtfsr_connect.bin (license information)

Example of an excerpt of GTFS real-time data in JSON format

[Translate to English:] {
"header": {
            "gtfs_realtime_version": "1.0",
            "timestamp": 1572433553
                                   },
"entity": [
           {
            "id": "113533777",
            "trip_update": {
              "trip": { 
                        "trip_id": "113533777",
                        "start_time": "11:06:00",
                        "start_date": "20191030",
                        "schedule_relationship": "SCHEDULED",
                        "route_id": "35731_3"
              },
              "stop_time_update": [
                {  
                    "stop_sequence": 0,
                    "departure": {
                                    "delay": 0
                    },
                    "stop_id": "000009014179",
                    "schedule_relationship": "SCHEDULED"
                }, 
                {  
                    "stop_sequence": 1,
                    "arrival": {
                                    "delay": 6
                    },
                    "departure": {
                                    "delay": 24
                    },
                    "stop_id": "000009014007",
                    "schedule_relationship": "SCHEDULED"
                },
[…]

Further information on these formats:
JSON: https://de.wikipedia.org/wiki/JavaScript_Object_Notation
protobuf: https://developers.google.com/protocol-buffers/

This data is updated and made available every 60 seconds (the file name will not change).
GTFS real-time data reference the (static) GTFS data.

Providing calculated information (Open Service)

Unlike OpenData, OpenService can provide individual data for requests. Like OpenData, this data is also intended to be used in applications and cannot be read directly by humans. We offer various „RESTful Web Services“ via our FahrPlaner (Journey Planner), and application, OpenTripPlanner (OTP). „OTP Routing API“ can be used to calculate multimodal routes and isochrons (access map).

External OTP API documentation: http://dev.opentripplanner.org/apidoc/1.4.0/
Address of our OTP API server: http://gtfsr.vbn.de/api/ (Lizenzhinweis)

An API key is required for authorisation and is available free of charge. Send us an email at api(at)vbn.de with a brief description of your proposal and we will provide your API key.

External tutorial in English for finding routes and preparing isochrons: http://docs.opentripplanner.org/en/v1.5.0/Intermediate-Tutorial/

Example of a route planning request by our OTP API server using cURL

[Translate to English:] curl -X GET \
  'http://gtfsr.vbn.de/api/routers/connect/plan?arriveBy=false&date=07-25-2019&fromPlace=53.08287,8.81334&toPlace=53.05270,8.78617&time=13:00:00&mode=WALK,TRANSIT&maxWalkDistance=300' \
  -H 'Authorization: Ihr-API-Key' \
  -H 'Host: gtfsr.vbn.de' \

The request will search for a route between Bremen Central Station and Bremen Airport on 25 July 2019, departure at 1:00 PM with public transport and a maximum walking distance of 300 metres.

[Translate to English:] […]
{   
      "startTime": 1572437160000,
      "endTime": 1572438150000,
      "departureDelay": 0,
      "arrivalDelay": 30,
      "realTime": true,
      "distance": 3898.2546804280105,
      "pathway": false,
      "mode": "TRAM",
      "route": "6",
      "agencyName": "Bremer Straßenbahn AG",
      "agencyUrl": "http://www.bsag.de/",
      "agencyTimeZoneOffset": 3600000,
      "routeColor": "ffcc00",
      "routeType": 0,
      "routeId": "1:35757_0",
      "routeTextColor": "FFFFFF",
      "interlineWithPreviousLeg": false,
      "headsign": "Flughafen",
      "agencyId": "326",
      "tripId": "1:113544932",
      "serviceDate": "20191030",
      "from": {
          "name": "Bremen Hauptbahnhof",
          "stopId": "1:000009013925",
          "lon": 8.813231,
          "lat": 53.081757,
          "arrival": 1572437159000,
          "departure": 1572437160000,
          "zoneId": "100-1100|VBN-VBN|Bremen-1100",
          "stopIndex": 13,
          "stopSequence": 13,
          "vertexType": "TRANSIT",
          "boardAlightType": "DEFAULT"
      },
[…]

HAFAS ReST Interface Services and TRIAS (OpenService)

In addition to OTP API, we may also offer HAFAS ReST Interface Services and TRIAS (VDV-431-2) to a limited number of users. As for OTP API, this will require an API-Key. The OTP API-Key cannot be used.

We provide the following types of requests of HaCon as ReST Interface:

  • ReST interface connections (from stop ID to stop ID)
  • ReST interface departure and arrival tables (from stop ID)
  • ReST interface location validation request (Patternmatching of stops)
  • ReSt interface stop search
  • ReST interface connections (coordinate to coordinate with a linear distance estimate)
  • ReST interface connections extended by real-time data (from stop ID to stop ID)

HAFAS ReST Interface-Services have been extended to be used in accordance with VDV-431-2 (TRIAS). HaCon offers TRIAS support for the following services:

  • TRIAS LocationInformation (nearby stops with radius)
  • TRIAS LocationInformation (Patternmatching)
  • TRIAS Trip (connection search)
  • TRIAS StopEvents (departure tables)

Interface users

  • Students or hobby developers within quotas
  • Service providers who want to sell VBN tickets via this system

For all interface customers, the following applies:

  • The starting point and destination must be in Lower Saxony or Bremen.
  • Only VBN fares may be transferred via the interface.
  • Every transaction must be performed exactly as requested by the customer. Mass requests not initiated by a customer request are not permitted and will be fully applied to the quota quantity structure of the student’s or hobby developer’s solution.
  • Use of the interface by transport companies or transport associations or their subsidiaries requires separate agreements where usage exceeds the hobby user flat fee. Multiple accounts of a person/organisation are excluded and must be agreed separately.

Quota quantity structure for the student and hobby developer flat fee

  • Up to 3000 transactions per day, including hosting (with no Service Level Agreement (SLA)). Departure table transactions will only be counted as 1/5th of a transaction.

Example of use of HAFAS ReST API
HAFAS ReST API URL: https://fahrplaner.vbn.de/restproxy/
Example of request of "location.name" called "Bremen Hbf"
Request description/requirements: https://fahrplaner.vbn.de/restproxy/location.details?wadl

Request using cURL

[Translate to English:] curl -X POST \
  https://fahrplaner.vbn.de/restproxy/location.name \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -H 'Host: fahrplaner.vbn.de' \
  -d 'accessId=Ihr-API-Key&input=Bremen%20Hbf'

Example of use of HAFAS ReST API
HAFAS TRIAS API URL: https://fahrplaner.vbn.de/triasproxy/
Example of request of „LocationInformationRequest“ called “Bremen Hbf”

Request using cURL

[Translate to English:] curl -X POST \
  https://fahrplaner.vbn.de/triasproxy/ \
  -H 'Content-Type: application/xml' \
  -H 'Host: fahrplaner.vbn.de' \
  -d '<Trias xmlns:siri="http://www.siri.org.uk/siri" xmlns="http://www.vdv.de/trias" xmlns:ns3="http://www.ifopt.org.uk/acsb" xmlns:ns4="http://www.ifopt.org.uk/ifopt" xmlns:ns5="http://datex2.eu/schema/1_0/1_0" version="1.2">
  <ServiceRequest>
  <siri:RequestTimestamp>2019-07-25T12:00:00+01:00</siri:RequestTimestamp>
  <siri:RequestorRef>ihr-API-Key</siri:RequestorRef>
  <Language>deu</Language>
  <RequestPayload>
  <LocationInformationRequest>
  <InitialInput>
  <LocationName>Bremen Hbf</LocationName>
  </InitialInput>
  </LocationInformationRequest>
  </RequestPayload>
  </ServiceRequest>
  </Trias>'

License information and liability disclaimer 

We provide data and services and do not assume any guarantee for the contents. “Real-time information in GTFS-Realtime (OpenData) format” and “legitimate information from GTFS data (OpenService)” is provided by stating the license - provided under the same conditions, „CC BY-SA 4.0“. Further information about licenses is available at: https://creativecommons.org/licenses/by-sa/4.0/legalcode.de

The “providing of real-time information in GTFS-Realtime (OpenData) format” and “providing of calculated information from GTFS data (OpenService)” are funded by the German Federal Ministry of Transport and Digital Infrastructure [Bundesministerium für Verkehr und digitale Infrastruktur (BMVI)] under Funding Code 16DKV10025 as part of the 2017-2020 Immediate Action Programme for Clean Air.

Funded by