Skip to content

jsem-nerad/mapovac

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mapovač: Stahování map z Mapy.com

Mapovač je CLI nástroj, který umožňuje generovat kvalitní, na míru oříznuté mapové snímky s využitím API Mapy.com.

 ██████   ██████                                                            
░░██████ ██████                                                             
 ░███░█████░███   ██████   ████████   ██████  █████ █████  ██████    ██████ 
 ░███░░███ ░███  ░░░░░███ ░░███░░███ ███░░███░░███ ░░███  ░░░░░███  ███░░███
 ░███ ░░░  ░███   ███████  ░███ ░███░███ ░███ ░███  ░███   ███████ ░███ ░░░ 
 ░███      ░███  ███░░███  ░███ ░███░███ ░███ ░░███ ███   ███░░███ ░███  ███
 █████     █████░░████████ ░███████ ░░██████   ░░█████   ░░████████░░██████ 
░░░░░     ░░░░░  ░░░░░░░░  ░███░░░   ░░░░░░     ░░░░░     ░░░░░░░░  ░░░░░░  
                           ░███                                             
                           █████                                            
                          ░░░░░

Hlavní funkce

  • Přesné měřítko: Nastavte si úroveň přiblížení (zoom 0–20) a získejte okamžitou informaci o fyzické velikosti (metry na dlaždici) pro danou zeměpisnou šířku.
  • Flexibilní formáty: Podpora různých poměrů stran – od čtverce až po 16:9 nebo tiskový formát A4 (nebo vlastní poměr stran).
  • Caching: Stažené dlaždice se ukládají do složky ~/.mapovac/cache/, takže opakované generování stejné oblasti nespotřebuje žádné kredity.
  • Trvalé nastavení: Nástroj si pamatuje vaše poslední zadané hodnoty (souřadnice, zoom, API klíč), takže při dalším spuštění stačí jen potvrzovat klávesou Enter.
  • TUI i CLI režim: Interaktivní rozhraní pro lidi a parametry příkazové řádky pro automatizaci.

Instalace

  1. Klonování repozitáře:

    git clone <repo-url>
    cd mapovac
  2. Příprava prostředí:

    python3 -m venv venv
    ./venv/bin/pip install -r requirements.txt

Použití

Interaktivní režim (TUI)

Stačí spustit skript bez parametrů. Program vás provede nastavením:

./venv/bin/python3 mapovac.py

Automatizovaný režim (CLI)

Pro rychlé spuštění s konkrétními parametry:

./venv/bin/python3 mapovac.py --lat 50.0755 --lon 14.4378 --size 2 --zoom 16 --aspect 1.777 --output praha.png

Argumenty:

  • --lat, --lon: Souřadnice středu mapy.
  • --size: Šířka mapy v kilometrech.
  • --zoom: Úroveň přiblížení (0-20).
  • --aspect: Poměr stran (šířka/výška).
  • --output: Název výsledného souboru.

API Klíč

Pro fungování aplikace potřebujete API klíč od Seznam.cz. Můžete ho získat zdarma na developer.mapy.com. Aplikace se vás na něj zeptá při prvním spuštění a uloží ho do ~/.mapovac/config.json.

⚖️ Licence a citace

Tento nástroj využívá dlaždice Mapy.com. Při používání výsledných snímků prosím dodržujte podmínky Seznam.cz a uvádějte povinnou citaci:

© Seznam.cz a.s. a další

About

CLI nástroj pro generaci obrázků z dlaždic Mapy.com

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages