Cesium CSV/Geo Viewer

Interactive web viewer for CSV/GeoJSON geospatial data. Drag & drop your file and explore layers, styles, and attributes in 3D.

Why this viewer?

• Upload CSV/GeoJSON instantly (no backend).
• Auto-detects lon/lat and renders points, lines, or polygons.
• Preserves user-defined category colors (e.g., a categoria column).
• Attribute panel with dynamic popups and search.
• Works offline (static hosting) and supports large files (browser memory dependent).

Use cases

• Quick inspection of field data (points/lines/polygons).
• Sharing results with non-technical audiences.
• Teaching/demo of geospatial workflows without installing software.
• Public exhibitions of maps and layers with minimal setup.

Quick Start

1. Clone or download this repo.
2. Open index.html in a modern browser (or serve with any static server).
3. Drag & drop your CSV (or GeoJSON) onto the page.
4. Use the Layer Panel to toggle visibility, styling, and labels.

Tip: Host it on GitHub Pages or any static host for a public demo.

Data format

CSV required columns

• lon, lat (decimal degrees, WGS84).

Optional but recommended

• name or id for labels.
• categoria to keep your original colors per category.
• Any other columns will appear as attributes in the popup.

Special datasets (example for polygons built from nodes+edges):

• example_nodos.csv and example_edges.csv must be uploaded together.
• example_edges.csv may not include lon/lat but references nodes/IDs that the viewer will connect to build polygons.

Styling

• Categories (from categoria) map to consistent colors.
• Default point symbol, size, and label are configurable in the UI.
• Basic layer ordering and transparency controls included.

Examples

• data/sample_points.csv
• data/example_edges.csv + data/example_nodos.csv
• docs/screens/ for screenshots

FAQ

Q: My file loads but nothing shows.
A: Check column names are exactly lon and lat (lowercase), numeric, and in WGS84.

Q: Colors don’t match my categories.
A: Ensure a categoria column exists. The viewer uses it to preserve colors.

Q: Polygons from nodes/edges don’t appear.
A: Upload both files and verify shared keys/IDs are consistent.

Q: Large files?
A: Browser memory limits apply. Consider tiling or simplifying geometries.

Roadmap

• Attribute filters & simple queries.
• Legend export and shareable permalinks.
• Basic GeoTIFF/WMTS basemap options.
• Mobile layout polish.

Citation & Credits

If you use this viewer, please cite:

Sierra Macay, D. B. (2025). Cesium CSV/Geo Viewer: Interactive visualization tool for geospatial CSV datasets. C3 – Universidad Nacional Autónoma de México.

Developed in the context of research at C3 – UNAM.
License: MIT (see LICENSE).