validate and sanity-check geojson files

geojsonhint: complete, fast, standards-based validation for geojson

A lint tool for the GeoJSON standard. geojsonhint is written to the standard, with no missing or additional opinions about structure.

Thanks to jsonlint-lines, GeoJSON that is also not valid JSON can return informative, line-oriented parsing errors.

errors = geojsonhint.hint(string or object)

Lint a file, given as a string or object. This call detects all aberrations from the GeoJSON standards and returns them as an array of errors. An example of the output:

  "message": "\"features\" property should be an array, but is an object instead",
  "line": 1

Note that the GeoJSON can be given as a string or as an object. Here's how to choose which input to use:

  • string inputs receive line numbers for each error. These make errors easier to track down if the GeoJSON is hand-written.
  • object inputs don't have line numbers but are evaluated faster, by up to 10x. GeoJSONHint is very fast already so unless you have identified it as a bottleneck in your application, don't prematurely optimize based on this fact.

as a library

npm install --save geojsonhint

as a web library

curl > geojsonhint.js


npm install -g geojsonhint
➟ geojsonhint
Usage: geojsonhint FILE.geojson
  --json  output json-formatted data for hints
➟ geojsonhint test.geojson
line 9, each element in a position must be a number


npm test

Building the browser version:

npm install -g browserify