For the complete documentation index, see llms.txt. This page is also available as Markdown.

Troubleshooting

Solve common data upload issues in Felt with these troubleshooting tips and solutions.

ESRI Shapefiles

Shapefiles are a multi-file format, with each file containing some specific data. Three file parts are mandatory (.shp, .shx and .dbf) and, without any of them, your upload will not be successful.

A fourth component (.prj) is very common, and used to determine what Spatial Reference System should be used to interpret the coordinates in your data. If this file is not present, Felt will assume the coordinates are in latitude/longitude (represented by the EPSG code 4326).

Spreadsheets

See the Spreadsheets page for general information on tabular file formats like CSV or Excel.

Point coordinates

  • Coordinates must be in latitude and longitude. Projected coordinate systems, such as UTM, are not supported.

  • Coordinates can be in decimal degrees, such as 40.7128, or in degree notation, such as 40° 43' 50.1960'' N.

  • Coordinates can be in two separate fields, or combined in a single field such as 40.7128, -74.006.

Geocoding

  • By default, Felt will geocode address data for up to 10,000 addresses per upload. If you need a higher limit, contact sales to upgrade to our Enterprise plan.

  • Context is important. Make sure either your address field contains all the necessary information (city, state, country, etc) or you have several fields with that information.

  • See the Spreadsheets page for general information on how geocoding works.

Geomatching

See the Spreadsheets page for general information on how Geomatching works.

Matching threshold

Geomatching checks columns in your data for values that match codes or names in our available regions. If a column does not contain a majority of values that match, it will be discarded.

Duplicate & unique values

Geomatching works best with columns that have unique values. Otherwise, you might end up with the same polygon for California many times, superimposed.

To avoid that, the Geomatching process makes sure the amount of duplicate values (all values that are repeated at least two times) is under a certain threshold.

US FIPS codes

Make sure your US FIPS codes (states, counties, CBSAs and census tracts) aren’t missing leading zeroes. FIPS codes always have a fixed number of digits per boundary type: 2 for states, 5 for counties, 11 for census tracts, etc.

US ZIP codes

Similarly, ZIP codes should always have 5 digits, so watch out for missing leading zeroes. Also, Felt doesn’t currently understand ZIP+4 codes, so remove the extra suffix if present.

AutoCAD drawings

My drawing is in the wrong place

CAD drawings (.dwg, .dxf) only land at their true location when the drawing has a standard, earth-based coordinate system assigned in AutoCAD, or when its geometry is already in geographic coordinates. See the AutoCAD section of the Files page for the full requirements.

My drawing is missing objects

Entities that depend on proprietary object types from AutoCAD vertical products (such as Civil 3D surfaces, corridors, or alignments) may be skipped when Felt processes a drawing. Explode those objects into plain AutoCAD geometry before saving the drawing.

Unsupported file formats

QGIS metadata files (.qmd, .qgz, .qgs, .qml)

These files don't actually contain any data, just the metadata that defines a QGIS project (such as the style for layers in the project, references to the actual files, etc). Try uploading the original data files (Shapefiles, GeoPackages, GeoJSON, etc) instead.

ArcGIS layer files (.lyr and .lyrx)

Similarly, the ArcGIS Layer File format does not contain any actual data, but a reference to another file that stores the actual data (usually a Shapefile or Geodatabase). Try uploading the original data files to Felt instead.

Enhanced Compressed Wavelets (.ecw)

ECW is a proprietary format developed by Hexagon Geospatial. Try exporting your data as GeoTIFF (.tif) instead.

URL uploads

Maximum layers per upload

Felt will automatically try to parse and upload all layers from an ESRI or OGC service. However, Felt has a maximum of 50 layers per upload (see Limits). If the service hosts more than that amount, an error will be returned.

For OGC services, users can work around this by specifying which layers to request in the URL query parameters:

  • WMTS and WFS: a single layer in the form of ?layer=X

  • WMS: one or more layers in the form of ?layers=X,Y

Last updated

Was this helpful?