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 following research projects and organisations:

BMWE funded      GLOW-Up

(back to top)

Metadata

Release files for orthophotos-downloader 1.0.2

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.2
File Size Uploaded Provenance Actions
orthophotos_downloader-1.0.2.tar.gz 243.5 kB With provenance Details for orthophotos_downloader-1.0.2.tar.gz

Built distribution (wheel)

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

Total release size: 261.3 kB

Release files / orthophotos_downloader-1.0.2.tar.gz

Download URL orthophotos_downloader-1.0.2.tar.gz
Size 243.5 kB
Tags Source
SHA-256 checksum
How to use checksums
329a1a540831673720dbf105e73c961b0bd8662930b2767d14206c5bb4f20e51
BLAKE2b-256 checksum
How to use checksums
e63251848293cf55452fc1fb16cce89a9bcc6b7a5f5b23ac08e271b4a4073a90
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 Jul 31, 2026.

Transparency log

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

Download URL orthophotos_downloader-1.0.2-py3-none-any.whl
Size 17.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
87f7a8c9f8b6da86556ba70d70a4061e6ec0a01212482a85df5a662cdc3ee47c
BLAKE2b-256 checksum
How to use checksums
8e163ab6353176e9a6ae61e2ce0888045645c0ee0477666bb6c29a6b129758ff
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 Jul 31, 2026.

Transparency log

Security for orthophotos-downloader 1.0.2

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.2.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 31, 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