Technický popis map

a:Drake (od verze 6.14) vykresluje všechny mapy knihovnou 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 Vektorové mapy.

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.

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.

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 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 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:

<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>

Další vzorová nastavení pro různé zdroje map najdete ve 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ů.