GeofabrikDownloader.get_subregion_table

GeofabrikDownloader.get_subregion_table(url, verbose=False)

Get download information for all geographic regions on a web page.

Parameters

• url (str) – URL to the web resource

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

Returns

a table of all available subregions’ URLs

Return type

pandas.DataFrame or None

Example:

>>> from pydriosm.downloader import GeofabrikDownloader

>>> geofabrik_downloader = GeofabrikDownloader()

>>> gb_url = 'https://download.geofabrik.de/europe/great-britain.html'

>>> subregion_tbl = geofabrik_downloader.get_subregion_table(gb_url)

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

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

>>> subregion_tbl.head()
  Subregion  ...                                           .osm.bz2
0   England  ...  https://download.geofabrik.de/europe/great-bri...
1  Scotland  ...  https://download.geofabrik.de/europe/great-bri...
2     Wales  ...  https://download.geofabrik.de/europe/great-bri...
[3 rows x 6 columns]

>>> a_url = 'https://download.geofabrik.de/antarctica.html'

>>> subregion_tbl = geofabrik_downloader.get_subregion_table(a_url, verbose=True)
Collecting download information for "Antarctica" ... Checked out.
No more subregion data is available on the page 'https://download.geofabrik.de/...'.

>>> type(subregion_tbl)
NoneType