cityImage.get_historical_buildings_fromOSM#

cityImage.get_historical_buildings_fromOSM(place, download_method, epsg=None, distance=1000)[source]#

The function downloads and cleans building footprint geometries and create a buildings GeoDataFrames for the area of interest. However, it only keeps the buildings that are considered historical buildings or heritage buildings in OSM.

Parameters:

  • place (str, tuple, Shapely Polygon) – Name of cities or areas in OSM: - when using “distance_from_point” please provide a (lat, lon) tuple to create the bounding box around it; - when using “distance_from_address” provide an existing OSM address; - when using “OSMplace” provide an OSM place name. The query must be geocodable and OSM must have polygon boundaries for the geocode result. - when using “polygon” please provide a Shapely Polygon in unprojected latitude-longitude degrees (EPSG:4326) CRS;

  • download_method (str, {"distance_from_address", "distance_from_point", "OSMplace", "polygon"}) – It indicates the method that should be used for downloading the data.

  • epsg (int) – Epsg of the area considered; if None OSMNx is used for the projection.

  • distance (float) – Used when download_method == “distance from address” or == “distance from point”.

Returns:

historic_buildings – The historic buildings GeoDataFrame.

Return type:

Polygon GeoDataFrame