GeofabrikDownloader.get_download_catalogue

GeofabrikDownloader.get_download_catalogue(update=False, confirmation_required=True, verbose=False)

Get a catalogue of download information.

Similar to the method .get_download_index().

Parameters

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

  • confirmation_required (bool) – whether asking for confirmation to proceed, defaults to True

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

Returns

a catalogue for all subregion downloads

Return type

pandas.DataFrame or None

Example:

>>> from pydriosm.downloader import GeofabrikDownloader

>>> geofabrik_downloader = GeofabrikDownloader()

>>> # A download catalogue for all subregions
>>> downloads_catalogue = geofabrik_downloader.get_download_catalogue()

>>> type(downloads_catalogue)
pandas.core.frame.DataFrame

>>> downloads_catalogue.head()
      Subregion  ...                                           .osm.bz2
0       Algeria  ...  https://download.geofabrik.de/africa/algeria-l...
1        Angola  ...  https://download.geofabrik.de/africa/angola-la...
2         Benin  ...  https://download.geofabrik.de/africa/benin-lat...
3      Botswana  ...  https://download.geofabrik.de/africa/botswana-...
4  Burkina Faso  ...  https://download.geofabrik.de/africa/burkina-f...
[5 rows x 6 columns]

>>> downloads_catalogue.columns.tolist()
['Subregion',
 'SubregionURL',
 '.osm.pbf',
 '.osm.pbf.Size',
 '.shp.zip',
 '.osm.bz2']