🗺️ BhuX — UP Bhunaksha Geo-Referencing Tool

Convert Uttar Pradesh Bhunaksha UTM coordinates to Latitude/Longitude
and visualize land plots on interactive satellite maps

🌐 Try it Live → sonuverma11.github.io/bhux

---

📋 Table of Contents

• The Problem
• The Solution
• Demo Video
• Screenshots
• Features
• Quick Start
• How to Use
• Technical Details
• Project Structure
• Use Cases
• Contributing
• License

---

🔴 The Problem

The Uttar Pradesh Revenue Department provides land record maps called Bhunaksha (भूनक्शा) that contain plot boundary sketches. These maps express coordinates in UTM (Universal Transverse Mercator) format — specifically Zone 43N using the WGS84 datum.

The coordinates are given as Easting (X) and Northing (Y) values in meters, for example:

498234.56, 2952341.23
498289.12, 2952338.45
498291.78, 2952289.67

The problems with these raw coordinates:

Issue	Impact
❌ Can't use in Google Maps	No way to view the plot location
❌ No GPS device compatibility	Can't navigate to the plot
❌ No satellite overlay	Can't verify boundaries visually
❌ No official conversion tool	Landowners are stuck
❌ No area calculation	Can't compute plot area in बीघा/Acre
❌ No digital sharing	Can't share plot data electronically

---

✅ The Solution

BhuX is a free, open-source web tool that:

1. Converts UTM Zone 43N coordinates → WGS84 Latitude/Longitude
2. Visualizes plot boundaries on interactive satellite maps
3. Calculates area in म², sq.ft, बीघा (Bigha), बिस्वा (Biswa), Acres, Hectares
4. Exports geo-referenced data as GeoJSON, KML, CSV
5. Runs entirely in-browser — no server, no signup, no installation

---

🎥 Demo Video

Full walkthrough showing coordinate input, map visualization, area calculation, and export.

---

📸 Screenshots

🏠 Landing Page — Map & Input Panel

Dark-themed interface with coordinate input on the left and interactive satellite map on the right. Map defaults to Uttar Pradesh view.

🗺️ Plot Visualization on Satellite Map

Plot polygon rendered on satellite/street map with corner markers, area label, and edge distance measurements.

📊 Area Statistics Dashboard

Area calculated in 8 units: Square Meters, Square Feet, बीघा (Bigha), बिस्वा (Biswa), Acres, Hectares, Perimeter, and Vertex count.

📋 Coordinate Conversion Table

Side-by-side UTM (Easting/Northing) and WGS84 (Lat/Lng) values with copy and locate-on-map actions for each point.

📥 Export & Share Panel

Export your geo-referenced plot as GeoJSON (for GIS), KML (for Google Earth), CSV (for Excel), shareable URL, or print.

🔄 Reverse Conversion (Lat/Lng → UTM)

Convert any Latitude/Longitude back to UTM coordinates. Useful for cross-referencing with Bhunaksha records.

---

✨ Features

Core Features

Feature	Description
🔄 UTM → Lat/Lng	Zone 43N WGS84 conversion with sub-meter precision
🛰️ Satellite Map	Leaflet with Esri Satellite, OpenStreetMap, and Topo layers
📐 Plot Polygon	Boundary visualization with corner markers
📏 Edge Distances	Toggle boundary edge measurements in meters
📊 Area Calculator	m², sq.ft, acres, hectares, बीघा, बिस्वा
📋 Conversion Table	UTM + Lat/Lng side-by-side with copy actions
📁 File Upload	CSV/JSON drag-and-drop with auto-parsing
📍 Sample Data	Pre-loaded plots from Lucknow, Varanasi, Agra

Export & Sharing

Format	Use Case
🌐 GeoJSON	GIS software, QGIS, web mapping libraries
🌍 KML	Google Earth, Google Maps My Maps
📊 CSV	Excel, Google Sheets, data analysis
🔗 Share Link	URL with embedded coordinates
🖨️ Print	Print-optimized map layout

Advanced

Feature	Description
🔄 Reverse Conversion	Lat/Lng → UTM for cross-referencing
⚠️ UP Validation	Warns if coordinates fall outside UP boundaries
⌨️ Keyboard Shortcuts	Ctrl+Enter to process coordinates
📱 Responsive	Works on desktop, tablet, and mobile
🌙 Dark Mode	Premium dark glassmorphic theme
🚫 Zero Dependencies	Pure HTML/CSS/JS — no npm, no build step

---

🚀 Quick Start

Option 1: Direct Open (Simplest)

# Just open the file in your browser
open index.html
# or on Linux:
xdg-open index.html

Option 2: Local Server (Recommended)

# Clone the repository
git clone https://github.com/SONUVERMA11/bhux.git
cd bhux

# Start a local server (Python)
python3 -m http.server 8080

# Or with Node.js
npx serve .

# Open in browser
# http://localhost:8080

No build step. No npm install. No dependencies. Just serve and open.

---

📖 How to Use

Step 1️⃣ — Get Your UTM Coordinates

1. Visit the UP Bhunaksha Portal
2. Navigate to your district → tehsil → village
3. Click on your plot to view the boundary sketch
4. Note down the X (Easting) and Y (Northing) coordinate pairs from the sketch

Step 2️⃣ — Enter Coordinates in BhuX

Manual Entry:

Enter one coordinate pair per line:
498234.56, 2952341.23
498289.12, 2952338.45
498291.78, 2952289.67
498237.34, 2952292.89

File Upload:

• Prepare a CSV file with columns: Easting, Northing or X, Y
• Drag and drop the file onto the upload zone
• Supports .csv, .json, and .txt formats

Sample Data:

• Click the "📍 Samples" tab to try pre-loaded plots from Lucknow, Varanasi, or Agra

Step 3️⃣ — Fill Plot Details (Optional)

• Enter District (जिला), Tehsil (तहसील), Village (गाँव), and Plot Number (खाता)
• These details are included in exported files

Step 4️⃣ — Click "Convert & Map"

The tool will:

• ✅ Convert all UTM coordinates to Lat/Lng
• ✅ Draw the plot polygon on the satellite map
• ✅ Calculate area in multiple units
• ✅ Display the coordinate conversion table
• ✅ Show a warning if coordinates are outside UP boundaries

Step 5️⃣ — Explore the Results

• Switch map layers — Satellite, Street, Terrain
• Toggle edge labels — Click "Edges" button to show boundary distances
• Click any point in the table to locate it on the map
• Copy coordinates — Click the copy icon to copy Lat/Lng

Step 6️⃣ — Export Your Data

Button	What You Get
GeoJSON	.geojson file with polygon + properties + individual points
KML	.kml file ready to open in Google Earth
CSV	.csv file with all coordinates + area summary
Share Link	Copies a URL you can share with anyone
Print	Opens the print dialog with a clean map layout

Bonus: Reverse Conversion

Click "Reverse" in the header to convert any Lat/Lng back to UTM coordinates. Useful for:

• Cross-referencing with Bhunaksha records
• Verifying your conversion results
• Converting Google Maps coordinates to UTM format

---

🧮 Technical Details

UTM Conversion Parameters

Parameter	Value
UTM Zone	43N
Central Meridian	75°E
Scale Factor (k₀)	0.9996
False Easting	500,000 m
False Northing	0 m (Northern Hemisphere)
Ellipsoid	WGS84
Semi-major axis (a)	6,378,137 m
Flattening (f)	1/298.257223563

Area Unit Conversions

Unit	Equivalent
1 बीघा (Bigha, UP Standard)	2,529.285 m²
1 बिस्वा (Biswa)	126.464 m²
1 Bigha	20 Biswa
1 Acre	4,046.86 m²
1 Hectare	10,000 m²

Conversion Algorithm

The conversion uses the Transverse Mercator projection with the following approach:

1. Compute the footpoint latitude from the meridian arc
2. Apply series expansion for latitude correction
3. Compute longitude from the central meridian offset
4. Results are accurate to sub-meter precision

---

📁 Project Structure

bhux/
├── index.html                    # Main application (single page)
├── css/
│   └── style.css                 # Complete design system (dark theme)
├── js/
│   ├── utm.js                    # UTM ↔ WGS84 conversion engine
│   ├── map.js                    # Leaflet map controller
│   ├── export.js                 # GeoJSON/KML/CSV export
│   ├── utils.js                  # Parsing, notifications, sample data
│   └── app.js                    # Main app orchestration
├── assets/
│   ├── banner.png                # GitHub banner
│   ├── demo.webp                 # Demo video/animation
│   └── screenshots/              # Section screenshots
│       ├── 01_hero_and_map.png
│       ├── 02_plot_on_map.png
│       ├── 03_stats_grid.png
│       ├── 04_coordinate_table.png
│       ├── 05_export_panel.png
│       └── 06_reverse_conversion.png
└── README.md                     # This file

---

🎯 Use Cases

Who	Use Case
👨‍🌾 Farmers / Landowners	Verify plot boundaries on satellite imagery
📐 Surveyors	Cross-reference Bhunaksha data with GPS measurements
⚖️ Lawyers	Generate geo-referenced evidence for land disputes
🏗️ Real Estate	Visualize and share plot locations with clients
🏛️ Govt Officials	Verify land records against satellite data
📊 Researchers	Extract geo-referenced land data for analysis
👨‍💻 Developers	Export GeoJSON/KML for GIS integration

---

🛠️ Technology Stack

Component	Technology
Structure	HTML5 Semantic
Styling	Vanilla CSS (Custom Properties, Glassmorphism)
Logic	Vanilla JavaScript ES6+
Mapping	Leaflet.js v1.9.4
Satellite Tiles	Esri World Imagery
Street Tiles	OpenStreetMap
Fonts	Inter + JetBrains Mono

---

🤝 Contributing

Contributions are welcome! Here are some ideas:

• Add support for UTM Zone 44N (eastern UP districts)
• Integrate with UP Bhunaksha API for direct plot lookup
• Add Hindi-only mode (पूर्ण हिंदी)
• Implement drawing mode to create polygons by clicking on map
• Add PDF report generation with map + details
• Support for other Indian states' Bhunaksha systems

# Fork → Clone → Branch → Code → PR
git checkout -b feature/your-feature
git commit -m "Add: your feature description"
git push origin feature/your-feature

---

📄 License

This project is licensed under the MIT License — free for personal and commercial use.

---

Built with ❤️ to solve real land record problems in Uttar Pradesh
_{If this helped you, consider giving it a ⭐ on GitHub!}