Skip to main content

package to get boundaries data from GADM, the database of global Administrative Areas.

Project description

PyPi PyPi Build Status

📝 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

folium map sample

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)

Uploaded Source

Built Distribution

gadm-0.0.5-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

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

Hashes for gadm-0.0.5.tar.gz
Algorithm Hash digest
SHA256 d1679687f5bd9d22607534f32ce1481057f21d7217c0749efc2a48e4dcdf991c
MD5 ce00538128ff37e5b5d8b14feffba503
BLAKE2b-256 c15a36aae4867be617c50492a950e207d8aa410f65b4b791eee82c0231644a8b

See more details on using hashes here.

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

Hashes for gadm-0.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 49dabda07eb61c77d2870333abad78544d91bec312ce2101d52b3d6a1cc5475b
MD5 57c2f849b8d5a95453f6609f3b04fb51
BLAKE2b-256 7c82230755217bdd849196c017c18cd1f4549ac81f3e89625ebab4403d5038cd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page