Feature Files

Feature files are optional .geojson files found under the features/ folder.

Each feature file defines a custom region (aka geofence) where a brand or organization is considered valid.

• features/*
  • us/new_jersey.geojson
  • ca/quebec.geojson
  • and so on…

When naming a .geojson file, consider if the area you've drawn matches an existing ISO 3166-2 area. For example, if you're adding a .geojson for Alberta in Canada, then the ISO 3166-2:CA value of ca-ab.geojson would be ideal.

File contents

Each file should contain a single GeoJSON Feature. (Note: A FeatureCollection containing a single Feature is ok too - the build script can handle this.)

Only Polygon and MultiPolygon geometries are supported.

The build script will automatically generate an id property to match the filename.

Feature files look like this:

{
  "type": "Feature",
  "id": "new_jersey.geojson",
  "properties": {},
  "geometry": {
    "type": "Polygon",
    "coordinates": […]
  }
}

GeoJSON Protips

• There are many online tools to create or modify .geojson files.
• You can draw and edit GeoJSON polygons with geojson.io - (Editing MultiPolygons does not work in drawing mode, but you can edit the code directly).
• You can simplify GeoJSON files with mapshaper.org
• More than you ever wanted to know about GeoJSON