BBBikeDownloader.get_subregion_download_catalogue

BBBikeDownloader.get_subregion_download_catalogue(subregion_name, confirmation_required=True, verbose=False)[source]

Get a download catalogue of OSM data available for a geographic region.

Parameters

  • subregion_name (str) – name of a geographic region (case-insensitive) available on BBBike’s free download server

  • confirmation_required (bool) – whether to prompt a message for confirmation to proceed, defaults to True

  • verbose (bool or int) – whether to print relevant information in console, defaults to False

Returns

a catalogues for subregion downloads

Return type

pandas.DataFrame or None

Example:

>>> from pydriosm.downloader import BBBikeDownloader

>>> bbbike_downloader = BBBikeDownloader()

>>> sr_name = 'leeds'

>>> leeds_dwnld_cat = bbbike_downloader.get_subregion_download_catalogue(
...     subregion_name=sr_name, verbose=True)
Confirmed to collect the download catalogue for Leeds? [No]|Yes: yes
In progress ... Done.

>>> print(leeds_dwnld_cat.head())
                             Filename  ...          LastUpdate
0                       Leeds.osm.pbf  ... 2020-09-25 10:04:25
1                        Leeds.osm.gz  ... 2020-09-25 15:11:49
2                   Leeds.osm.shp.zip  ... 2020-09-25 15:33:10
3  Leeds.osm.garmin-onroad-latin1.zip  ... 2020-09-25 17:49:15
4         Leeds.osm.garmin-onroad.zip  ... 2020-09-25 17:49:04

[5 rows x 5 columns]