Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/derhuerst/bvg-rest

An HTTP API for Berlin & Brandenburg public transport.
https://github.com/derhuerst/bvg-rest

api berlin bvg public-transport

Last synced: 5 days ago
JSON representation

An HTTP API for Berlin & Brandenburg public transport.

Host: GitHub
URL: https://github.com/derhuerst/bvg-rest
Owner: derhuerst
License: isc
Created: 2018-08-01T21:35:56.000Z (over 6 years ago)
Default Branch: 6
Last Pushed: 2024-01-26T16:40:48.000Z (10 months ago)
Last Synced: 2024-10-10T00:44:43.311Z (about 1 month ago)
Topics: api, berlin, bvg, public-transport
Language: JavaScript
Homepage: https://v6.bvg.transport.rest/
Size: 155 KB
Stars: 84
Watchers: 5
Forks: 4
Open Issues: 2
Metadata Files:
- Readme: readme.md
- License: license.md

Awesome Lists containing this project

README

        # bvg-rest

***bvg-rest* is a public transport REST API**, a clean alternative to the [BVG HAFAS API](https://github.com/public-transport/hafas-client/blob/6/p/bvg/readme.md). It is deployed at [`v6.bvg.transport.rest`](https://v6.bvg.transport.rest/).

[**API documentation**](docs/readme.md)

![bvg-rest architecture diagram](architecture.svg)

[![API status](https://badgen.net/uptime-robot/status/m793274554-6cf10d741ce5352cc2a6d65f)](https://stats.uptimerobot.com/57wNLs39M/793274554)

![ISC-licensed](https://img.shields.io/github/license/derhuerst/bvg-rest.svg)

[![support me via GitHub Sponsors](https://img.shields.io/badge/support%20me-donate-fa7664.svg)](https://github.com/sponsors/derhuerst)

[![chat with me on Twitter](https://img.shields.io/badge/chat%20with%20me-on%20Twitter-1da1f2.svg)](https://twitter.com/derhuerst)

## installing & running

### access to Redis

It is recommended that you let `bvg-rest` cache HAFAS responses within a [Redis](https://redis.io/) cache. To use this feature, set `$REDIS_URL` (e.g. to `redis://localhost:6379/1` when running Redis locally).

### via Docker

A Docker image [is available as `derhuerst/bvg-rest:6`](https://hub.docker.com/r/derhuerst/bvg-rest).

```shell

docker run -d -p 3000:3000 derhuerst/bvg-rest:6

```

*Note:* The Docker image does not contain the Redis server.

### manually

```shell

git clone https://github.com/derhuerst/bvg-rest.git

cd bvg-rest

git checkout 6

npm install

export HOSTNAME='my-vbb-rest-api.example.org'

npm run build

redis-server &

npm start

```

To keep the API running permanently, use tools like [`forever`](https://github.com/foreverjs/forever#forever) or [`systemd`](https://wiki.debian.org/systemd).

## Related Projects

- [`vbb-modules`](https://github.com/derhuerst/vbb-modules) – List of JavaScript modules for Berlin & Brandenburg public transport.

- [`bvg-hafas`](https://github.com/public-transport/bvg-hafas) – JavaScript client for the BVG HAFAS API.

- [`db-rest`](https://github.com/derhuerst/db-rest) – A clean REST API wrapping around the Deutsche Bahn API.

- [`hvv-rest`](https://github.com/derhuerst/hvv-rest) – A clean REST API wrapping around the HVV API.

- [`hafas-rest-api`](https://github.com/public-transport/hafas-rest-api) – Expose a HAFAS client via an HTTP REST API.

- [`hafas-client`](https://github.com/public-transport/hafas-client) – JavaScript client for HAFAS public transport APIs.

## Contributing

If you have a question or need support using `bvg-rest`, please double-check your code and setup first. If you think you have found a bug or want to propose a feature, refer to [the issues page](https://github.com/derhuerst/bvg-rest/issues).