GBFS (General Bikeshare Feed Specification)

GBFS is a standardized format for bikeshare system data. Cassiopeia handles the standard GBFS format automatically with custom data models designed for bikeshare systems.

Note: GBFS mappings are provided as part of Cassiopeia. Any issues with GBFS processing should be reported as Cassiopeia system bugs rather than mapping configuration problems.

GBFS Format

GBFS consists of JSON files that define bikeshare system information:

  • gbfs.json — General feed information

  • station_information.json — Bikeshare stations

  • station_status.json — Real-time station status

  • free_bike_status.json — Free-floating bike locations

  • system_information.json — System metadata

  • vehicle_types.json — Available vehicle types

Available Mappings

Cassiopeia provides pre-built mappings for GBFS entities using custom data models (GbfsStation, GbfsVehicle, etc.) that follow GBFS v2.3:

| Entity | Source | Key Mappings | GbfsStation | station_information + station_status | station_id → identity, lat/lon → location, capacity, numVehiclesAvailable | GbfsVehicle | free_bike_status | bike_id/vehicle_id → identity, lat/lon → location, vehicleType → relationship | GbfsVehicleType | vehicle_types.json | vehicle_type_id → identity, form_factor, propulsion_type | GbfsSystemInformation | system_information.json | system_id → identity, name, operator, timezone | GbfsRegion | system_regions.json | region_id → identity, name, boundary

Key Features

  • Multi-source integration — Station information and status are merged into complete station entities

  • Default value handling — Supports both legacy bike_id and newer vehicle_id fields

  • Relationship modeling — Vehicles link to vehicle types and stations

  • Real-time support — Designed for frequent status updates

Running the Example

cassiopeia map gbfs -i data/gbfs/GbfsBicikeLJ.json -o output --validation-representation concise
cassiopeia map gbfs -i data/gbfs/GbfsDottStuttgart.json -o output --validation-representation concise
cassiopeia map gbfs -i data/gbfs/GbfsVoiDE.json -o output --validation-representation concise

Troubleshooting

  • Invalid GBFS format — Ensure files follow GBFS v2.3 specification

  • Missing required fields — GBFS requires certain fields to be present

  • Coordinate issues — Verify lat/lon values are valid numbers

  • Version compatibility — Ensure data uses GBFS v2.3 format