BBBikeDownloader.get_subregion_download_url

BBBikeDownloader.get_subregion_download_url(subregion_name, osm_file_format, **kwargs)[source]

Get a valid URL for downloading OSM data of a specific file format for a geographic (sub)region.

Parameters:
  • subregion_name (str) – name of a (sub)region available on BBBike free download server

  • osm_file_format (str) – file format/extension of the OSM data available on the download server

Returns:

a valid name of subregion_name and a download URL for the given osm_file_format

Return type:

tuple

Examples:

>>> from pydriosm.downloader import BBBikeDownloader

>>> bbd = BBBikeDownloader()

>>> subrgn_name = 'birmingham'
>>> file_format = "pbf"

>>> # Get a valid subregion name and its download URL
>>> subrgn_name_, dwnld_url = bbd.get_subregion_download_url(subrgn_name, file_format)
>>> subrgn_name_
'Birmingham'
>>> dwnld_url
'https://download.bbbike.org/osm/bbbike/Birmingham/Birmingham.osm.pbf'

>>> file_format = "csv.xz"
>>> subrgn_name_, dwnld_url = bbd.get_subregion_download_url(subrgn_name, file_format)

>>> subrgn_name_
'Birmingham'
>>> dwnld_url
'https://download.bbbike.org/osm/bbbike/Birmingham/Birmingham.osm.csv.xz'