topnotch-automate/PostGPS-X

A precision micro-addressing system that extends Ghana's existing GhanaPostGPS digital addressing system with 0.5m resolution, enabling exact point-level location resolution within each 5m × 5m grid square. # PostGPS-X: Exact Location Extension for GhanaPostGPS A precision micro-addressing system that extends Ghana's existing GhanaPostGPS digital addressing system with 0.5m resolution, enabling exact point-level location resolution within each 5m × 5m grid square. ## 🎯 Project Overview **PostGPS-X** (PostGPS Exact Location Extension) augments the official GhanaPostGPS system by introducing a deterministic precision layer. It does **not replace** GhanaPostGPS but extends it in a backwards-compatible way. ### Key Features - **Precision Addressing**: Subdivides each 5m × 5m GhanaPostGPS square into 100 micro-cells (0.5m × 0.5m each) - **Deterministic**: Same GPS coordinates always produce the same precision address - **Backwards Compatible**: Preserves original GhanaPostGPS format (AZ-xxx-xxxx or AZ-xxxx-xxxx) - **Coordinate-Derived**: Addresses are computed purely from lat/lon (no manual assignment) - **Human-Friendly**: Short, readable format (e.g., `GA-183-8164-F3`) ## 📋 Address Format ### Base GhanaPostGPS Format ``` AZ-xxx-xxxx or AZ-xxxx-xxxx ``` Where: - `A` = Region code (first letter) - `Z` = District code (second letter) - `xxx` or `xxxx` = Postal code (3 or 4 digits, depending on region) - `xxxx` = Unique identifier for a 5m × 5m grid square ### PostGPS-X Precision Format ``` AZ-xxx-xxxx-RC or AZ-xxxx-xxxx-RC ``` Where: - `AZ-xxx-xxxx` or `AZ-xxxx-xxxx` = Original GhanaPostGPS address (unchanged) - `R` = Row letter (A-J, representing north-south position) - `C` = Column digit (0-9, representing east-west position) **Examples**: - `GA-183-8164-F3` (3-digit postal code) - Base address: `GA-183-8164` (5m × 5m square) - Micro-cell: `F3` (0.5m × 0.5m cell within the square) - `GA-1834-8164-F3` (4-digit postal code) - Base address: `GA-1834-8164` (5m × 5m square) - Micro-cell: `F3` (0.5m × 0.5m cell within the square) ## 🏗️ Architecture ``` GPS (lat, lon) ↓ GhanaPostGPS Resolver ↓ 5m × 5m Base Grid (AZ-xxx-xxxx or AZ-xxxx-xxxx) ↓ Micro-Grid Subdivision …