Rozdíly

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

--- mapa_tech [2012/12/20 21:19] – ludekv
+++ 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:
+  * **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.
+  * **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]].
-Každý mapový zdroj má vlastní databázi, její název je definován v souboru map-config.xml, přípona souboru je sqlitedb.
+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.
-Formát je shodný s formátem Locus resp. BigPlanet/RMaps 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 a:Drake je třeba ji přejmenovat. Mapu vytvořenou v a:Drake lze pomocí MobAC doplnit a nahrát zpět, opět je třeba soubor přejmenovávat.
+====== 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.
-Stejný formát je možné použít i pro mapy.cz, ale tam nelze použít MobAC.
+====== 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//).
-====== 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)//).
-Zdroje map se nastavují v souboru map-config.xml umístěném v instalační složce aplikace.
-^Tag             ^^^^Popis ^
+==== Umístění souboru vrstvy ====
-|**aDrake**   ||||povinná obálka|
+Položka **Soubor/technický název** (''<file>'') určuje databázi vrstvy:
-| |**MapSource**    |||definice zdroje mapy, použije se k vytvoření combo boxu|
+^ Obsah ''<file>'' ^ Skutečný soubor ^
-| | |**type** 	 ||typ zdroje
+| ''osm/mapnik'' | ''<datová složka>/maps/osm/mapnik.sqlitedb'' |
-  UTM33  ... systém kachlí vycházející z UTM (zóna 33), názvy kachlí jsou třeba
+| ''/storage/emulated/0/Locus/mapsOnline/mapa.sqlitedb'' | absolutní cesta, včetně přípony |
-_8078000_83c8000 apod. Používají mapy.cz.
+| ''content:%%//%%…'' | soubor vybraný přes systémový výběr souborů |
-  Google ... systém Google Maps, Open Street Map a řady dalších, používá SlippyMapTiles,
-             názvy kachlí obsahují třeba x=8882&y=5505&z=14
-|
-| | |**name** 	||název pro zobrazení|
-| | | |//language//	|jazyk, ve kterém je název zapsaný, pokud se shoduje s jazykem v telefonu a:Drake ho použije; měl by existovat jeden název bez jazyka, který se použije jako výchozí v případě, že se nenajde jazykově závislý název|
-| | |**storage** 	||metoda uloženi mapových kachlí
-  filesystem - kachle se ukládají jako samostatné soubory
-  database - kachle se ukládají do samostatné databáze (jediný soubor)
-|
-| |  |**file** 	||nepovinný název souboru pro zdroj typu UTM33|
-| | |**requestHeader** 	||nepovinná dodatečná hlavička requestu, např. pole Referer |
-| | |**MapType** 	||typ mapy z jednoho zdroje, vytváří radiobuttony a checkboxy |
-| | | |//mode// |atribut určujíci použití (max. 3 výskyty každého typu)
-  basic - základ mapy, pozadí - radiobutton
-  overlay - překrytí, turistické trasy apod... - checkbox
-|
-| | | |**name** 	|název pro uživatele|
-| | | |**file** 	|identifikátor pro rozlišení souboru (viz pozn. pod tabulkou)|
-| | | |**url**  	|url zdroje (pokud je prázdné, je mapa jen pro čtení off-line, nic se nestahuje a neukládá)
-  {x} ... zeměpisná délka
-  {y} ... zeměpisná šířka
-  {z} ... zoom
-|
-| | | |**defaultZoom** 	|počáteční nastavení zoomu při prvním otevření mapy|
-| | | |**minZoom** 	|nejmenší povolený zoom (nejmenší detail)|
-| | | |**maxAvailZoom** |největší zoom dostupný na internetu |
-| | | |**maxZoom** 	|největší povolený zoom (největší detail)|
-Vzorové nastavení pro různé zdroje map najdete ve [[user:zdroje_map|wiki části dokumentace]].
+:!: Pokud se u existující vrstvy změní úložiště nebo soubor, stávající dlaždice se nepřevádějí.
-=== Soubory s mapami typu Google ===
+====== Soubor map-config.xml ======
-Soubory s mapami jsou standardně uloženy v datové složce adrake (/sdcard/adrake) v podsložce maps. Uvádí se jen název souboru, bez cesty a bez přípony. Pokud název obsahuje lomítko, bude soubor umístěn v samostatné podsložce. Každá vrstva mapy je v samostatném souboru. Element < file> pod <MapSource> se nepoužívá.
+''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]].
-Pokud název souboru začíná lomítkem, bere se jako absolutní cesta, pak musí obsahovat kompletní jméno včetně přípony.
+^Tag             ^^^^Popis ^
+|**aDrake**   ||||povinná obálka|
-Příklady
+| |**MapSource**    |||zdroj mapy, v aplikaci se zobrazí jako volba zdroje|
-^ Obsah map-config.xml ^ Skutečná cesta ^
+| | |**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|
-| <code xml><file>osm/mapnik</file></code>| /sdcard/adrake/maps/osm/mapnik.sqlitedb|
+| | |**name**  ||název pro zobrazení|
-| <code xml><file>/sdcard/Locus/mapsOnline/SHOCart_Hiking.sqlitedb</file></code>| /sdcard/Locus/mapsOnline/SHOCart_Hiking.sqlitedb|
+| | | |//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|
-=== Soubory s mapami UTM33 ===
+Ukázka vrstvy:
-Soubory s mapami jsou standardně uloženy v datové složce adrake (/sdcard/adrake) v podsložce maps. Všechny vrstvy mapy jsou v jednom souboru, rozlišují se pomocí sloupce **s**. Element <file> pod <MapSource> definuje jméno souboru, Element <file> pod <MapType> definuje jméno vrstvy, tedy obsah sloupce **s**.
+<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>
+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ů.