ne-loader 0.3.1

A simple loader for Natural Earth map data.

NE Loader

A simple, robust Python package to download and load Natural Earth map data using GeoPandas.

Features

• Download and cache Natural Earth datasets
• Load shapefiles as GeoDataFrames

Installation

pip install ne-loader

Usage

from ne_loader import map_loader
world = map_loader.get_natural_earth('cultural', 'admin_0_countries')

Errors are raised by default. To return the caught exception instead:

result = map_loader.get_natural_earth(
    'cultural',
    'admin_0_countries',
    error_mode='return',
)

CLI

ne-loader --help

To set an environment override for the NE data save path:

export NATURAL_EARTH_CACHE_DIR="..."

Tests

python3 -m pytest tests

License

MIT