shpjs
DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/shpjs package

5.0.0 • Public • Published

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

Fore use in rollup, node and where ever ESM modules are used we have a lovely package you can install via npm or yarn or whatever.

npm install shpjs --save

If you need a stand alone file to include in your webpage the old fasion when then you can grab the built version that's either included in the repo or you can use unpkg.

https://unpkg.com/shpjs@latest/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.

	import shp from 'shpjs';
	//for the shapefiles in the folder called 'files' with the name pandr.shp
	const geojson = await shp("files/pandr");

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

	//for the shapefiles in the files folder called pandr.shp
	const geojson = await shp("files/pandr.zip");
	//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

const geojson = await shp(buffer);

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)

Advanced API

There are also a few internal methods that are exposed for if you have to do some more complicated stuff. These are named exports in the ESM version or properties on the main shp function in the bundled version.

  • parseShape: takes a buffer containing the contents of a .shp file and optionally a .prj STRING and returns geometries.
  • parseDbf: just a shortcut to parseDBF takes the same arguments, though will do some type coertion that the stand alone library won't.
  • combine: takes the results of the two aformentioned functions and combines them into a geojson document.
import {combine, parseShp, parseDbf} from shpjs;
combine([parseShp(shpBuffer, /*optional prj str*/),parseDbf(dbfBuffer)]);

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:

Dependency Status devDependency Status peerDependency Status

Readme

Keywords

none

Package Sidebar

Install

npm i shpjs

Weekly Downloads

21,662

Version

5.0.0

License

MIT

Unpacked Size

776 kB

Total Files

15

Last publish

Collaborators

  • cwmma