GeofabrikDownloader.get_catalogue

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

Get a catalogue (index) of all available downloads.

Similar to the method get_download_index().

Parameters:

  • 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 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

Examples:

>>> from pydriosm.downloader import GeofabrikDownloader

>>> gfd = GeofabrikDownloader()

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

>>> type(dwnld_catalog)
pandas.core.frame.DataFrame
>>> dwnld_catalog.head()
               subregion  ...                                           .osm.bz2
0                 Africa  ...  https://download.geofabrik.de/africa-latest.os...
1             Antarctica  ...  https://download.geofabrik.de/antarctica-lates...
2                   Asia  ...  https://download.geofabrik.de/asia-latest.osm.bz2
3  Australia and Oceania  ...  https://download.geofabrik.de/australia-oceani...
4        Central America  ...  https://download.geofabrik.de/central-america-...
[5 rows x 6 columns]

>>> dwnld_catalog.columns.to_list()
['subregion',
 'subregion-url',
 '.osm.pbf',
 '.osm.pbf-size',
 '.shp.zip',
 '.osm.bz2']

Note

  • 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.