https://github.com/ngageoint/geopackage-android

GeoPackage Android Library
https://github.com/ngageoint/geopackage-android

android android-library android-sdk geopackage geopackage-android geopackage-functionality geopackage-libraries geopackage-mapcache geopackage-tiles nga

Last synced: about 2 months ago
JSON representation

GeoPackage Android Library

Host: GitHub
URL: https://github.com/ngageoint/geopackage-android
Owner: ngageoint
License: mit
Created: 2015-07-31T23:04:34.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2024-04-05T12:59:58.000Z (over 1 year ago)
Last Synced: 2024-12-10T20:51:43.962Z (10 months ago)
Topics: android, android-library, android-sdk, geopackage, geopackage-android, geopackage-functionality, geopackage-libraries, geopackage-mapcache, geopackage-tiles, nga
Language: Java
Homepage: http://ngageoint.github.io/geopackage-android
Size: 36.2 MB
Stars: 94
Watchers: 26
Forks: 33
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt

Awesome Lists containing this project

README

          # GeoPackage Android

### GeoPackage Android Lib ####

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](https://www.caci.com/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](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.

### About ###

[GeoPackage Android](http://ngageoint.github.io/geopackage-android/) is a [GeoPackage Library](http://ngageoint.github.io/GeoPackage/) SDK implementation of the Open Geospatial Consortium [GeoPackage](http://www.geopackage.org/) [spec](http://www.geopackage.org/spec/).  It is listed as an [OGC GeoPackage Implementation](http://www.geopackage.org/#implementations_nga) by the National Geospatial-Intelligence Agency.



    



The GeoPackage SDK provides the ability to manage GeoPackage files providing read, write, import, export, share, and open support. Open GeoPackage files provide read and write access to features and tiles. Feature support includes Well-Known Binary translations. Tile generation supports creation by URL or features.

### Usage ###

View the latest [Javadoc](http://ngageoint.github.io/geopackage-android/docs/api/)

#### Implementations ####

##### GeoPackage Android Map #####

The [GeoPackage Android Map](https://github.com/ngageoint/geopackage-android-map) SDK adds Android Map implementations to this base library.

##### GeoPackage MapCache #####

The [GeoPackage MapCache](https://github.com/ngageoint/geopackage-mapcache-android) app provides an extensive standalone example on how to use both this and the [GeoPackage Android Map](https://github.com/ngageoint/geopackage-android-map) SDKs.

##### MAGE #####

The [Mobile Awareness GEOINT Environment (MAGE)](https://github.com/ngageoint/mage-android) app provides mobile situational awareness capabilities. It [uses the SDK](https://github.com/ngageoint/mage-android/search?q=GeoPackage&type=Code) to provide GeoPackage functionality.

#### Example ####

```java

// Context context = ...;

// File geoPackageFile = ...;

// Get a manager

GeoPackageManager manager = GeoPackageFactory.getManager(context);

// Import database

boolean imported = manager.importGeoPackage(geoPackageFile);

// Available databases

List databases = manager.databases();

// Open database

GeoPackage geoPackage = manager.open(name);

// GeoPackage Table DAOs

SpatialReferenceSystemDao srsDao = geoPackage.getSpatialReferenceSystemDao();

ContentsDao contentsDao = geoPackage.getContentsDao();

GeometryColumnsDao geomColumnsDao = geoPackage.getGeometryColumnsDao();

TileMatrixSetDao tileMatrixSetDao = geoPackage.getTileMatrixSetDao();

TileMatrixDao tileMatrixDao = geoPackage.getTileMatrixDao();

SchemaExtension schemaExtension = new SchemaExtension(geoPackage);

DataColumnsDao dataColumnsDao = schemaExtension.getDataColumnsDao();

DataColumnConstraintsDao dataColumnConstraintsDao = schemaExtension

        .getDataColumnConstraintsDao();

MetadataExtension metadataExtension = new MetadataExtension(geoPackage);

MetadataDao metadataDao = metadataExtension.getMetadataDao();

MetadataReferenceDao metadataReferenceDao = metadataExtension

        .getMetadataReferenceDao();

ExtensionsDao extensionsDao = geoPackage.getExtensionsDao();

// Feature and tile tables

List features = geoPackage.getFeatureTables();

List tiles = geoPackage.getTileTables();

// Query Features

String featureTable = features.get(0);

FeatureDao featureDao = geoPackage.getFeatureDao(featureTable);

FeatureCursor featureCursor = featureDao.queryForAll();

try {

    for (FeatureRow featureRow : featureCursor) {

        GeoPackageGeometryData geometryData = featureRow.getGeometry();

        if (geometryData != null && !geometryData.isEmpty()) {

            Geometry geometry = geometryData.getGeometry();

            // ...

        }

    }

} finally {

    featureCursor.close();

}

// Query Tiles

String tileTable = tiles.get(0);

TileDao tileDao = geoPackage.getTileDao(tileTable);

TileCursor tileCursor = tileDao.queryForAll();

try {

    for (TileRow tileRow : tileCursor) {

        byte[] tileBytes = tileRow.getTileData();

        Bitmap tileBitmap = tileRow.getTileDataBitmap();

        // ...

    }

} finally {

    tileCursor.close();

}

// Retrieve Tiles by XYZ

GeoPackageTileRetriever retriever = new GeoPackageTileRetriever(tileDao);

GeoPackageTile geoPackageTile = retriever.getTile(2, 2, 2);

if (geoPackageTile != null) {

    byte[] tileBytes = geoPackageTile.getData();

    Bitmap tileBitmap = geoPackageTile.getBitmap();

    // ...

}

// Retrieve Tiles by Bounding Box

TileCreator tileCreator = new TileCreator(

        tileDao, ProjectionFactory.getProjection(ProjectionConstants.EPSG_WORLD_GEODETIC_SYSTEM));

GeoPackageTile geoPackageTile2 = tileCreator.getTile(

        new BoundingBox(-90.0, 0.0, 0.0, 66.513260));

if (geoPackageTile2 != null) {

    byte[] tileBytes = geoPackageTile2.getData();

    Bitmap tileBitmap = geoPackageTile2.getBitmap();

    // ...

}

BoundingBox boundingBox = BoundingBox.worldWebMercator();

Projection projection = ProjectionFactory

        .getProjection(ProjectionConstants.EPSG_WEB_MERCATOR);

// Index Features

FeatureIndexManager indexer = new FeatureIndexManager(context, geoPackage, featureDao, false);

indexer.setIndexLocation(FeatureIndexType.GEOPACKAGE);

int indexedCount = indexer.index();

// Query Indexed Features in paginated chunks

FeatureIndexResults indexResults = indexer.queryForChunk(boundingBox,

        projection, 50);

FeaturePaginatedCursor paginatedCursor = indexer

        .paginate(indexResults);

for (FeatureRow featureRow : paginatedCursor) {

    GeoPackageGeometryData geometryData = featureRow.getGeometry();

    if (geometryData != null && !geometryData.isEmpty()) {

        Geometry geometry = geometryData.getGeometry();

        // ...

    }

}

// Draw tiles from features

FeatureTiles featureTiles = new DefaultFeatureTiles(context, featureDao, context.getResources().getDisplayMetrics().density, false);

featureTiles.setMaxFeaturesPerTile(1000); // Set max features to draw per tile

NumberFeaturesTile numberFeaturesTile = new NumberFeaturesTile(context); // Custom feature tile implementation

featureTiles.setMaxFeaturesTileDraw(numberFeaturesTile); // Draw feature count tiles when max features passed

featureTiles.setIndexManager(indexer); // Set index manager to query feature indices

Bitmap tile = featureTiles.drawTile(2, 2, 2);

// URL Tile Generator (generate tiles from a URL)

TileGenerator urlTileGenerator = new UrlTileGenerator(context, geoPackage,

        "url_tile_table", "http://url/{z}/{x}/{y}.png", 0, 0, boundingBox, projection);

int urlTileCount = urlTileGenerator.generateTiles();

// Feature Tile Generator (generate tiles from features)

TileGenerator featureTileGenerator = new FeatureTileGenerator(context, geoPackage,

        "tiles_" + featureTable, featureTiles, 1, 2, boundingBox, projection);

int featureTileCount = featureTileGenerator.generateTiles();

// Close feature tiles (and indexer)

featureTiles.close();

// Close database when done

geoPackage.close();

```

### Installation ###

Pull from the [Maven Central Repository](http://search.maven.org/#artifactdetails|mil.nga.geopackage|geopackage-android|6.7.4|aar) (AAR, POM, Source, Javadoc)

    api 'mil.nga.geopackage:geopackage-android:6.7.4'

### Build ###

[![Build Artifacts](https://github.com/ngageoint/geopackage-android/workflows/Build%20Artifacts/badge.svg)](https://github.com/ngageoint/geopackage-android/actions/workflows/build-artifacts.yml)

[![Test](https://github.com/ngageoint/geopackage-android/workflows/Test/badge.svg)](https://github.com/ngageoint/geopackage-android/actions/workflows/test.yml)

Build this repository using Android Studio and/or Gradle.

#### Project Setup ####

Include as repositories in your project build.gradle:

    repositories {

        google()

        mavenCentral()

        mavenLocal()

    }

##### Normal Build #####

Include the dependency in your module build.gradle with desired version number:

    api 'mil.nga.geopackage:geopackage-android:6.7.4'

As part of the build process, run the "publishToMavenLocal" task on the geopackage-android Gradle script to update the Maven local repository.

##### Local Build #####

Replace the normal build dependency in your module build.gradle with:

    api project(':geopackage-sdk')

Include in your settings.gradle:

    include ':geopackage-sdk'

From your project directory, link the cloned SDK directory:

    ln -s ../geopackage-android/geopackage-sdk geopackage-sdk

### Remote Dependencies ###

* [GeoPackage Core Java](https://github.com/ngageoint/geopackage-core-java) (The MIT License (MIT)) - GeoPackage Library

* [TIFF](https://github.com/ngageoint/tiff-java) (The MIT License (MIT)) - Tagged Image File Format Lib

* [OrmLite](http://ormlite.com/) (Open Source License) - Object Relational Mapping (ORM) Library

* [PNGJ](http://github.com/leonbloy/pngj) (Apache License, Version 2.0) - PNGJ: Java library for PNG encoding

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/ngageoint/geopackage-android

Awesome Lists containing this project

README