@ngageoint/leaflet-geopackage

    3.0.3 • Public • Published

    leaflet-geopackage — Load GeoPackage layers in Leaflet

    Load GeoPackage tile and feature layers in the browser without a server. When a layer is added to the map, the GeoPackage will be downloaded and then the specified layer will be loaded on the map.

    Demo

    Sample Page which loads a tile layer and a feature layer from the Natural Earth Rivers GeoPackage

    Loading a feature layer:

    Installation

    NPM

    $ npm install @ngageoint/leaflet-geopackage

    Usage

    // Load the Rivers GeoPackage and display the tile layer
    L.geoPackageTileLayer({
        geoPackageUrl: 'http://ngageoint.github.io/GeoPackage/examples/rivers.gpkg',
        layerName: 'rivers_tiles'
    }).addTo(map);
     
    // Load the Rivers GeoPackage and display the feature layer
    L.geoPackageFeatureLayer([], {
        geoPackageUrl: 'http://ngageoint.github.io/GeoPackage/examples/rivers.gpkg',
        layerName: 'rivers'
    }).addTo(map);

    GeoPackageTileLayer Options

    GeoPackageTileLayer extends L.GridLayer and accepts all options for L.GridLayer in addition to the following:

    option type
    geoPackageUrl String The URL to the GeoPackage
    layerName String Name of the Tile Layer within the GeoPackage
    noCache Boolean defaults to true set false to re-download the GeoPackage even if a previous layer has already downloaded it

    GeoPackageFeatureLayer Options

    GeoPackageFeatureLayer extends L.GeoJSON and accepts all options for L.GeoJSON in addition to the following:

    option type
    geoPackageUrl String The URL to the GeoPackage
    layerName String Name of the Feature Layer within the GeoPackage
    noCache Boolean defaults to true set false to re-download the GeoPackage even if a previous layer has already downloaded it

    Browser builds

    npm install
    npm run build-dev # development build, used by the debug page 
    npm run build-min # minified production build 

    GeoPackage JS Library

    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.

    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.

    Changelog

    2.0.5
    • Depend on @ngageoint/geopackage v1.1.4 for 4326 support
    2.0.4
    • Depending on @ngageoint/geopackage v1.0.15 for web worker changes
    2.0.3
    • Fixing README
    2.0.2
    • First release to npm
    • Fix loading GeoPackage from the cache for tile layers
    2.0.0
    • Breaking: Moved TileLayer from L.GridLayer.GeoPackage to L.GeoPackageTileLayer
    • Added L.GeoPackageFeatureLayer
    1.0.0
    • Initial release.

    Install

    npm i @ngageoint/leaflet-geopackage

    DownloadsWeekly Downloads

    31

    Version

    3.0.3

    License

    MIT

    Unpacked Size

    12.4 MB

    Total Files

    5

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar