GeoCodes and Reverse Geocodes Ghana post GPS addresses
# GhanaPostGPS Geocoder
A QGIS plugin for geocoding and reverse-geocoding using Ghana's GhanaPostGPS digital address system.
## Features
- Convert GhanaPostGPS addresses (e.g. `AK-484-9321`) to latitude/longitude point features
- Convert point layers or coordinate pairs to GhanaPostGPS addresses
- Single address lookup with instant map visualization
- Batch geocoding from a text field in any vector layer
- Batch reverse-geocoding from any point layer
- Rich attribute output including Region, District, PostCode, Area, and Street
- Configurable API endpoint (default: `ghanapostgps.sperixlabs.org`)
## Requirements
- QGIS 3.16 or later
- Internet connection (plugin calls the GhanaPostGPS web API)
## Installation
### From the QGIS Plugin Repository
1. Open QGIS
2. Go to **Plugins → Manage and Install Plugins**
3. Search for **GhanaPostGPS Geocoder**
4. Click **Install Plugin**
### Manual Installation
1. Download the latest release from the GitHub repository.
2. Unzip the archive into your QGIS plugins directory:
- Linux/macOS: `~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/`
- Windows: `%APPDATA%\QGIS\QGIS3\profiles\default\python\plugins\`
3. Restart QGIS and enable the plugin from **Plugins → Manage and Install Plugins**.
## Usage
After enabling the plugin, open it from **Vector → GhanaPostGPS Geocoder** (or the toolbar icon). The dialog exposes tabs for:
- **Geocode**: enter a single GhanaPostGPS address to create a point on the map, or select a vector layer and a text field to batch-geocode.
- **Reverse Geocode**: enter coordinates or pick a point layer to obtain GhanaPostGPS addresses with region/district/postcode/area/street attributes.
- **Settings**: change the API endpoint if you need to use an alternative GhanaPostGPS service.
## Author
**Ben Emunah Aikins** —
## Contributors
- Precision GIS and Technology Consultancy Ltd.
## License
This plugin is released under the GNU General Public License v3.0 or later. See LICENSE for detail …