Skip to content

GeoJSON Specification / Overview

The GeoJSON file format is a specific JSON schema and includes geometry and properties for spatial data features. Benefits of GeoJSON include:

  • Single file, conducive to use with web services, static websites, and distributing datasets for visualization.
  • Text file, so easy to view, create, parse, and manage in a version control system.
  • No limits on feature attribute names (unlike Esri shapefiles)

Limitations of GeoJSON include:

  • Can result in large file size, for example because property names are repeated for each feature.
  • Specification does not explicitly define how to represent metadata and some geographic information system concepts such as symbolization.
  • Because the file format is free-format text, it is more difficult for software to access in asynchronous fashion by jumping around the file.
  • Because the file is JSON, comments are not allowed, unless included as data.
  • Support for special values such as null, NaN, and date/times vary.
  • Format specification for metadata is lacking.

See the following resources:

The following topics are covered in separate pages:

  • Comments - they are not directly supported by JSON, so how to implement?
  • Version - options for indicating version
  • Metadata - options for metadata
  • File Size - tips for reducing file size
  • Alternatives - alternatives to GeoJSON