عميل لخدمة النقل العام في برلين وبراندنبورغ (VBB). إنها بمثابة واجهة متسقة ومباشرة أعلى واجهة برمجة التطبيقات المطولة.
هذا المشروع هو في الواقع غلاف رقيق حول hafas-client@6
. توثق مستنداتها واجهة برمجة التطبيقات (API) بشكل عام.
ملاحظة : قد لا ترغب في الاستعلام عن واجهة برمجة تطبيقات VBB بنفسك. vbb-client
هو عميل متوافق مع واجهة برمجة التطبيقات (API) لـ vbb-rest
، واجهة برمجة تطبيقات المجمع الخاصة بي. كما أنه يعمل في المتصفح.
npm install vbb-hafas
تحقق من المستندات بحثًا عن hafas-client
بالإضافة إلى التخصيصات الخاصة بـ VBB.
const createHafas = require ( 'vbb-hafas' )
const hafas = createHafas ( 'my-awesome-program' )
على سبيل المثال، سوف نبحث عن رحلة من Berlin Hauptbahnhof إلى Berlin Charlottenburg . للحصول على معرفات المحطة، استخدم vbb-stations
.
hafas . journeys ( '900000003201' , '900000024101' , { results : 1 } )
. then ( ( journeys ) => console . log ( journeys [ 0 ] ) )
. catch ( console . error )
سيكون الناتج عبارة عن مجموعة من كائنات journey
بتنسيق Friendly Public Transport Format 1.2.1
:
[ {
legs : [ {
tripId : '1|50420|0|86|25122017' ,
direction : 'Brandenburg, Hbf' ,
line : {
type : 'line' ,
id : '10' ,
name : 'RE1' ,
public : true ,
mode : 'train' ,
product : 'regional' ,
symbol : 'RE' ,
nr : 1 ,
metro : false ,
express : true ,
night : false ,
class : 64 ,
productCode : 6 ,
operator : {
type : 'operator' ,
id : 'db-regio-ag' ,
name : 'DB Regio AG'
}
} ,
origin : {
type : 'station' ,
id : '900000003201' ,
name : 'S+U Berlin Hauptbahnhof' ,
location : {
type : 'location' ,
latitude : 52.52585 ,
longitude : 13.368928
} ,
products : {
suburban : true ,
subway : true ,
tram : true ,
bus : true ,
ferry : false ,
express : true ,
regional : true
}
} ,
departure : '2017-12-26T00:41:00.000+01:00' ,
plannedDeparture : '2017-12-26T00:41:00.000+01:00' ,
departureDelay : 0 ,
departurePlatform : '14' ,
plannedDeparturePlatform : '13' ,
destination : {
type : 'station' ,
id : '900000024101' ,
name : 'S Charlottenburg' ,
location : {
type : 'location' ,
latitude : 52.504806 ,
longitude : 13.303846
} ,
products : {
suburban : true ,
subway : false ,
tram : false ,
bus : true ,
ferry : false ,
express : false ,
regional : true
}
} ,
arrival : '2017-12-26T00:50:00.000+01:00' ,
plannedArrival : '2017-12-26T00:50:00.000+01:00' ,
arrivalDelay : null ,
arrivalPlatform : '4' ,
plannedArrivalPlatform : '4'
} ] ,
// all these are from the first leg
origin : {
type : 'station' ,
id : '900000003201' ,
name : 'S+U Berlin Hauptbahnhof'
// …
} ,
departure : '2017-12-26T00:41:00.000+01:00' ,
plannedDeparture : '2017-12-26T00:41:00.000+01:00' ,
departureDelay : 0 ,
departurePlatform : '14' ,
plannedDeparturePlatform : '13' ,
// all these are from the last leg
destination : {
type : 'station' ,
id : '900000024101' ,
name : 'S Charlottenburg'
// …
} ,
arrival : '2017-12-26T00:50:00.000+01:00' ,
plannedArrival : '2017-12-26T00:50:00.000+01:00' ,
arrivalDelay : null ,
arrivalPlatform : '4' ,
plannedArrivalPlatform : '4'
// …
} ]
سيحاول vbb-hafas
إضافة معلومات النقل من vbb-change-positions
إذا قمت بتمرير transferInfo: true
كخيار.
إذا حددت عملية نقل معروفة، فسيكون للمرحلة السابقة bestArrivalPosition
، وسيكون للمرحلة التالية موضع departurePosition
، مما يشير إلى النقل الأمثل بين كلا النظامين. تحقق من العلامات في vbb-change-positions
لمزيد من التفاصيل.
قم بالاطلاع على المشاريع المتعلقة hafas-client
.
إذا كان لديك سؤال ، أو وجدت خطأً أو تريد اقتراح ميزة ، فقم بإلقاء نظرة على صفحة المشكلات.