Guidelines

Tabular data such as spreadsheets can reference geography in many forms: explicitly with lat/lon points and geometries, or implicitly with zip codes, place names, or street addresses.

See the Geocoding Addresses and Geomatching Regions pages for more about data without lat/lons.

Uploads can include geographic data in unprojected decimal degrees latitude and longitude
Geographic fields should be given easy-to-find names, such as:
- geometry, wkt, or geom_wkt
- x & y
- lat & lon, latitude & longitude, or lat & lng
Whole geometries must be in one of these formats:
- Well Known Text (examples: POINT(-122 37), LINESTRING (-122 37, -123 38))
- Hex-encoded Well Known Binary (example: '01010000000000000000805ec00000000000804240')
- GeoJSON Geometry Objects (example: {'type': 'Point', 'coordinates': (-122.0, 37.0)})

Choosing Columns

Felt uses AI to identify the geometry columns in your data but we don’t always get it right first time. Fortunately, you can always pick the right ones - even if the upload failed!

Simply open the data table, select the appropriate columns and map them to the right field types. Remember: selecting address columns will result in Geocoding Addresses, while country names or ZIP codes will result in Geomatching Regions.

tabular_column_selection.mp4

Troubleshooting

See the Troubleshooting Data Problems page for common upload failures and how to fix them.