Skip to main content

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.
  • relation is how the point stands to each landmark: at, opposite (across the road), behind (same side, further from the road), beside, down_the_road or near. Road relations are only given when the point and the landmark are on the same road; otherwise the relation is near. Treat confidence (0 to 1) as how much to trust the description.
  • walking_m is the walking distance by road, when available.
  • street is the nearest road's name; areas are 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​

Coordinates resolved to address