Rozdíly

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

--- mapa_tech [2012/01/24 08:01] – 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 pdmap.
+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 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.
+====== 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 melze použít MobAC, a:Drake 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.
+====== 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//).
+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)//).
+==== 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ů |
+:!: Pokud se u existující vrstvy změní úložiště nebo soubor, stávající dlaždice se nepřevádějí.
+====== 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]].
+^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|
+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>
+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ů.