get_aoi_wkt#
- get_aoi_wkt(aoi_path: str | CloudPath | Path, as_str: bool = True) str | Polygon [source]#
Get AOI formatted as a WKT from files that can be read by Fiona (like shapefiles, …) or directly from a WKT file. The use of KML has been forced (use it at your own risks !).
See: https://fiona.readthedocs.io/en/latest/fiona.html#fiona.open
It is assessed that:
only one polygon composes the AOI (as only the first one is read)
it should be specified in lat/lon (WGS84) if a WKT file is provided
- Parameters:
aoi_path (AnyPathStrType) – Absolute or relative path to an AOI. Its format should be WKT or any format read by Fiona, like shapefiles.
as_str (bool) – If True, return WKT as a str, otherwise as a shapely geometry
- Returns:
AOI formatted as a WKT stored in lat/lon
- Return type:
Union[str, Polygon]
Example
>>> path = "path/to/vec.geojson" # OK with ESRI Shapefile, geojson, WKT, KML... >>> get_aoi_wkt(path) 'POLYGON Z ((46.1947755465253067 32.4973553439109324 0.0000000000000000, 45.0353174370802520 32.4976496856158974 0.0000000000000000, 45.0355748149750283 34.1139970085580018 0.0000000000000000, 46.1956059695554089 34.1144793800670882 0.0000000000000000, 46.1947755465253067 32.4973553439109324 0.0000000000000000))'