Reverse geocode
GET/v2/reverse
Resolves geographic coordinates (latitude/longitude) to a GhanaPostGPS digital address.
Coordinates must be within Ghana's boundaries (roughly 4.0-12.0°N, -4.0-2.0°E).
Coordinates are rounded to ~10m precision for cache key consistency.
meta.boundary_distance_m and meta.near_grid_boundary flag when the
queried point sits close enough to the resolved cell's edge that a
slightly different GPS fix could have resolved to a neighbouring
cell's code — GhanaPostGPS's own documented "two codes for one
property" failure mode.
Landmark descriptors
Add descriptors=true to also describe the point the way people in
Ghana give directions: by the landmarks around it. The response gains
a descriptor object, for example
"text": "Opposite Shell filling station, Spintex Road, Baatsona".
landmarks: up to 3 recognisable places within 400 m (fuel stations, markets, malls, hospitals, churches and so on; small kiosks only when they are right there), most useful first.relationis how the point stands to each landmark:at,opposite(across the road),behind(same side, further from the road),beside,down_the_roadornear. Road relations are only given when the point and the landmark are on the same road; otherwise the relation isnear. Treatconfidence(0 to 1) as how much to trust the description.walking_mis the walking distance by road, when available.streetis the nearest road's name;areasare the area, district and region.
Show descriptor.text at checkout, on a rider's screen or in an SMS.
If descriptors can't be built, the address is still returned without
descriptor.
Request
Responses
- 200
- 400
- 404
- 429
- 502
Coordinates resolved to address
Invalid or missing coordinates
No address found for coordinates
Rate limit exceeded
Response Headers
Maximum requests allowed in the window
Requests remaining in current window
Seconds until the rate limit resets
Upstream service error