map-depot - GitLite

KO | EN

gitlite — search

#windows #self-hosted #security #pytorch #framework #command-line #shell #postgresql #database #llm

map-depot

(★ 9)

ATAK Plugin: Map Depot — download elevation, base maps and offline public-lands maps from inside ATAK. Downloads, guide and issues here.

File Explorer

ZIP Download

- build.gradle
- proguard-gradle-repackage.txt
- proguard-gradle.txt
- - map_depot_icon-detailed.png
  - map_depot_icon-simplified.png
- - 10_base_map_rows.png
  - 11_filter_installed.png
  - 12_search_forests.png
  - 13_package_downloading.png
  - 14_tap_to_go_there.png
  - 15_ranger_districts.png
  - 16_district_map_on_map.jpg
  - 17_forest_basemap_on_map.png
  - 18_reference_overlay.png
  - 19_atak_layer_list.png
  - 1_plugin_in_toolbar.png
  - 20_incident_region_picker.png
  - 21_incident_dates_newest_first.png
  - 22_incident_file_list.png
  - 23_pin_a_fire.png
  - 24_pinned_at_top.png
  - 25_overlay_and_map.png
  - 26_outlines_on.jpg
  - 27_drone_ir_on_map.jpg
  - 28_hidden_by_filter.png
  - 29_filter_available.png
  - 2_landing_page.png
  - 30_usfs_topo_nearest.png
  - 31_series_chooser.png
  - 33_beacon_neighborhoods.png
  - 34_beacon_maps.png
  - 3_elevation_row_states.png
  - 4_country_chooser.png
  - 5_confirm_download.png
  - 6_download_in_progress.png
  - 7_remove_shared_cells.png
  - 8_remove_frees_nothing.png
  - 9_category_chooser.png
- - 01.png
  - 02.png
  - 03.png
  - 04.png
  - 05.png
  - 06.png
  - 07.png
  - 08.png
  - 09.png
  - 10.png
  - 11.png
  - 12.png
  - 13.png
  - 14.png
  - 15.png
  - 16.jpg
  - 17.png
  - 18.png
  - 19.png
  - 20.png
  - 22.png
  - 23.png
  - 25.png
  - 26.png
  - 28.png
  - 29.png
  - 31.png
  - 33.png
  - 34.jpg
  - 35.jpg
  - 38.png
  - 42.jpg
  - 43.png
  - 44.png
  - 45.png
  - 46.png
  - 47.png
  - 48.png
  - 49.png
  - formatting.typ
  - titlepage.svg
  - usermanual.typ
- USER_GUIDE.md
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- typst.gradle
- versions.gradle
- make_icon.py
.gitignore
build.gradle
gradle.properties
gradlew
gradlew.bat
README.md
settings.gradle
template.local.properties

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

ATAK Plugin — Map Depot

**Download Map Depot 1.6** (pick the one matching your ATAK-CIV version, sideload, then load it in ATAK's Plugins manager):

- **ATAK-CIV 5.6:** https://github.com/takwerx/map-depot/releases/download/v1.6/ATAK-Plugin-MapDepot-1.6--5.6.0-civ-release.apk
- **ATAK-CIV 5.7:** https://github.com/takwerx/map-depot/releases/download/v1.6/ATAK-Plugin-MapDepot-1.6--5.7.0-civ-release.apk
- **ATAK-CIV 5.8:** https://github.com/takwerx/map-depot/releases/download/v1.6/ATAK-Plugin-MapDepot-1.6--5.8.0-civ-release.apk

All releases: https://github.com/takwerx/map-depot/releases

**User guide with screenshots: [docs/USER_GUIDE.md](docs/USER_GUIDE.md)**
(https://github.com/takwerx/map-depot/blob/main/docs/USER_GUIDE.md)

_________________________________________________________________
PURPOSE AND CAPABILITIES

Map Depot downloads map data from inside ATAK. Without it, getting elevation or a
map source onto a device means a web browser, the Downloads folder, and the Import
Manager -- a sequence that is awkward on a phone and impossible with gloves on.

Six kinds of data, each installed into the directory ATAK already scans, so
nothing has to be imported by hand afterwards:

* Elevation. DTED2 by state or province. Every cell is verified against a
    SHA-256 digest before it is installed, because a truncated .dt2 reads as
    valid to ATAK and silently corrupts line of sight and viewshed. Downloads
    resume, and a region already partly present fetches only what is missing.

* Streaming base maps. MOBAC map source XML and streaming vector tile configs
    -- satellite, street, topographic, nautical, and transparent overlays such as
    BLM roads and trails, FEMA flood hazard zones and current fire perimeters.

* Offline public land vector tiles. US Forest Service vector basemap packages, one per
    national forest or grassland, fetched directly from ArcGIS Online.

* Offline public land PDFs. The Forest Service's printed map sheets as
    georeferenced PDFs, which install as image overlays and draw over whatever
    base map is already in use: ranger district and forest visitor maps, the
    nine regional maps, the 1:100,000 series and the 1:24,000 FSTopo quads. The
    two large series are listed nearest the map first, with distance and
    direction on every row, because nobody knows the name of their quad.

* Incident maps. The operational products a going fire's GIS shop posts to the
    NIFC archive -- ops, division, air operations, transport, briefing and IR --
    browsed by geographic area and fire. Filenames written for a desktop file
    browser are renamed for a phone screen, keyed to the operational period
    rather than the plot time, with the original shown underneath.

* Drone IR maps. The same, for infrared flown by uncrewed aircraft and posted
    to the UAS Wildland Fire Consortium. Flight logs and geodatabases are left
    out; only georeferenced maps and KMZ overlays are offered.

* Beacon Box maps. FlameMapper's neighborhood pre-plans for the Santa Monica
    Mountains communities and a few others -- a base map, an aerial, a
    fire-science sheet and a structure-vulnerability sheet per neighborhood, as
    GeoPDFs -- browsed by area and neighborhood the way the incident archives
    are. Their own site cannot be reached from a phone, so they are mirrored on
    the depot with the author's permission. Maps by FlameMapper.

Any folder in either archive can be pinned to the top of the list, so a crew
assigned to a fire reaches it in one tap rather than four.

The catalog is fetched at runtime and cached, so a device that has been to the
depot once still shows what it holds when there is no signal. The two incident
archives are read live, since what they hold changes through the day.

_________________________________________________________________
STATUS

Version 1.6. Verified on ATAK-CIV 5.8.0.3 (SDK build) and, as the tak.gov-signed
builds, on official ATAK-CIV 5.6.0.18 and 5.8.0.4 -- on the latter the gate,
the Move offer, and ATAK starting again afterwards.

1.6 adds the rest of the Forest Service's map sheets, and the Beacon Box maps. The Digital Maps site
publishes eight series behind one download gateway, and 1.0 took two of them,
the ranger district and forest visitor maps. 1.6 adds the Regional series (18
sheets), the 1:100,000 series (1,841) and the 1:24,000 FSTopo quads (about
18,000), each built from the same index and URL template the site's own
Download button uses, and each sheet confirmed with a byte from the gateway
before it is cataloged. They share one section with a series chooser, and the
two large series sort by distance from the map center and show the nearest 300,
saying so, since a list of eighteen thousand quads is not something anyone
scrolls. The FSTopo list is fetched the first time it is chosen and kept beside
the catalog, so it is bigger than the whole catalog only once.

1.5 responds to a fault in ATAK, not in the plugin: official ATAK-CIV 5.8.0.4
does not start once a vector tile package -- an Offline Public Land Vector Tiles package -- is
in its layer catalog. The first import survives; every start after it dies in
ATAK's own imagery scan, before any plugin loads, with an AbstractMethodError on
TileMatrix.getName(). Measured 2026-09-03 on a Galaxy S22 Ultra, Android 14,
with a 20 MB and a 242 MB package; the SDK's own 5.8.0.3 build starts fine with
fifteen of them, so this is the official build's obfuscation. Reported to TAK
Product Center support with the stack and the reproduction.

So on an official 5.8 build, Map Depot no longer offers those downloads: the
section stays, dimmed, and says why. A phone that already has packages is one
restart from an ATAK that does not open, and on start Map Depot offers once to
move them to atak/imagery.off, which ATAK does not scan; the dialog says that it
is the only place this plugin moves a file. The gate is by release, not build
number, and lifts when tak.gov ships a fixed ATAK. Everything else -- elevation,
streaming base maps, Forest Service map sheets, incident and drone IR maps -- is
unchanged, on every ATAK version.

_________________________________________________________________
POINT OF CONTACTS

takwerx
https://github.com/takwerx/map-depot/issues

_________________________________________________________________
PORTS REQUIRED

Outbound TCP 443 (HTTPS) only. The plugin opens no listening ports and accepts no
inbound connections.

Hosts contacted:

* The depot itself, which is a preference and not a fixed address. It serves
    the catalog, the map source files and the elevation cells. It ships pointing
    at a Cloudflare R2 bucket.
  * www.arcgis.com and tiles.arcgis.com, for Forest Service basemap packages,
    which are fetched from their publisher rather than mirrored.
  * data.fs.usda.gov, for Forest Service map sheets of every series.
  * ftp.wildfire.gov, for NIFC incident maps. Public, no account.
  * uaswfc.org, for UAS Wildland Fire Consortium drone products. Public, no
    account. Both are preferences rather than fixed addresses, and both are
    rejected if not HTTPS.

Installing a map source does not itself contact that source's server; ATAK does,
when the operator turns the layer on. Which servers those are is visible in the
source list before anything is installed.

Non-HTTPS depot addresses are rejected.

_________________________________________________________________
EQUIPMENT REQUIRED

An Android device running ATAK-CIV 5.8.0.x, and enough free storage for whatever
is downloaded. The plugin checks free space before starting and refuses rather
than filling the device.

_________________________________________________________________
EQUIPMENT SUPPORTED

No peripherals. No GPS, radio, camera or Bluetooth use.

_________________________________________________________________
COMPILATION

Standard ATAK plugin build. Set sdk.path in local.properties to an extracted
ATAK-CIV SDK, then:

./gradlew assembleCivRelease

The release build applies minification and ProGuard.

_________________________________________________________________
DEVELOPER NOTES

Files are placed where ATAK's own classification puts them, since the directory
decides what ATAK treats the file as: map source XML in imagery/mobile/mapsources,
streaming configs and vector tile packages at the imagery root, georeferenced PDFs
in grg, KMZ in overlays. After a file lands, ATAK is told: imagery through a layer scan, GRGs
through the import pipeline, because GRG discovery otherwise runs only at startup.

Removal notifies ATAK before deleting the file. The reverse order leaves a tile
reader holding a path that no longer exists.

Downloads stage outside any scanned directory and are moved into place once
complete, so ATAK never sees a partly written file and registers a broken layer.

Region, source and package identifiers arrive over the network and become both
URL components and filenames, so each is validated against a closed pattern
before use, and every written path is checked to be inside its intended
directory.