package to get boundaries data from GADM, the database of global Administrative Areas.
Project description
📝 GADM
This library provides all countries's national and prefectural boundaries in the form of geopandas dataframe, by dynamically fetching from GADM dataset.
:gear: Installation
pip install gadm
:running: How to Run
Basic usage
import geopandas as gpd
from gadm import GADMDownloader
downloader = GADMDownloader(version="4.0")
country_name = "Vietnam"
ad_level = 0
gdf = downloader.get_shape_data_by_country_name(country_name=country_name, ad_level=ad_level)
assert isinstance(gdf, gpd.GeoDataFrame)
gdf.plot()
Use with visualization library
GADM's data frame can be interactively visualized on a jupyter notebook with folium
import folium as fl
import geopandas as gpd
from gadm import GADMDownloader
downloader = GADMDownloader(version="4.0")
country_name = "Vietnam"
ad_level = 1
gdf = downloader.get_shape_data_by_country_name(country_name=country_name, ad_level=ad_level)
m = fl.Map(zoom_start=10, tiles="OpenStreetMap")
for _, r in gdf.iterrows():
sim_geo = gpd.GeoSeries(r["geometry"]).simplify(tolerance=0.001)
geo_j = sim_geo.to_json()
geo_j = fl.GeoJson(data=geo_j, style_function=lambda x: {"fillColor": "orange"})
fl.Popup(r["VARNAME_1"]).add_to(geo_j)
geo_j.add_to(m)
m
Download satellite images based on boundaries from gadm
Check the following example
🎛 Development Environment
conda env create --file environment.yml
conda activate gadm
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
gadm-0.0.5.tar.gz
(5.6 kB
view details)
Built Distribution
gadm-0.0.5-py3-none-any.whl
(5.7 kB
view details)
File details
Details for the file gadm-0.0.5.tar.gz
.
File metadata
- Download URL: gadm-0.0.5.tar.gz
- Upload date:
- Size: 5.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d1679687f5bd9d22607534f32ce1481057f21d7217c0749efc2a48e4dcdf991c |
|
MD5 | ce00538128ff37e5b5d8b14feffba503 |
|
BLAKE2b-256 | c15a36aae4867be617c50492a950e207d8aa410f65b4b791eee82c0231644a8b |
File details
Details for the file gadm-0.0.5-py3-none-any.whl
.
File metadata
- Download URL: gadm-0.0.5-py3-none-any.whl
- Upload date:
- Size: 5.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.18
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 49dabda07eb61c77d2870333abad78544d91bec312ce2101d52b3d6a1cc5475b |
|
MD5 | 57c2f849b8d5a95453f6609f3b04fb51 |
|
BLAKE2b-256 | 7c82230755217bdd849196c017c18cd1f4549ac81f3e89625ebab4403d5038cd |