What Is GeoJSON? The Format Behind Parcel Data and Planning Maps
GeoJSON is the format county parcel layers, zoning boundaries, and most open-data portals produce. One file, plain JSON, readable in any text editor or browser. This covers how it's structured and what to do with it.
GeoJSON in Plain English
GeoJSON is a file format for storing geographic data (points, lines, and polygons) along with information about each feature.
GeoJSON stores geometry and properties together in one JSON object. A parcel entry looks like this:
- Shapefile: 3–7 binary files, Esri-controlled spec, 10-character field name limit
- GeoJSON: single plain-text file, RFC 7946 open standard, no field length limit
What Does GeoJSON Look Like?
A simplified example of a single parcel in GeoJSON format:
{
"type": "Feature",
"properties": {
"APN": "001-234-56",
"OWNER": "SMITH, JOHN",
"MAIL_ADDR": "123 Main St",
"MAIL_CITY": "Anytown",
"MAIL_STATE": "CA",
"MAIL_ZIP": "90001"
},
"geometry": {
"type": "Polygon",
"coordinates": [[[-118.2, 34.0], [-118.2, 34.1], ...]]
}
}
The Three Parts of a GeoJSON Feature
| Part | What It Contains | Example for Parcels |
|---|---|---|
type |
Always "Feature" for individual items | "Feature" |
properties |
Attribute data (the "spreadsheet" part) | Owner name, APN, mailing address |
geometry |
The shape and location | Polygon coordinates defining parcel boundary |
Geometry Types You'll Encounter
Point
A single location. Used for addresses, project sites, or any feature shown as a dot on a map.
"geometry": {
"type": "Point",
"coordinates": [-118.2437, 34.0522]
}
Polygon
A closed shape. Used for parcels, zoning districts, neighborhoods, or any area.
"geometry": {
"type": "Polygon",
"coordinates": [[[-118.25, 34.05], [-118.24, 34.05], ...]]
}
LineString
A line made of connected points. Used for streets, boundaries, or routes.
MultiPolygon
Several separate polygons treated as one feature. Common for parcels with detached portions or islands.
FeatureCollection: The Container
In practice you rarely work with a single Feature. You'll have a FeatureCollection: a container that holds many features.
{
"type": "FeatureCollection",
"features": [
{ /* parcel 1 */ },
{ /* parcel 2 */ },
{ /* parcel 3 */ },
// ... hundreds or thousands more
]
}
A county's parcel file can contain 100,000+ features in a single FeatureCollection.
Coordinates: How Location Works
GeoJSON uses longitude, latitude order, the opposite of what Google Maps shows. Both are in decimal degrees:
- Longitude = East-West position (negative values = West of Prime Meridian)
- Latitude = North-South position (positive values = Northern Hemisphere)
Properties: The Data You Care About
For public notice work, the properties object holds the useful data. County parcel files often include:
| Common Field | What It Contains |
|---|---|
APN / PARCEL_ID |
Assessor's Parcel Number |
OWNER / OWNER_NAME |
Property owner name |
MAIL_ADDR |
Mailing address street |
MAIL_CITY |
Mailing address city |
MAIL_STATE |
Mailing address state |
MAIL_ZIP |
Mailing address ZIP code |
SITUS_ADDR |
Property street address |
OWNER_NAME while another uses OWNERNAME or OWN_NAME. UrbanKit Studio lets you map your fields when uploading data.
Where to Get GeoJSON Parcel Data
See our detailed guide: How to Get Parcel GeoJSON Data from Your County GIS
Quick sources:
- County GIS portals: Search "[County Name] GIS open data"
- State clearinghouses: Some states aggregate parcel data statewide
- Commercial providers: Regrid, LightBox, Cotality
Working with Large Files
County-wide parcel files can be huge (50-200MB). To handle them:
- Don't open in a text editor: Use a tool like mapshaper.org
- Clip to your area: Extract the parcels you need before uploading
- Simplify geometry: Cuts file size with little visual impact
Common Issues and Fixes
File Too Large
County-wide parcel files can be 100MB+. Solutions:
- Use mapshaper to clip to your project area before uploading
- Simplify geometry (reduces detail but shrinks file size)
- Request a subset from your county GIS department
Wrong Coordinate System
If your parcels appear in the wrong location (off the coast of Africa, for example), they're in a local projection instead of WGS84. Use QGIS or mapshaper to reproject to EPSG:4326.
Missing or Garbled Properties
Attribute data sometimes doesn't transfer cleanly, especially with special characters. Check the original data source and re-export if needed.
"Invalid GeoJSON" Errors
Common causes:
- File is a different format (shapefile component, KML, etc.)
- File is corrupted or truncated (incomplete download)
- JSON syntax error (missing bracket or comma)
Validate at geojsonlint.com for specific error messages.
Ready to use your GeoJSON parcel data?
Related Resources
- How to Get Parcel GeoJSON Data from Your County GIS
- How to Convert ArcGIS REST JSON to GeoJSON (3 Methods): most county parcel layers hand back Esri JSON by default, not GeoJSON; this covers converting one to the other
- GeoJSON vs Shapefile: Which Format Should Planners Use?: the other format you'll run into at a county GIS department, and when to reach for it instead
- Public Notice Radius Requirements by Jurisdiction
- Deduplicating Mailing Lists: LLCs, Trusts, and Same-Owner Parcels