GeoPackage JS is an implementation of the OGC GeoPackage spec. This library works in both the browser and Node 4+.
Cloning this repository and opening the docs/index.html in your browser will run the demo locally.
$ npm install @ngageoint/geopackageThe 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 JS is a GeoPackage Library JavaScript implementation of the Open Geospatial Consortium GeoPackage spec. It is listed as an OGC GeoPackage Implementation by the National Geospatial-Intelligence Agency.
The GeoPackage JavaScript library currently provides the ability to read GeoPackage files. This library works both in the browser and in Node. In the browser tiles are rendered using HTML5 Canvas and GeoPackages are read using sql.js. In Node tiles are rendered PureImage and GeoPackages are read using node-sqlite3.
- Fixed bug where querying for indexed features only returned the geometry instead of the entire feature
- Remove dependency on Lwip
View examples using Bower and Browserify
View the latest docs (currently being updated).
// attach this method to a file input onchange event
window.loadGeoPackage = function(files) {
var f = files[0];
var r = new FileReader();
r.onload = function() {
var array = new Uint8Array(r.result);
loadByteArray(array);
}
r.readAsArrayBuffer(f);
}
function loadByteArray(array, callback) {
var db = new SQL.Database(array);
GeoPackageConnection.connectWithDatabase(db, function(err, connection) {
var geoPackage = new GeoPackage('', '', connection);
// Now you can operate on the GeoPackage
// get the tile table names
geoPackage.getTileTables(function(err, tileTableNames) {
// tileTableNames is an array of all tile table names
// get the info for the first table
geoPackage.getTileDaoWithTableName(tileTableNames[0], function(err, tileDao) {
geoPackage.getInfoForTable(tileDao, function(err, info) {
// do something with the tile table info
});
// draw a tile into a canvas for an XYZ tile
var canvas = canvasFromSomewhere;
var gpr = new GeoPackageTileRetriever(tileDao, 256, 256);
var x = 0;
var y = 0;
var zoom = 0;
console.time('Draw tile ' + x + ', ' + y + ' zoom: ' + zoom);
gpr.drawTileIn(x, y, zoom, canvas, function() {
console.timeEnd('Draw tile ' + x + ', ' + y + ' zoom: ' + zoom);
});
// or get a tile base64 data URL for an XYZ tile
gpr.getTile(x, y, zoom, function(err, tileBase64DataURL) {
console.log('got the base64 data url');
});
// or get a tile from a GeoPackage tile column and tile row
tileDao.queryForTile(tileColumn, tileRow, zoom, function(err, tile) {
var tileData = tile.getTileData(); // the raw bytes from the GeoPackage
});
});
});
// get the feature table names
geoPackage.getFeatureTables(function(err, featureTableNames) {
// featureTableNames is an array of all feature table names
// get the info for the first table
geoPackage.getFeatureDaoWithTableName(featureTableNames[0], function(err, featureDao) {
geoPackage.getInfoForTable(featureDao, function(err, info) {
// do something with the feature table info
});
// query for all features
featureDao.queryForEach(function(err, row, rowDone) {
var feature = featureDao.getFeatureRow(row);
var geometry = currentRow.getGeometry();
if (geometry) {
var geom = geometry.geometry;
var geoJson = geometry.geometry.toGeoJSON();
geoJson.properties = {};
for (var key in feature.values) {
if(feature.values.hasOwnProperty(key) && key != feature.getGeometryColumn().name) {
var column = info.columnMap[key];
geoJson.properties[column.displayName] = currentRow.values[key];
}
}
}
rowDone();
});
});
});
});
}/**
* Split a Geopackage into GeoJSON JSON files.
*/
const fs = require('fs');
const filename = './test/data/rivers.gpkg';
const geoPackage = require('@ngageoint/geopackage');
const GeoPackageConnection = geoPackage.GeoPackageConnection;
const GeoPackageTileRetriever = geoPackage.GeoPackageTileRetriever;
geoPackage.openGeoPackage(filename, function(err, gpkg) {
// Now you can operate on the GeoPackage
// get the feature table names
gpkg.getFeatureTables(function(err, featureTableNames) {
// featureTableNames is an array of all feature table names
// get the info for the first table
gpkg.getFeatureDaoWithTableName(featureTableNames[0], function(err, featureDao) {
var featureInfo;
gpkg.getInfoForTable(featureDao, function(err, info) {
// do something with the feature table info
featureInfo = info;
// query for all features
featureDao.queryForEach(function(err, row, rowDone) {
var feature = featureDao.getFeatureRow(row);
var geometry = feature.getGeometry();
if (geometry) {
var geom = geometry.geometry;
var geoJson = geometry.geometry.toGeoJSON();
var name = feature.values.property_1.replace(" ","_") + "_" + feature.values.property_0 + "_" + feature.values.id + ".json";
fs.writeFileSync('./test/data/' + name , JSON.stringify(geoJson,null,2));
geoJson.properties = {};
for (var key in feature.values) {
if(feature.values.hasOwnProperty(key) && key != feature.getGeometryColumn().name) {
var column = featureInfo.columnMap[key];
geoJson.properties[column.displayName] = feature.values[key];
}
}
}
rowDone();
});
});
});
});
});