A partner must provide us with one and only one feed set, and it must conform to
GBFS V2.2 for
either docked or dockless systems. The set must include only one of each file.
For example, it must contain only one
station_information.json. Because of the
file limit, the following constraints exist for a given feed set:
- The feed set is limited to a single set of GBFS files that have the fields
defined in the local language of the city it covers, where appropriate. For
example, if a feed covers both the United Kingdom and Germany,
stations.namemust contain the station name in English for stations located in the United Kingdom and in German for the stations located in Germany.
- The feed set must be comprehensive for the metro areas it covers. Google allows sharding of feeds where necessary. Each shard must cover a geographical service area at least the size of a metro area or larger. For more information about sharding, refer to Feed sharding.
Structured data type definitions
To successfully build your feed, you must adhere to the applicable set of structured data type definitions that we provide. In the GBFS definitions, all the files in GBFS V2.2 are listed with indications of which systems they're applicable for in the header with the following permutations:
- Docked system
- Dockless system
- Docked and dockless system
For example, if the provider uses a dockless system, you must only provide files
that are indicated for
Dockless system or
Dockless and docked systems
to describe the system. For more information, refer to
Supported micromobility systems.
Each section in the GBFS definitions provides the structured data type definitions that you need to successfully build a complete feed. It includes the definitions and instructions specific to the provider-type for the feed.