transitio.MobilityDatabase.search_feeds

transitio.MobilityDatabase.search_feeds#

MobilityDatabase.search_feeds(aoi=None, *, country_code=None, subdivision=None, municipality=None, status='active', official_only=False, enclosure='partially_enclosed', limit=100)#

Search GTFS feeds in the Mobility Database catalog.

Parameters:

  • aoi (geometry or tuple, optional) – Area of interest: a shapely geometry, a GeoDataFrame/GeoSeries, or a (minx, miny, maxx, maxy) tuple in WGS84. Reduced to its bounding box for the API query.

  • country_code (str, optional) – ISO 3166-1 alpha-2 country code filter.

  • subdivision (str, optional) – Subdivision (state/region) name filter.

  • municipality (str, optional) – Municipality name filter.

  • status (str or None, default "active") – Keep only feeds with this catalog status; None disables the filter.

  • official_only (bool, default False) – Keep only feeds marked official by the operator.

  • enclosure ({"partially_enclosed", "completely_enclosed"}) – How feed extents must relate to the AOI bounding box.

  • limit (int, default 100) – Maximum number of matching feeds to return.

Return type:

list of Feed

Notes

Without a refresh token this method falls back to the Mobility Database CSV catalogue export (with a UserWarning): feed discovery still works, but historical dataset versions and hosted validation reports need the API and therefore a token.