General requirements
Stay organized with collections
Save and categorize content based on your preferences.
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[].name must 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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2023-10-03 UTC."],[[["Partners must provide a single GBFS V2.2 feed set, either docked or dockless, with only one instance of each file (like `station_information.json`)."],["The feed set should use the local language for fields like station names and must comprehensively cover the entire metro area(s) it serves, utilizing sharding for larger regions if needed."],["Partners must adhere to Google's structured data type definitions, ensuring the chosen GBFS files align with their specific system type (docked, dockless, or both)."],["Detailed structured data type definitions and instructions for building a complete feed are available in Google's GBFS definitions documentation."]]],["Partners must provide one GBFS V2.2 compliant feed set, containing only one of each file type, applicable to either docked or dockless systems. Feeds are limited to one language per field, based on the city's local language. The feed set must be comprehensive for each metro area served. Sharding is permitted, with each shard covering at least a metro area. Providers must adhere to provided structured data type definitions, referencing system-specific files for docked, dockless, or both systems.\n"]]