Skip to main content

NE Loader

CI

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="..."

Some commands include:
List cached datasets.

ne-loader list

Query where the cached datasets are.
If you change NATURAL_EARTH_CACHE_DIR, the command shows the active cache path for the current environment.

ne-loader where

Download a Natural Earth Dataset. Default resolution is 10m.

ne-loader download {category} {name} --res {res}

Example usage to download 10m_admin_0_countries

ne-loader download cultural admin_0_countries

Delete either one dataset or all, from current cache directory.

ne-loader rm {dataset}
# or
ne-loader rm --all

Tests

python3 -m pytest tests

License

MIT

Metadata

Release files for ne-loader 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ne-loader 0.4.1
File Size Uploaded Provenance Actions
ne_loader-0.4.1.tar.gz 8.7 kB With provenance Details for ne_loader-0.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ne-loader 0.4.1
File Interpreter ABI Platform Actions
ne_loader-0.4.1-py3-none-any.whl Python 3 none any Details for ne_loader-0.4.1-py3-none-any.whl

Total release size: 15.7 kB

Release files / ne_loader-0.4.1.tar.gz

Download URL ne_loader-0.4.1.tar.gz
Size 8.7 kB
Tags Source
SHA-256 checksum
How to use checksums
3bc79140cdb71b813605ac80713c82f0642c90832bb16c937071320f842842ef
BLAKE2b-256 checksum
How to use checksums
609270645e51630301c2351072a0595693d1aaeef72172e1beea25bee902bf7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.

Transparency log

Release files / ne_loader-0.4.1-py3-none-any.whl

Download URL ne_loader-0.4.1-py3-none-any.whl
Size 7.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
111e55e2953db2a201fdf575c784975e3b4d25678413ac0652376b4d581c7395
BLAKE2b-256 checksum
How to use checksums
96f220cf8011a2850ce7269378afd7207317dc8c06022751d105db6259fa7417
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.

Transparency log

Security for ne-loader 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ne_loader-0.4.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page