Lamassu

Mobility aggregation service based on the General Bikeshare Feed Specification (GBFS) v2.1-RC2.

Configuration

resources/feedproviders.yml lists GBFS feeds which will be polled by this application:

    lamassu:
        providers:
          - url: https://myfavoritegbfsfeeed.com/gbfs.json
            name: My favorite mobility provider
            codespace: MFM
            city: Atlantis
            vehicleType: Rover
            language: en

This will use the GBFS auto-discovery at url and poll en language feeds.

End-points

`/gbfs`

List all GBFS feeds available via this API

`/gbfs/{identifier}/{feed}`

GBFS feeds for a specific feed provider with a unique identifier.

E.g.

/gbfs/boltoslo/free_bike_status

will return the free_bike_status feed for Bolt's scooter service in Oslo.

`/graphql`

GraphQL endpoint targeted at end-user clients. Documentation can be explored at /graphiql.

Development

Requires a locally running redis instance. E.g.:

docker run -p 127.0.0.1:6379:6379 -d redis redis-server

Deployment

Deployed with helm+harness+terraform.

Accessible via Entur API (e.g. https://api(-env).entur.io/mobility/v2/).

thewhitewizard/lamassu