GeoPackage MapCache Android

MapCache Android

The GeoPackage Libraries were developed at the National Geospatial-Intelligence Agency (NGA) in collaboration with BIT Systems. The government has "unlimited rights" and is releasing this software to increase the impact of government investments by providing developers with the opportunity to take things in new directions. The software use, modification, and distribution rights are stipulated within the MIT license.

Pull Requests

If you'd like to contribute to this project, please make a pull request. We'll review the pull request and discuss the changes. All pull request contributions to this project will be released under the MIT license.

Software source code previously released under an open source license and then modified by NGA staff is considered a "joint work" (see 17 USC ยง 101); it is partially copyrighted, partially public domain, and as a whole is protected by the copyrights of the non-government authors and must be released according to the terms of the original open source license.

Android App

Download the latest Legacy APK

About

GeoPackage MapCache is a GeoPackage Library app for Android that utilizes and demonstrates the functionality in GeoPackage Android and GeoPackage Android Map. The GeoPackage SDKs are Android library implementations of the Open Geospatial Consortium GeoPackage spec. The app and SDK are listed as OGC GeoPackage Implementations by the National Geospatial-Intelligence Agency.

The MapCache app provides read and write access to GeoPackage files, including features and tiles. Features are visualized and editable on the map. Tiles are visualized on the map and can be loaded from a tile provider or WMS url.

Screenshots

GeoPackage with a tile layer

List of GeoPackages with 2 enabled

A GeoPackage with tiles and features enabled on the map

Downloading tiles for a new layer

A Tile layer detail view

Build

Build

Build this repository using Android Studio and/or Gradle. Run the "assembleRelease" task on the geopackage-mapcache-android Gradle script.

Map Key

When building this project locally, a Google API key is required to see map tiles:

On the Google Cloud Platform Console, configure "Maps SDK for Android" credentials (replacing the example fingerprints).

Package name SHA-1 certificate fingerprint
mil.nga.mapcache 12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF:AA:BB:CC:DD
mil.nga.mapcache.test 12:34:56:78:90:AB:CD:EF:12:34:56:78:90:AB:CD:EF:AA:BB:CC:DD

In your gradle.properties, add your API Key (replacing the example keys)

RELEASE_MAPS_MAPCACHE_API_KEY=AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
DEBUG_MAPS_API_KEY=AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0