vbb hafas

vbb-hafas

Клиент службы общественного транспорта Берлина и Бранденбурга (VBB). Он действует как последовательный и простой интерфейс поверх подробного API.

На самом деле этот проект представляет собой тонкую оболочку hafas-client@6 . Его документы документируют API в целом.

Примечание . Возможно, вы не захотите самостоятельно запрашивать API VBB. vbb-client — это API-совместимый клиент для vbb-rest , моего API-оболочки. Это также работает в браузере.

Установка

npm install vbb-hafas

API

Ознакомьтесь с документацией hafas-client , а также его настройками, специфичными для VBB.

Использование

 const createHafas = require ( 'vbb-hafas' )

const hafas = createHafas ( 'my-awesome-program' )

В качестве примера мы будем искать путешествие из Центрального вокзала Берлина в Берлин-Шарлоттенбург . Чтобы получить идентификаторы станций, используйте 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 .

Содействие

Если у вас есть вопрос , вы обнаружили ошибку или хотите предложить новую функцию , загляните на страницу проблем.