Name: geopackage-java
Owner: Boundless
Description: GeoPackage Java Lib
Created: 2015-09-10 11:27:11.0
Updated: 2015-09-10 11:27:12.0
Pushed: 2015-08-27 17:27:42.0
Homepage: null
Size: 438
Language: Java
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
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.
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.
GeoPackage is a Java implementation of the Open Geospatial Consortium GeoPackage spec.
The GeoPackage Java library provides the ability to read, create, and edit GeoPackage files.
// File newGeoPackage = ...;
// File existingGeoPackage = ...;
// Create a new GeoPackage
boolean created = GeoPackageManager.create(newGeoPackage)
// Open a GeoPackage
GeoPackage geoPackage = GeoPackageManager.open(existingGeoPackage)
// GeoPackage Table DAOs
SpatialReferenceSystemDao srsDao = getSpatialReferenceSystemDao();
ContentsDao contentsDao = geoPackage.getContentsDao();
GeometryColumnsDao geomColumnsDao = geoPackage.getGeometryColumnsDao();
TileMatrixSetDao tileMatrixSetDao = geoPackage.getTileMatrixSetDao();
TileMatrixDao tileMatrixDao = geoPackage.getTileMatrixDao();
DataColumnsDao dataColumnsDao = geoPackage.getDataColumnsDao();
DataColumnConstraintsDao dataColumnConstraintsDao = geoPackage.getDataColumnConstraintsDao();
MetadataDao metadataDao = geoPackage.getMetadataDao();
MetadataReferenceDao metadataReferenceDao = geoPackage.getMetadataReferenceDao();
ExtensionsDao extensionsDao = geoPackage.getExtensionsDao();
// Feature and tile tables
List<String> features = geoPackage.getFeatureTables();
List<String> tiles = geoPackage.getTileTables();
// Query Features
FeatureDao featureDao = geoPackage.getFeatureDao(features.get(0));
FeatureResultSet featureResultSet = featureDao.queryForAll();
try{
while(featureResultSet.moveToNext()){
FeatureRow featureRow = featureResultSet.getRow();
GeoPackageGeometryData geometryData = featureRow.getGeometry();
Geometry geometry = geometryData.getGeometry();
// ...
}
}finally{
featureResultSet.close();
}
// Query Tiles
TileDao tileDao = geoPackage.getTileDao(tiles.get(0));
TileResultSet tileResultSet = tileDao.queryForAll();
try{
while(tileResultSet.moveToNext()){
TileRow tileRow = tileResultSet.getRow();
byte[] tileBytes = tileRow.getTileData();
// ...
}
}finally{
tileResultSet.close();
}
// Close database when done
geoPackage.close();
The following repositories must be built first (Central Repository Artifacts Coming Soon):
Build this repository using Eclipse and/or Maven:
mvn clean install
The jar can be built as standalone (or combined with required dependency jars) to run utilities from the command line.
To build the jar into a standalone jar that includes all dependencies:
mvn clean install -Pstandalone
The tile writer writes tiles from a GeoPackage tile table to the file system. Images are saved as raw bytes or as a specified format in a z/x/y.ext folder & file structure formatted as GeoPackage, Standard (Google), or TMS (Tile Map Service). The GeoPackage format writes a tiles.properties file in the base imagery directory. The mil.nga.geopackage.io.TileWriter functionality is invokable through code or command line.
To run against the jar:
java -classpath geopackage-*standalone.jar mil.nga.geopackage.io.TileWriter [-t tile_type] [-i image_format] [-r] geopackage_file tile_table output_directory
Example:
java -classpath geopackage-*standalone.jar mil.nga.geopackage.io.TileWriter -t tms /path/geopackage.gpkg mytiletable /path/tiles/mytiles
The tile reader reads tile images from the file system and saves them into a new or existing GeoPackage in a new tile table. Images structured in a z/x/y.ext folder & file structure formatted as GeoPackage, Standard (Google), or TMS (Tile Map Service) are saved as raw bytes or as a specified format in a GeoPackage. The GeoPackage format requires a tiles.properties file in the base imagery directory. The mil.nga.geopackage.io.TileReader functionality is invokable through code or command line.
To run against the jar:
java -classpath geopackage-*standalone.jar mil.nga.geopackage.io.TileReader [-i image_format] [-r] input_directory tile_type geopackage_file tile_table
Example:
java -classpath geopackage-*standalone.jar mil.nga.geopackage.io.TileReader -i png /path/tiles/mytiles standard /path/geopackage.gpkg mytiletable
GeoPackage Format tiles.properties:
epsg=
min_x=
max_x=
min_y=
max_y=
# Zoom Level Properties:
# If the file strucThe GeoPackage format requires a tiles.properties file in the base imagery directory.ture is fully populated and represents the matrix width and height, the properties can be omitted
# If a non top zoom level matrix width and height increase by a factor of 2 with each zoom level, the properties can be omitted for those zoom levels
zoom_level.{zoom}.matrix_width=
zoom_level.{zoom}.matrix_height=