Log inSign up
danny
dannypolygonParser
eCFR geospatial data extraction utility
Public
Like
polygonParser
Code
5
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
Search
README.md

eCFR Polygon Converter

A professional geospatial data extraction engine designed for parsing government location data from eCFR §202.1401 and converting it to standardized polygon formats. Features a modern dark-mode technical interface with advanced visualization capabilities.

Features

  • Advanced URL Processing: Automated eCFR API endpoint data extraction
  • Multi-Format Parser: Support for various coordinate data formats and structures
  • Real-Time Visualization: Interactive dark-themed Leaflet maps with technical styling
  • Professional Export: Standards-compliant GeoJSON and CSV output formats
  • Data Provenance: Automatic source URL and timestamp tracking for all conversions
  • Technical Interface: Dark mode UI with monospace fonts and terminal-inspired design
  • Robust Processing: Advanced regex pattern matching and coordinate validation

Technical Specifications

Supported Input Protocols

  • eCFR API endpoints with automatic content extraction
  • Raw coordinate data with area ID prefixes
  • Tab-delimited coordinate datasets
  • Mixed format coordinate documents
  • Unicode minus sign handling and normalization

Output Formats

  • GeoJSON: RFC 7946 compliant geospatial data with embedded provenance metadata
  • CSV: Simplified coordinate export with provenance headers for analysis tools
  • Interactive Maps: Leaflet.js with dark CartoDB tiles
  • Real-time Preview: Live polygon rendering and validation

Processing Pipeline

  1. Input Validation → URL fetch or text parsing
  2. Provenance Recording → Source URL and timestamp capture
  3. Coordinate Extraction → Advanced regex pattern matching
  4. Polygon Construction → Vertex validation and closure
  5. GeoJSON Serialization → RFC 7946 compliance with metadata
  6. Spatial Rendering → Leaflet integration with technical styling

Usage

  1. Select Input Method: Choose between URL endpoint or raw data input
  2. Data Input: Paste eCFR URL or coordinate data into the interface
  3. Execute Parse: Process data through the extraction engine with automatic provenance tracking
  4. Review Provenance: Check source URL, retrieval timestamp, and processing details
  5. Spatial Preview: Review polygons on the interactive dark-themed map
  6. Export Data: Download in GeoJSON or CSV formats with embedded provenance metadata

Architecture

  • Backend: Hono.js API framework with TypeScript
  • Frontend: React 18 with professional dark mode styling
  • Mapping: Leaflet.js with CartoDB dark tiles
  • Styling: Custom dark theme with technical monospace typography
  • Processing: Advanced coordinate parsing with multiple fallback methods

Interface Design

The application features a professional technical aesthetic with:

  • Dark gray color scheme (#111827, #1f2937, #374151)
  • Emerald accent colors (#10b981, #065f46)
  • Monospace typography for technical elements
  • Terminal-inspired status indicators
  • Grid-based layout with technical specifications panel
HTTP
Code