GeofabrikDownloader.get_catalogue(update=False, confirmation_required=True, verbose=False)[source]

Get a catalogue (index) of all available downloads.

Similar to the method get_download_index().

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

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

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


a catalogue for all subregion downloads

Return type:

pandas.DataFrame | None


>>> from pydriosm.downloader import GeofabrikDownloader

>>> gfd = GeofabrikDownloader()

>>> # A download catalogue for all subregions
>>> dwnld_catalog = gfd.get_catalogue()

>>> type(dwnld_catalog)
>>> dwnld_catalog.head()
               subregion  ...                                           .osm.bz2
0                 Africa  ...
1             Antarctica  ...
2                   Asia  ...
3  Australia and Oceania  ...
4        Central America  ...
[5 rows x 6 columns]

>>> dwnld_catalog.columns.to_list()


  • Information of LondonEnfield is not directly available from the web page of Greater London.

  • Two subregions have the same name ‘Georgia’: EuropeGeorgia and USGeorgia; In the latter case, a suffix ‘ (US)’ is appended to the name in the table.