GeofabrikDownloader.get_download_index

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

Get the official index of downloads for all available geographic (sub)regions.

Similar to the method get_catalogue().

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 | int) – whether to print relevant information in console, defaults to False

Returns:

the official index of all downloads

Return type:

pandas.DataFrame | None

Examples:

>>> from pydriosm.downloader import GeofabrikDownloader

>>> gfd = GeofabrikDownloader()

>>> # Official index of all available downloads
>>> geofabrik_dwnld_idx = gfd.get_download_index()
>>> type(geofabrik_dwnld_idx)
pandas.core.frame.DataFrame
>>> geofabrik_dwnld_idx.head()
            id  ...                                            updates
0  afghanistan  ...  https://download.geofabrik.de/asia/afghanistan...
1       africa  ...       https://download.geofabrik.de/africa-updates
2      albania  ...  https://download.geofabrik.de/europe/albania-u...
3      alberta  ...  https://download.geofabrik.de/north-america/ca...
4      algeria  ...  https://download.geofabrik.de/africa/algeria-u...
[5 rows x 13 columns]

>>> geofabrik_dwnld_idx.columns.to_list()
['id',
 'parent',
 'iso3166-1:alpha2',
 'name',
 'iso3166-2',
 'geometry',
 '.osm.pbf',
 '.osm.bz2',
 '.shp.zip',
 'pbf-internal',
 'history',
 'taginfo',
 'updates']