Skip to main content

NearbyLocation

location object
gps_namestring

Canonical GhanaPostGPS name

Example: AKW4849321
addressstring

Address identifier

Example: AKW4849321
regionstring

Region name

Example: Ashanti
districtstring

District name

Example: Kwadaso
areastring

Area/neighborhood name

Example: Hemang
postcodestring

Postal code

Example: AKW484
streetstring

Street name (if known)

center_latitudenumber<double>

Center latitude of the address area

Example: 6.650080145273592
center_longitudenumber<double>

Center longitude of the address area

Example: -1.648700346667856
north_latitudenumber<double>

North boundary latitude

south_latitudenumber<double>

South boundary latitude

east_longitudenumber<double>

East boundary longitude

west_longitudenumber<double>

West boundary longitude

google_maps_urlstring

Direct link to view the location on Google Maps

Example: https://www.google.com/maps/search/?api=1&query=6.650080,-1.648700
quality_scorenumber<double>

Address confidence score (0.0–1.0) based on data completeness. Useful for KYC and address verification.

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 mapped address scores 1.0. Use a threshold (e.g. 0.7) to filter verified addresses.

Possible values: >= 0 and <= 1

Example: 0.85
distance_kmnumber<double>

Distance from origin in kilometers

Example: 0.23
NearbyLocation
{
"location": {
"gps_name": "AKW4849321",
"address": "AKW4849321",
"region": "Ashanti",
"district": "Kwadaso",
"area": "Hemang",
"postcode": "AKW484",
"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
},
"distance_km": 0.23
}