Need help with shapefile-js?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

calvinmetcalf
494 Stars 169 Forks 267 Commits 52 Opened issues

Description

Convert a Shapefile to GeoJSON. Not many caveats.

Services available

!
?

Need anything else?

Contributors list

# 16,159
JavaScr...
arcgis
Markdow...
npm
61 commits
# 32,605
Shell
JavaScr...
Ember
ember-a...
36 commits
# 105,070
jQuery
TypeScr...
Deno
notify
2 commits
# 195,750
JavaScr...
HTML
Shell
vscode
2 commits
# 582,107
JavaScr...
HTML
1 commit
# 259,649
Shell
HTML
polling
node
1 commit
# 483,559
JavaScr...
HTML
1 commit
# 228,498
HTML
TypeScr...
quartz-...
.NET
1 commit
# 633,134
JavaScr...
HTML
1 commit
# 630,311
JavaScr...
HTML
1 commit
# 1,449
image-f...
assembl...
netfram...
residua...
1 commit

Shapefile.js

If you are having encoding issues in internet explorer please include this script as well.

Redoing all of this in modern JS. Promises, Typed Arrays, other hipster things, I wouldn't say it's based on RandomEtc's version as much as inspired by it as there is 0 code shared and I really only read the binary ajax part of his (hence why my function has the same name, they are otherwise not related). My sources were:

Demos

Usage

For use with browserify, webpack:

npm install shpjs --save

Or include directly in your webpage from:

https://unpkg.com/[email protected]/dist/shp.js

API

Has a function

shp
which accepts a string which is the path the she shapefile minus the extension and returns a promise which resolves into geojson.
    //for the shapefiles in the folder called 'files' with the name pandr.shp
    shp("files/pandr").then(function(geojson){
        //do something with your geojson
    });

or you can call it on a .zip file which contains the shapefile

    //for the shapefiles in the files folder called pandr.shp
    shp("files/pandr.zip").then(function(geojson){
        //see bellow for whats here this internally call shp.parseZip()
    });

or if you got the zip some other way (like the File API) then with the arrayBuffer you can call

shp(buffer).then(function(geojson){});
//or
shp.parseZip(buffer)->returns zip

If there is only one shp in the zipefile it returns geojson, if there are multiple then it will be an array. All of the geojson objects have an extra key

fileName
the value of which is the name of the shapefile minus the extension (I.E. the part of the name that's the same for all of them)

You could also load the arraybuffers seperately:

shp.combine([shp.parseShp(shpBuffer, /*optional prj str*/),shp.parseDbf(dbfBuffer)]);

Stick it in a worker

I used my library catiline to parallelize the demos to do so I changed


to


to send the worker a buffer from the file api you'd do (I'm omitting where you include the catiline script)

var worker = cw(function(data){
    importScripts('../dist/shp.js');
    return shp.parseZip(data);
});

worker.data(reader.result,[reader.result]).then(function(data){ //do stuff with data });

Done

  • Binary Ajax
  • parsing the shp
  • parse the dbf
  • join em
  • zip
  • file api
  • Some Projections
  • More Projections

to do

  • check for geometry validity.
  • Tests

LICENSE

Main library MIT license, original version was less permissive but there is 0 code shared. Included libraries are under their respective lisenses which are: - JSZip by @Stuk MIT or GPLv3 - lie by me and @RubenVerborgh MIT - setImmediate by @NobleJS et al MIT - World Borders shapefile is CC-BY-SA 3.0. - Park and Ride shapefile is from MassDOT and is public domain. - MA town boundaries from MassGIS and is public domain - NJ County Boundaries from NJgin and should be public domain. - Proj4js by me et al MIT

Dependency Status devDependency Status peerDependency Status

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.