← User Guide
Import many areas at once by uploading a CSV file. Each row becomes an area in your company, with its boundary given as a WKT polygon. This is the fastest way to load boundaries you already have in a GIS tool (QGIS, ArcGIS, PostGIS, Google Earth).
⚠️ Coordinates are longitude-first! WKT lists each point as longitude latitude (X then Y) — the opposite of the "latitude, longitude" order you see in Google Maps. A file with swapped coordinates imports successfully but places every area in the wrong part of the world. Always put longitude first.
ℹ️ Subscription: Area import requires a Silver or Gold subscription (Level 2+). On the Basic tier the import action is visible but prompts you to upgrade. You also need the Manager or Admin role.
How to Import
- Open the Areas list and tap the overflow menu (⋮) → Import from CSV.
- Tap Download Template to get a ready-made
geozone-import-template.csv with the correct headers and example rows.
- Fill in your rows in a spreadsheet app, then export/save as CSV.
- Tap Upload CSV File and select your file.
- The import runs in the background. When it finishes you'll see how many areas were created plus a list of any rows that were skipped and why.
💡 Tip: Export the geometry column straight from your GIS tool as WKT — QGIS, ArcGIS and PostGIS all produce longitude-first WKT, so it drops in without editing.
File Requirements
- Encoding: UTF-8 (with or without BOM)
- Delimiter: comma (
,)
- Quoting: wrap fields containing commas (such as the geometry cell) in double quotes (RFC 4180)
- Maximum file size: 2 MB
- Maximum rows: 500 data rows (excluding the header)
- Required headers: the file must contain both a
Title and a Geometry column
Columns
Column names are matched case-insensitively, leading/trailing spaces are trimmed, and unrecognized columns are ignored. Keep the column names in English exactly as below.
| Column |
Required |
Max length |
Valid values |
Title | Yes | 500 | Plain text |
Description | No | 5000 | Plain text |
Color | No | — | Hex color, e.g. #4CAF50 (or #RRGGBBAA) |
Icon | No | 50 | Icon key (unknown keys show a default icon) |
Owner | No | — | Username of an active company member |
BufferMeters | No | — | Whole number 0–300 (GPS presence buffer) |
Geometry | Yes | — | WKT POLYGON((lng lat, lng lat, ...)), longitude-first, closed ring |
The Geometry Column
- Use the WKT form
POLYGON((lng lat, lng lat, ...)) — each point is longitude then latitude, separated by a space; points are separated by commas.
- The ring must be closed: the last point must equal the first point. An unclosed ring is rejected.
- At least 3 distinct points are required.
- Longitude must be between -180 and 180; latitude between -90 and 90.
- The polygon must be valid — it must not cross over itself or have zero area.
- Only
POLYGON is supported (not POINT, LINESTRING, or MULTIPOLYGON).
Default Values
- Color: a default area color (when omitted or empty)
- Icon: none (when omitted or empty)
- Owner: the importing user (when omitted)
- BufferMeters: 100 (when omitted or empty)
Imported areas are placed at the polygon's center point; the street address is left blank (you can edit it later). New areas are created without project assignments or attachments.
Owner
- The Owner username is resolved case-insensitively against active members of your company (people and AI agents).
- If the username is not found, that row is skipped and the reason is reported.
- Leave it blank to make yourself the owner.
Validation & Partial Success
- Each row is validated on its own. Valid rows are imported even if other rows fail — one bad row never blocks the rest.
- When the import finishes you get the count of areas created plus a list of skipped rows, each with the row number and the reason.
- The import only fails entirely if every row is invalid.
⚠️ Rate limits: at most 3 area imports per company per hour and 10 imports per company per hour across all import types. If exceeded, the import is rejected with the time until the next attempt is allowed.
Example CSV
Title,Description,Color,Icon,Owner,BufferMeters,Geometry
"North Yard","Staging & storage","#4CAF50",warehouse,john.doe,100,"POLYGON((23.31 42.69, 23.32 42.69, 23.32 42.70, 23.31 42.70, 23.31 42.69))"
"Wellpad 7","","#F44336",,,150,"POLYGON((23.35 42.71, 23.36 42.71, 23.355 42.72, 23.35 42.71))"
The first row uses every optional column; the second leaves Description, Icon and Owner blank (they fall back to defaults). Both geometry cells are longitude-first and closed.
Attachments
CSV is text-only and cannot carry files or images. To attach files to an imported area, open it after import and add attachments through the normal area editor.
← Back to User Guide