@ngageoint/geopackage-kml-js

KML and KMZ files to Geopackage files

Using a Xml streaming library to read the kml file and convert the hierarchal data into relational data that GeoPackages can store.

Installation

$ npm install @ngageoint/geopackage-kml-js

Usage

./cli /path/to/file/to/convert.kml /path/to/file/to/create.gpkg

Javascript

const { KMLToGeoPackage } = require('@ngageoint/geopackage-kml-js');
const kmlFile = './test.kml';
const geoPackageFile = './test.gpkg';
const tableName = 'features';

// Convert CSV to GeoPackage feature table
const converter = new KMLToGeoPackage();
converter.convert({ kmlOrKmzPath: kmlFile, geoPackage: geoPackageFile, tableName: tableName }).then(() => {
  console.log('File conversion complete');
  console.log('Converted %s to %s', kmlFile, geoPackageFile);
});

Currently Supports

Placemark tags with and without coordinates Stored as features in a feature table with any additional tags stored in a column of the table.
- Multigeometry tags
- Polygon tags
  - inner and outer boundaries.
- LineString tags
- Point tags
Most of Icon, Polygon and Line Style tags
- color converted to rgba
GroundOverlay tags
- Image converision from EPSG: 4326 to EPSG: 3857 Web-mercator
  - Image manipulation preformed by Jimp.
  - Coordinate converision from Proj4.
- Creates a tile set at appropriate from the zoomlevels.
  - Starting at the zoomlevel where the GroundOverlay is covered by one tile.
  - Ending where the image resolution matches that of the tile.
  - This is done in steps of 2.
Default Stylings of Google Earth.
gx:altitudeMode
ExtendedData

Does not support but plan on supporting

Network Links
ScreenOverlays
Folder and Document structure
PhotoOverlays
StyleMaps
- currently only captures normal style
Region
gx:x, gx:y, gx:h and gx:w

Does not support and no plans to support currently

lookAt tags
- Current it is stored as a JSON string in a column of the feature table
Most of gx extensions
Models tags
Camera
colorMode
gx:LatLonQuad
Google Sky
ListStyle
NetworkLinkControl