Reference
File formats
MAIA reads spreadsheets and map files on upload, reads a PDF attached to chat, and writes CSV and Excel on export. This page lists each format, what it holds, and the rules that apply to it.
Spreadsheets MAIA reads#
| Format | Extension | Notes |
|---|---|---|
| CSV | Extension.csv | NotesLocation comes from an address column, latitude and longitude columns, or a WKT or GeoJSON column |
| TSV | Extension.tsv, .tab | NotesAs CSV |
| Excel | Extension.xlsx, .xlsm | NotesAs CSV |
| Parquet | Extension.parquet | NotesAs CSV |
Map files MAIA reads#
| Format | Extension | Notes |
|---|---|---|
| GeoJSON | Extension.geojson, .json | Notes |
| KML | Extension.kml | Notes |
| KMZ | Extension.kmz | NotesA zipped KML. The size after unpacking counts |
| GeoPackage | Extension.gpkg | Notes |
| Shapefile | Extension.zip | NotesOne zip that holds the .prj. The size after unpacking counts |
Rules on upload#
- A Shapefile is one zip that holds its
.prj. Loose files are rejected, and so is a zip with no.prj, since MAIA cannot know the coordinate system. - Any coordinate system works if the file names it. MAIA reprojects every shape to WGS84.
- One file per upload. To bring in two files, upload twice.
- A file over a row limit does not fail. MAIA offers Import first rows.
A valid Shapefile zip holds these four files, with one name:
sites.shp
sites.shx
sites.dbf
sites.prj| Limit | Value |
|---|---|
| File size | Value25 MB |
| Size after unpacking | Value200 MB |
| Rows, added as a layer or a table | Value10,000 |
| Rows, matched to parcels by address | Value1,000 |
How MAIA classifies a file and matches its rows is on the File upload page.
PDFs in chat#
Where PDF attachments are turned on, you can attach a PDF to a chat message. MAIA reads it as context for the conversation. It is not imported as data.
| Limit | Value |
|---|---|
| File size | Value10 MB |
| Encrypted PDFs | ValueNot accepted |
Formats MAIA writes#
Export is turned on per workspace. If you do not see Download CSV or Download Excel, ask support to turn it on.
| Format | Extension | In the app |
|---|---|---|
| CSV | Extension.csv | In the appDownload CSV from the table's options menu |
| Excel | Extension.xlsx | In the appDownload Excel from the table's options menu |
| CSV of saved contacts | Extension.csv | In the appDownload CSV on the project's Contacts page |
An export holds the layer as the table shows it, with its filters applied. A filtered view exports fewer rows than the layer holds.
| Option | What it adds |
|---|---|
| Include reasoning | What it addsA reasoning column beside each researched column |
| Include sources | What it addsA source column beside each researched column |
| Contact fields | What it addsThe contact fields you choose, such as work email or mobile phone |
Rules on export#
| Limit | Value |
|---|---|
| Rows per export | Value10,000 |
| Characters per cell | Value32,000 |
- MAIA does not export map formats. There is no GeoJSON, KML, or Shapefile export.
- Shared links carry no export. A viewer of a shared project cannot download it. See Sharing and publishing.