NearbyResponse
truedata object
origin object
descriptor object
Landmark-relative description of a point (/v2/reverse?descriptors=true).
One line to show people.
Opposite Shell filling station, Spintex Road, BaatsonaName of the nearest road, when known.
Spintex Roadlandmarks object[]
Shell filling stationfuel_stationPossible values: [at, opposite, behind, beside, down_the_road, near]
38Walking distance by road
52Possible values: >= 0 and <= 1
0.73Opposite Shell filling stationareas object[]
BaatsonaPossible values: [area, district, region]
Address data provider, such as mijoride or sperixlabs. Omitted on legacy records; distinct from provenance.source, which describes the evidence tier.
mijorideUTC time of the last successful provider refresh, not the time this response was served. Omitted when no refresh time is known; a last good record may be served during provider outages.
2026-11-13T15:34:44.033313459ZProvider-reported community or locality, separate from postal_area. Omitted when unavailable.
Official TownReadable postal area name, separate from the postcode identifier and the community or neighborhood. Omitted when unavailable.
Nyanyano 623Canonical GhanaPostGPS name
AKW4849321Address identifier
AKW4849321Region name
AshantiDistrict name
KwadasoArea/neighborhood name
HemangPostal code identifier, distinct from the readable postal_area name and the full digital address.
GS0623Street name (if known)
Center latitude of the address area
6.650080145273592Center longitude of the address area
-1.648700346667856North boundary latitude
South boundary latitude
East boundary longitude
West boundary longitude
Direct link to view the location on Google Maps
https://www.google.com/maps/search/?api=1&query=6.650080,-1.648700Address data completeness score (0.0–1.0), not independent verification of the building, resident, or positional accuracy.
Scoring breakdown:
- GPS name (0.15), Region (0.10), District (0.10), Postcode (0.10), Coordinates (0.15) = 0.60 base
- Area (0.10), Street (0.10), Bounding box (0.10), Maps URL (0.10) = 0.40 enrichment
A fully populated address scores 1.0. A threshold (e.g. 0.7) filters for completeness; it does not establish that an address is verified.
Possible values: >= 0 and <= 1
0.85Human-readable tier derived from quality_score: high (>= 0.8), medium (>= 0.5), low (< 0.5). A quick filter when you don't want to pick your own quality_score threshold.
Possible values: [high, medium, low]
highprovenance object
quality_score/confidence above measure data completeness, not independent ground-truth verification — every /v2/lookup and /v2/reverse result comes from a single source (matched against GhanaPostGPS's own registry), so provenance.source is always third_party_match here. Don't mistake a high quality_score for a customer- or agent-confirmed point — see /v2/address/resolve's provenance for the tiers that distinguish those.
device_gps: a live GPS/network/fused fix reported by a device
at request time. geocoded_text: inferred purely from
parsing/matching text or grid math, no real-world confirmation.
third_party_match: matched against an external dataset (OSM,
Google Open Buildings, GhanaPostGPS's own registry) without
independent confirmation on the ground. user_confirmed:
explicitly entered/confirmed by the address owner. agent_verified:
independently confirmed by a human or a real event — a field
agent's manual promotion, a signed proof-of-delivery — the
strongest tier.
Possible values: [device_gps, geocoded_text, third_party_match, user_confirmed, agent_verified]
agent_verifiedThe upstream/system that produced the point (e.g. "ghanapostgps", "osm", "google_open_buildings", "customer_app"), separate from source's trust tier.
ghanapostgpsA physical measurement (GPS accuracy, computed drift, snap distance) — independent of confidence.
Trust score, 0.0–1.0.
Possible values: >= 0 and <= 1
0.85Search radius in kilometers
1Number of nearby locations in this page
10Whether there are more results beyond this page
truePass this as the cursor query param to get the next page (distance_km value)
0.523000locations object[]
location object
descriptor object
Landmark-relative description of a point (/v2/reverse?descriptors=true).
One line to show people.
Opposite Shell filling station, Spintex Road, BaatsonaName of the nearest road, when known.
Spintex Roadlandmarks object[]
Shell filling stationfuel_stationPossible values: [at, opposite, behind, beside, down_the_road, near]
38Walking distance by road
52Possible values: >= 0 and <= 1
0.73Opposite Shell filling stationareas object[]
BaatsonaPossible values: [area, district, region]
Address data provider, such as mijoride or sperixlabs. Omitted on legacy records; distinct from provenance.source, which describes the evidence tier.
mijorideUTC time of the last successful provider refresh, not the time this response was served. Omitted when no refresh time is known; a last good record may be served during provider outages.
2026-11-13T15:34:44.033313459ZProvider-reported community or locality, separate from postal_area. Omitted when unavailable.
Official TownReadable postal area name, separate from the postcode identifier and the community or neighborhood. Omitted when unavailable.
Nyanyano 623Canonical GhanaPostGPS name
AKW4849321Address identifier
AKW4849321Region name
AshantiDistrict name
KwadasoArea/neighborhood name
HemangPostal code identifier, distinct from the readable postal_area name and the full digital address.
GS0623Street name (if known)
Center latitude of the address area
6.650080145273592Center longitude of the address area
-1.648700346667856North boundary latitude
South boundary latitude
East boundary longitude
West boundary longitude
Direct link to view the location on Google Maps
https://www.google.com/maps/search/?api=1&query=6.650080,-1.648700Address data completeness score (0.0–1.0), not independent verification of the building, resident, or positional accuracy.
Scoring breakdown:
- GPS name (0.15), Region (0.10), District (0.10), Postcode (0.10), Coordinates (0.15) = 0.60 base
- Area (0.10), Street (0.10), Bounding box (0.10), Maps URL (0.10) = 0.40 enrichment
A fully populated address scores 1.0. A threshold (e.g. 0.7) filters for completeness; it does not establish that an address is verified.
Possible values: >= 0 and <= 1
0.85Human-readable tier derived from quality_score: high (>= 0.8), medium (>= 0.5), low (< 0.5). A quick filter when you don't want to pick your own quality_score threshold.
Possible values: [high, medium, low]
highprovenance object
quality_score/confidence above measure data completeness, not independent ground-truth verification — every /v2/lookup and /v2/reverse result comes from a single source (matched against GhanaPostGPS's own registry), so provenance.source is always third_party_match here. Don't mistake a high quality_score for a customer- or agent-confirmed point — see /v2/address/resolve's provenance for the tiers that distinguish those.
device_gps: a live GPS/network/fused fix reported by a device
at request time. geocoded_text: inferred purely from
parsing/matching text or grid math, no real-world confirmation.
third_party_match: matched against an external dataset (OSM,
Google Open Buildings, GhanaPostGPS's own registry) without
independent confirmation on the ground. user_confirmed:
explicitly entered/confirmed by the address owner. agent_verified:
independently confirmed by a human or a real event — a field
agent's manual promotion, a signed proof-of-delivery — the
strongest tier.
Possible values: [device_gps, geocoded_text, third_party_match, user_confirmed, agent_verified]
agent_verifiedThe upstream/system that produced the point (e.g. "ghanapostgps", "osm", "google_open_buildings", "customer_app"), separate from source's trust tier.
ghanapostgpsA physical measurement (GPS accuracy, computed drift, snap distance) — independent of confidence.
Trust score, 0.0–1.0.
Possible values: >= 0 and <= 1
0.85Distance from origin in kilometers
0.23meta object
Unique request identifier
c86825f0-d8ca-4ae1-8226-514cc48e05c0Whether the response was served from cache
falseServer-side processing time
1.802457582sReverse-geocode responses only. Distance in metres from the queried coordinate to the nearest edge of the resolved GhanaPostGPS grid cell. Omitted when the upstream response carried no cell bounds.
1.42Reverse-geocode responses only. True when boundary_distance_m is small enough that an ordinary GPS fix's jitter could plausibly have resolved to the neighbouring cell's code instead — the documented cause of the same property getting different GhanaPostGPS codes depending on where you stand.
false{
"success": true,
"data": {
"origin": {
"descriptor": {
"text": "Opposite Shell filling station, Spintex Road, Baatsona",
"street": "Spintex Road",
"landmarks": [
{
"id": 0,
"name": "Shell filling station",
"kind": "fuel_station",
"relation": "at",
"straight_line_m": 38,
"walking_m": 52,
"confidence": 0.73,
"text": "Opposite Shell filling station"
}
],
"areas": [
{
"name": "Baatsona",
"type": "area"
}
]
},
"source": "mijoride",
"refreshed_at": "2026-11-13T15:34:44.033313459Z",
"community": "Official Town",
"postal_area": "Nyanyano 623",
"gps_name": "AKW4849321",
"address": "AKW4849321",
"region": "Ashanti",
"district": "Kwadaso",
"area": "Hemang",
"postcode": "GS0623",
"street": "string",
"center_latitude": 6.650080145273592,
"center_longitude": -1.648700346667856,
"north_latitude": 0,
"south_latitude": 0,
"east_longitude": 0,
"west_longitude": 0,
"google_maps_url": "https://www.google.com/maps/search/?api=1&query=6.650080,-1.648700",
"quality_score": 0.85,
"confidence": "high",
"provenance": {
"source": "agent_verified",
"provider": "ghanapostgps",
"accuracy_meters": 0,
"confidence": 0.85,
"verified_at": "2024-07-29T15:51:28.071Z"
}
},
"radius_km": 1,
"count": 10,
"has_more": true,
"next_cursor": "0.523000",
"locations": [
{
"location": {
"descriptor": {
"text": "Opposite Shell filling station, Spintex Road, Baatsona",
"street": "Spintex Road",
"landmarks": [
{
"id": 0,
"name": "Shell filling station",
"kind": "fuel_station",
"relation": "at",
"straight_line_m": 38,
"walking_m": 52,
"confidence": 0.73,
"text": "Opposite Shell filling station"
}
],
"areas": [
{
"name": "Baatsona",
"type": "area"
}
]
},
"source": "mijoride",
"refreshed_at": "2026-11-13T15:34:44.033313459Z",
"community": "Official Town",
"postal_area": "Nyanyano 623",
"gps_name": "AKW4849321",
"address": "AKW4849321",
"region": "Ashanti",
"district": "Kwadaso",
"area": "Hemang",
"postcode": "GS0623",
"street": "string",
"center_latitude": 6.650080145273592,
"center_longitude": -1.648700346667856,
"north_latitude": 0,
"south_latitude": 0,
"east_longitude": 0,
"west_longitude": 0,
"google_maps_url": "https://www.google.com/maps/search/?api=1&query=6.650080,-1.648700",
"quality_score": 0.85,
"confidence": "high",
"provenance": {
"source": "agent_verified",
"provider": "ghanapostgps",
"accuracy_meters": 0,
"confidence": 0.85,
"verified_at": "2024-07-29T15:51:28.071Z"
}
},
"distance_km": 0.23
}
]
},
"meta": {
"request_id": "c86825f0-d8ca-4ae1-8226-514cc48e05c0",
"cached": false,
"latency": "1.802457582s",
"boundary_distance_m": 1.42,
"near_grid_boundary": false
}
}