Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- mapa_tech [2012/01/06 07:54] – upraveno mimo DokuWiki 127.0.0.1
+++ mapa_tech [2026/10/12 10:16] (aktuální) – upraveno mimo DokuWiki 127.0.0.1
@@ Řádek 1: / Řádek 1: @@
 ====== Technický popis map ======
-Mapy se stahují a ukládají jako malé obrázky o rozměru 256x256 bodů, nazývané kachle (tiles). Každá kachle má jednoznačný název ((cesta ke kachli je považována za součást názvu)), který je definován jejími souřadnicemi a měřítkem.
+a:Drake (od verze 6.14) vykresluje všechny mapy knihovnou [[https://github.com/mapsforge/mapsforge|Mapsforge]]. Podporuje dva základní druhy map:
-Mapy mohou být uloženy dvěma způsoby:
+  * **rastrové (dlaždicové) mapy** – mapa je složená z obrázků 256×256 bodů, tzv. dlaždic (tiles). Dlaždice se stahují z internetu (OpenStreetMap, Mapy.cz, Google, vlastní zdroj) a automaticky ukládají pro off-line použití. Lze použít i předem připravenou off-line mapu.
-  * [[mapa_tech#mapy_jako_jednotlive_soubory|Jednotlivé soubory]] - původní metoda, náročnější na prostor na paměťové kartě
+  * **vektorové mapy Mapsforge** – soubor ''.map'' s popisem objektů, který se vykresluje přímo v telefonu podle zvoleného **tématu**. Na velké území zabírají výrazně méně místa. Více v kapitole [[user:vektorove_mapy|Vektorové mapy]].
-  * [[mapa_tech#mapy_v_databazi|Databáze]] ve formátu BigPlanet/RMaps - od verze 1.4.5
-Oba typy map nelze kombinovat, aktivní může být vždy pouze jeden. Je ale možné mít mapy v obou formátech a přepínat mezi nimi.
+Nastavení map je v **Nastavení → Mapy → Upravit nastavení map**. Změny se ukládají do souboru ''map-config.xml'' (viz níže), ručně ho upravovat není potřeba.
-===== Mapy jako jednotlivé soubory =====
+====== Kde jsou mapy uložené ======
+  * **Datová složka aplikace** se volí v Nastavení (//Interní (zařízení)//, //Externí (SD karta)// nebo //Jiné//). Standardně jde o privátní složku aplikace, např. ''/storage/emulated/0/Android/data/cz.adrake/files''. Do ní a:Drake ukládá databázi, ''map-config.xml'' i podsložku ''maps'' s rastrovými dlaždicemi.
+  * **Vektorové mapy a témata** se od verze 6.14 vybírají přes systémový výběr souborů (Storage Access Framework). Soubory tak mohou ležet **kdekoli** v zařízení nebo na SD kartě (např. ''Download'' nebo ''Documents''), není nutné je kopírovat do datové složky. a:Drake si přístup k vybranému souboru zapamatuje; pokud oprávnění zanikne (např. po přesunu souboru), vyzve k novému výběru.
-Kachle se ukládají se jako jednotlivé soubory do pevně dané struktury složek, která byla zvolena tak, aby odpovídala programům [[http://geokuk.ic.cz/|GeoKuk]] resp. [[http://mobac.dnsalias.org/|Mobile Atlas Creator]] (formát OSM Tile Storage).
+====== Rastrové mapy ======
+Každá vrstva rastrové mapy má vlastní databázi SQLite s příponou ''.sqlitedb'' (tabulky ''tiles'' se sloupci ''x'', ''y'', ''z'', ''s'', ''image'' a ''info'' s rozsahem měřítek). Formát odpovídá formátu RMaps/BigPlanet SQLite, který používá i Locus a který umí vytvořit [[https://mobac.sourceforge.io/|Mobile Atlas Creator]] (MobAC). MobAC používá pevný název //BigPlanet_maps.sqlitedb//, pro použití v a:Drake je třeba soubor přejmenovat podle nastavení vrstvy (viz //Soubor/technický název//).
-Podsložka KACHLE je určená pro mapy.cz stažené GeoKukem, mapy typu Google a spol. se ukládani přímo do složky uvedené v nastavení, ve které se založí podložky podle parametrů v map-config.xml. Popis konfiguračního souboru je v kapitole [[mapy|Zdroje map]].
+Pokud vrstva nemá vyplněné URL, jde o **off-line mapu** – nic se nestahuje, jen se čte z databáze (v seznamu map je označená //(offline)//).
-Pokud bude složka pro mapy \Storage Card\PocketDrake, pak v ní mohou být tyto složky
+==== Umístění souboru vrstvy ====
+Položka **Soubor/technický název** (''<file>'') určuje databázi vrstvy:
+^ Obsah ''<file>'' ^ Skutečný soubor ^
+| ''osm/mapnik'' | ''<datová složka>/maps/osm/mapnik.sqlitedb'' |
+| ''/storage/emulated/0/Locus/mapsOnline/mapa.sqlitedb'' | absolutní cesta, včetně přípony |
+| ''content:%%//%%…'' | soubor vybraný přes systémový výběr souborů |
-|KACHLE     |to je pro mapy.cz z GeoKuku|
+:!: Pokud se u existující vrstvy změní úložiště nebo soubor, stávající dlaždice se nepřevádějí.
-|google\map |základní mapa Google|
-|google\terr|terénní mapa Google|
-|cykloatlas | |
-atd...
+====== Soubor map-config.xml ======
+''map-config.xml'' leží v datové složce aplikace. Při prvním spuštění se vytvoří výchozí verze (OpenStreetMap, Google Maps, Mapy.cz a vektorové mapy Mapsforge). Pokud je soubor poškozený, a:Drake ho přejmenuje na ''.bak'' a vytvoří nový výchozí. Soubor lze také přenášet z/do PC přes [[spolupracepc|GeoGet Sync]].
-V těchto složkách jsou pak další podsložky podle zoomu atd, tak, jak je Mobile Atlas Creator vytvoří.
+^Tag             ^^^^Popis ^
+|**aDrake**   ||||povinná obálka|
+| |**MapSource**    |||zdroj mapy, v aplikaci se zobrazí jako volba zdroje|
+| | |**type**  ||typ zdroje\\ ''Google'' … dlaždice ve schématu Slippy Map (OSM, Google, Mapy.cz a většina dalších), URL obsahuje ''{x}'', ''{y}'', ''{z}''\\ ''MapsForge'' … vektorové mapy Mapsforge|
+| | |**name**  ||název pro zobrazení|
+| | | |//language// |jazyk názvu; pokud se shoduje s jazykem telefonu, použije se. Měl by existovat i jeden název bez jazyka jako výchozí.|
+| | |**storage**  ||uložení dlaždic, používá se ''database'' (jeden soubor SQLite na vrstvu)|
+| | |**requestHeader**  ||nepovinná dodatečná hlavička HTTP požadavku, např. ''Referer''|
+| | |**MapType**  ||vrstva mapy (libovolný počet základních, max. 5 překryvných v jednom zdroji)|
+| | | |//mode// |''basic'' … základní mapa, přepíná se mezi nimi\\ ''overlay'' … překryvná vrstva (turistické trasy apod.), lze zapnout více najednou|
+| | | |**name** |název vrstvy|
+| | | |**file** |rastrová vrstva: soubor/technický název databáze (viz výše)\\ vektorová vrstva: soubor ''.map''|
+| | | |**themeFile** |vektorová vrstva: ZIP archiv s tématy (Elevate, OpenAndroMaps …)|
+| | | |**themes** |seznam témat nalezených v ZIP archivu, atribut //selected// = index vybraného tématu (doplňuje aplikace)|
+| | | |**theme** |vektorová vrstva: starší způsob – cesta k samostatnému XML tématu|
+| | | |**url** |URL dlaždic; ''{x}'', ''{y}'' = souřadnice dlaždice, ''{z}'' = zoom, ''{s}'' = znak subdomény. Prázdné URL = off-line mapa.|
+| | | |**subdomain** |znaky dosazované za ''{s}'' (např. ''abc'' nebo ''0123'')|
+| | | |**invertY** |''true'' pro zdroje s obrácenou osou Y (schéma TMS)|
+| | | |**defaultZoom** |počáteční zoom při prvním otevření mapy|
+| | | |**minZoom** |nejmenší povolený zoom|
+| | | |**maxAvailZoom** |největší zoom dostupný ke stažení z internetu|
+| | | |**maxZoom** |největší povolený zoom|
-Podobně GeoKuk ukládá mapy do nastavené složky (nastavuje se přes Soubor-Umístění souborů). Její obsah lze překopírovat do PDA.
+Ukázka vrstvy:
+<code xml>
+<MapSource>
+  <type>Google</type>
+  <name>Open Street Map</name>
+  <storage>database</storage>
+  <MapType mode="basic">
+    <name>Mapnik</name>
+    <file>osm/mapnik</file>
+    <url>https://tile.openstreetmap.org/{z}/{x}/{y}.png</url>
+    <subdomain></subdomain>
+    <defaultZoom>14</defaultZoom>
+    <minZoom>1</minZoom>
+    <maxAvailZoom>18</maxAvailZoom>
+    <maxZoom>18</maxZoom>
+  </MapType>
+</MapSource>
+</code>
-{{:maps_copy.gif|}}
+Další vzorová nastavení pro různé zdroje map najdete ve [[user:zdroje_map|wiki části dokumentace]] (část příkladů pochází ze starších verzí a zdroje se mohly změnit). Při používání on-line map respektujte podmínky jejich poskytovatelů.
-===== Mapy v databázi =====
-Od verze 1.4.5 podporuje PocketDrake ukládání kachlí do databáze. Každý mapový zdroj má vlastní databázi, její název je definován v souboru map-config.xml, přípona souboru je pdmap.
-Formát je shodný s formátem BigPlanet SQLite. který je možné vytvářet v programu [[http://mobac.dnsalias.org/|Mobile Atlas Creator]]. MobAC používá fixní název databáze //BigPlanet_maps.sqlitedb//, pro přenos do PockeDrake je třeba ji přejmenovat. Mapu vytvořenou v PocketDrake lze pomocí MobAC doplnit a nahrát zpět, opět je třeba soubor přejmenovávat.
-Stejný formát je možné použít i pro mapy.cz, ale tam melze použít MobAC. PocketDrake je schopen kachle stahovat a do databáze ukládat, můžete vyzkoušet [[download#vytvareni_map|jednoduché udělátko]] na převod kachlí ze souborů do databáze.
-===== Pravidla pro vykreslování a zoomování =====
-Pokud je v nastavení povoleno **Rozšířené vykreslování**, program se pokusí v případě, že požadovaná kachle schází najít náhradu podle jednoduchého pravidla:\\
-Prohledej typy map v pořadí, jak jsou definované (a jak se vypisují v nastavení) zdola nahoru, pokud najdeš kachli pro stejné souřadnice  měřítko, použij ji.
-Při změně měřítka mapy (zoom) se postupuje odlišně podle toho, zda se přibližuje nebo vzdaluje((Tato funkce je použitelná až po registraci)):
-  * Pokud se vzdaluje a předchozí měřítko mělo kachle k dispozici, použijí se zmenšené na 50%. V tomto případě se použijí pouze kachle z měřítka o jeden stupeň vyššího, pokud by se šlo dále, klesal by výkon vykreslování a výsledek by stejně nebyl příliš použitelný.
-  * Pokud se přibližuje, hledá se nejbližší menší stupeň přiblížení, ve kterém je kachle k dispozici, z té se vyřízne potřebná část a zvětší na správnou velikost.
-Je-li povolené stahování z internetu a kachle pro zvolené měřítko existují, postupně se na pozadí stáhnou a obraz se zaostří.