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.

The basis of this tool is the published GeoJSON 1.0 specification. In the few cases where draft-geojson, the ietf-candidate version of GeoJSON, is more precise (for instance, the id property), the validator follows the draft spec as well.

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.

For byte-minimalists, you can require('geojsonhint/object') to get a version of this library that bypasses jsonlint-lines and provides only the object interface.

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