cityImage.water_barriers#

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

The function downloads water bodies from OSM. Lakes, rivers and see coastlines can be considered structuring barriers.

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.

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

  • float (lakes_area =) – Minimum area for lakes to be considered.

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

Returns:

water_barriers – The water barriers GeoDataFrame.

Return type:

LineString GeoDataFrame