https://github.com/ngageoint/geopackage-mapcache-android
GeoPackage MapCache Android App
https://github.com/ngageoint/geopackage-mapcache-android
android android-app android-application geopackage geopackage-android geopackage-functionality geopackage-libraries geopackage-mapcache geopackage-tiles mapcache-android nga tiles
Last synced: 5 months ago
JSON representation
GeoPackage MapCache Android App
- Host: GitHub
- URL: https://github.com/ngageoint/geopackage-mapcache-android
- Owner: ngageoint
- License: mit
- Created: 2015-07-31T23:06:11.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2025-05-05T16:48:29.000Z (5 months ago)
- Last Synced: 2025-05-05T22:16:21.132Z (5 months ago)
- Topics: android, android-app, android-application, geopackage, geopackage-android, geopackage-functionality, geopackage-libraries, geopackage-mapcache, geopackage-tiles, mapcache-android, nga, tiles
- Language: Python
- Homepage: https://ngageoint.github.io/geopackage-mapcache-android
- Size: 398 MB
- Stars: 40
- Watchers: 19
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# GeoPackage MapCache Android
#### MapCache Android ####
The [GeoPackage Libraries](http://ngageoint.github.io/GeoPackage/) were developed at the [National Geospatial-Intelligence Agency (NGA)](http://www.nga.mil/) in collaboration with [BIT Systems](http://www.bit-sys.com/). 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](http://choosealicense.com/licenses/mit/).
### 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 ###
### About ###
[GeoPackage MapCache](http://ngageoint.github.io/geopackage-mapcache-android/) is a [GeoPackage Library](http://ngageoint.github.io/GeoPackage/) app for Android that utilizes and demonstrates the functionality in [GeoPackage Android](https://github.com/ngageoint/geopackage-android) and [GeoPackage Android Map](https://github.com/ngageoint/geopackage-android-map). The GeoPackage SDKs are Android library implementations of the Open Geospatial Consortium [GeoPackage](http://www.geopackage.org/) [spec](http://www.geopackage.org/spec/). The app and SDK are listed as [OGC GeoPackage Implementations](http://www.geopackage.org/#implementations_nga) 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 ###
[](https://github.com/ngageoint/geopackage-mapcache-android/actions?query=workflow%3ABuild)
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:
* Maps SDK for Android: [Get API Key](https://developers.google.com/maps/documentation/android-sdk/signup)
On the [Google Cloud Platform Console](https://cloud.google.com/console/google/maps-apis/overview), 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
```
### Legacy ###
The original MapCache app is minimally maintained on the [legacy branch](https://github.com/ngageoint/geopackage-mapcache-android/tree/legacy).
[Download the latest Legacy APK](https://ngageoint.github.io/geopackage-mapcache-android/legacy/mapcache.zip)