GeofabrikDownloader.get_subregion_download_url

GeofabrikDownloader.get_subregion_download_url(subregion_name, osm_file_format, update=False, verbose=False)

Get a download URL of a geographic region.

Parameters

  • subregion_name (str) – name of a geographic region available on Geofabrik free download server

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

  • update (bool) – whether to (check on and) update the package data, defaults to False

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

Returns

name and URL of the subregion

Return type

tuple

Examples:

>>> from pydriosm.downloader import GeofabrikDownloader

>>> geofabrik_downloader = GeofabrikDownloader()

>>> geo_region_name = 'England'
>>> osm_file_fmt = ".pbf"

>>> fml_name, dwnld_link = geofabrik_downloader.get_subregion_download_url(
...     subregion_name=geo_region_name, osm_file_format=osm_file_fmt)

>>> print(fml_name)  # The name of the subregion on the free downloader server
England
>>> print(dwnld_link)  # The URL to the PBF data file
https://download.geofabrik.de/europe/great-britain/england-latest.osm.pbf

>>> geo_region_name = 'Britain'
>>> osm_file_fmt = ".shp"

>>> fml_name, dwnld_link = geofabrik_downloader.get_subregion_download_url(
...     subregion_name=geo_region_name, osm_file_format=osm_file_fmt)

>>> print(fml_name)
Great Britain
>>> print(dwnld_link)
None