Import/Export Data

RouteRef allows you to export your zone data for backup or analysis, and import zones from GeoJSON files.

Export Zones

Exporting to GeoJSON

1. Go to the Settings tab
2. Find the "Data Management" section
3. Click Export Zones
4. A GeoJSON file will download

What's Included

The export contains:

• All zone boundaries (polygons)
• Zone properties:
  • Zone name
  • Driver
  • Day
  • Color

GeoJSON Format

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "zoneName": "Downtown East",
        "driver": "Roger",
        "day": "Monday",
        "color": "#3b82f6"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[lng, lat], ...]]
      }
    }
  ]
}

Use Cases for Export

• Backup: Regular backups of your zone configuration
• Analysis: Import into GIS software for analysis
• Sharing: Share zone data with partners or consultants
• Migration: Move data to another system

Import Zones

Importing from GeoJSON

1. Go to the Settings tab
2. Find the "Data Management" section
3. Click Import Zones
4. Select your GeoJSON file
5. Review the preview
6. Click Import

File Requirements

Your GeoJSON file must:

• Be valid GeoJSON format
• Contain Polygon geometries
• Include these properties:
  • zoneName (required)
  • driver (required)
  • day (required)
  • color (optional, defaults assigned)

Before Importing

Warning: Import adds zones to your existing zones. It does not replace them.

• Review your current zones first
• Delete duplicates manually if needed
• Ensure drivers in the file exist in your system

Import Validation

The import process validates:

• File format is valid GeoJSON
• All required properties are present
• Polygon geometries are valid
• Zone count doesn't exceed your plan limit

Handling Import Errors

If import fails:

• Check the error message
• Validate your GeoJSON format
• Ensure all required fields are present
• Verify polygon geometries are closed

Best Practices

Regular Backups

• Export weekly or after major changes
• Store backups in a safe location
• Name files with dates: zones-2026-01-24.geojson

Before Major Changes

• Export before bulk edits
• Keep the backup until changes are verified

Data Validation

After importing:

1. Review zones on the map
2. Check zone count matches
3. Verify driver assignments
4. Test a few address searches

Working with GIS Software

Exported GeoJSON works with:

• QGIS (free, open source)
• ArcGIS (professional GIS)
• Google Earth Pro (free)
• Mapbox Studio (web-based)
• geojson.io (quick web viewer)

Troubleshooting

Export not downloading

• Check browser popup blockers
• Try a different browser
• Verify you have zones to export

Import shows 0 zones

• File may be empty or malformed
• Check GeoJSON structure
• Validate at geojson.io

Zones appear in wrong location

• Check coordinate order (GeoJSON uses [lng, lat])
• Verify coordinate system is WGS84
• Check for data projection issues

Missing properties after import

• Required fields may have different names
• Check property name spelling (case-sensitive)
• Manually edit zones after import if needed