This package provides polygons/multipolygons for all countries and their sub-divisions from the GADM dataset. It fetches the data dynamically from the officially hosted database using DataDeps.jl.
Get the latest stable release with Julia's package manager:
] add GADM
GADM.get
returns polygons/multipolygons, which implement the GeoInterface:
import GADM
# GADM.get(<country>, <province/state>, <district>, <city>, ...)
# get boundary of the country India
india = GADM.get("IND")
# get boundary of the state/province Uttar Pradesh in India
uttar = GADM.get("IND", "Uttar Pradesh")
# get boundary of the district Lucknow in Uttar Pradesh, India
lucknow = GADM.get("IND", "Uttar Pradesh", "Lucknow")
The option depth=n
can be used to return a table of polygons for all subregions at depth n
:
states = GADM.get("BRA", depth=1)
cities = GADM.get("BRA", depth=2)
- Country Code follows the ISO 3166 Alpha 3 standard, you can find the code for your country here.
- Other regions require "approximately" official names that are at least contained (case-insensitive) in the official name.
The coordinate reference system is longitude/latitude and the WGS84 datum.
GADM, the Database of Global Administrative Areas, is a high-resolution database of country administrative areas, with a goal of "all countries, at all levels, at any time period." The database is available in a few export formats, including shapefiles that are used in most common GIS applications.
Please read their license at https://gadm.org/license.html which is different than the MIT license of the GADM.jl package.