GeofabrikDownloader.get_download_index

GeofabrikDownloader.get_download_index(update=False, confirmation_required=True, verbose=False, raise_error=False, **kwargs)

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

Similar to 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

• raise_error (bool) – Whether to raise the provided exception; if raise_error=False (default), the error will be suppressed.

Returns:

the official index of all downloads

Return type:

pandas.DataFrame | None

Examples:

>>> from pydriosm.downloader import GeofabrikDownloader
>>> gfd = GeofabrikDownloader()
>>> download_index = gfd.get_download_index()
>>> type(download_index)
pandas.core.frame.DataFrame
>>> download_index.shape
(512, 12)
>>> download_index.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]
>>> download_index.columns.to_list()
['id',
 'parent',
 'iso3166-1:alpha2',
 'name',
 'iso3166-2',
 'geometry',
 '.osm.pbf',
 '.osm.bz2',
 '.shp.zip',
 'pbf-internal',
 'history',
 'taginfo',
 'updates']