Skip to main content

orthophotos-downloader

PyPI version License

Python wrapper for various available WMS services to simplify the download of orthophotos. Currently focused on Germany.
Explore the docs »

· Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Sponsoring

About The Project

Orthophotos provide a high-precision data foundation for various applications in remote sensing – from environmental research to urban planning. However, Germany's federal structure means that each state has its own services and interfaces for providing this data, making nationwide usage cumbersome and complex.

With this software, we offer a central, user-friendly solution that allows users to download orthophotos independently of the respective state services. The software will support various data formats, including RGB and RGBI, and enable flexible geographical queries.

(back to top)

Installation

To install the package from PyPi simply use:

pip install orthophotos-downloader

Getting Started for developers

As an alternative to installing the package from PyPi and if want to contribute, develop or just play around, clone the repo and install from there.

  1. Clone the repo
    git clone https://github.com/ffe-munich/orthophotos-downloader.git
    
  2. Setup a venv with python > 3.9
    python3.11 -m  venv "venv" 
    source venv/bin/activate
    
  3. Pip install
    pip install .        
    

(back to top)

Usage

You can find an example of usage in this notebook in the examples folder You can find a test to download in any state (i.e. "Bundesland") inside this script in the examples folder

(back to top)

Roadmap

  • Interface to give an area overlapping different wms services -> In Progress
  • Command Line Interface
  • Have a doc being generated
  • Integrate all WMS in germany
  • RGBI Download

See the open issues for a full list of proposed features (and known issues).

(back to top)

Coverage in Germany by Federal State (Bundesländer)

Bundesland RGB CIR
Saarland ✅ ✅
Mecklenburg-Vorpommern ✅ ✅
Rheinland-Pfalz ✅ ✅
Sachsen ✅ ✅
Thüringen ✅ ✅
Sachsen-Anhalt ✅
Nordrhein-Westfalen ✅ ✅
Hessen ✅ ✅
Hamburg ✅ ✅
Bremen ✅
Brandenburg ✅ ✅
Niedersachsen ✅
Schleswig-Holstein ✅
Bayern ✅ ✅
Berlin ✅
Baden-Württemberg ✅ ✅

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

Top contributors:

contrib.rocks image

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Sponsoring

This project was developed with the support of the research project GLOW-Up. GLOW-Up is funded by the Federal Ministry for Economic Affairs and Energy (BMWE) as part of the 8th Energy Research Program.

GLOW-Up      BMWE funded

(back to top)

Metadata

Release files for orthophotos-downloader 1.0.3

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

Source distribution (sdist)

Source distribution for orthophotos-downloader 1.0.3
File Size Uploaded Provenance Actions
orthophotos_downloader-1.0.3.tar.gz 404.4 kB With provenance Details for orthophotos_downloader-1.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for orthophotos-downloader 1.0.3
File Interpreter ABI Platform Actions
orthophotos_downloader-1.0.3-py3-none-any.whl Python 3 none any Details for orthophotos_downloader-1.0.3-py3-none-any.whl

Total release size: 422.3 kB

Release files / orthophotos_downloader-1.0.3.tar.gz

Download URL orthophotos_downloader-1.0.3.tar.gz
Size 404.4 kB
Tags Source
SHA-256 checksum
How to use checksums
c38cd8c9ec7f44a995b21ede51f9c515049b80a5290a194e4e40bce7f719e32f
BLAKE2b-256 checksum
How to use checksums
8279865a67169475a5acd5cf72c693a75efbd7207eb0c17d017b8ddb2f87684d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.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 Oct 2, 2026.

Transparency log

Release files / orthophotos_downloader-1.0.3-py3-none-any.whl

Download URL orthophotos_downloader-1.0.3-py3-none-any.whl
Size 17.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a733857a79b7f092538e344a95cbf7817b1680eb73326c831b2fd6a1c997b64a
BLAKE2b-256 checksum
How to use checksums
c64b86e9b721bb24ec782439b86bd278eddd5df9bcc0f34ff037bdc9a8ae3bfb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.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 Oct 2, 2026.

Transparency log

Security for orthophotos-downloader 1.0.3

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 orthophotos_downloader-1.0.3.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 Oct 2, 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