GeofabrikDownloader.get_subregion_download_url

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

Get a download URL of a geographic region.

Parameters

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

  • osm_file_format (str) – OSM file format available on the free download server; valid values include ".osm.pbf", ".shp.zip" and ".osm.bz2"

  • update (bool) – whether to check on update and proceed to 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()

>>> region_name  = 'london'
>>> file_format = '.pbf'

>>> fml_name, dwnld_link = geofabrik_downloader.get_subregion_download_url(
...     region_name, file_format)

>>> print(fml_name)
Greater London
>>> print(dwnld_link)
http://download.geofabrik.de/.../greater-london-latest.osm.pbf

>>> region_name  = 'Great Britain'
>>> file_format = '.shp'

>>> fml_name, dwnld_link = geofabrik_downloader.get_subregion_download_url(
...     region_name, file_format)

>>> print(fml_name)
Greater London
>>> print(dwnld_link)
None