Skip to main content

GeocodeMatch

One result of free-text landmark geocoding. score (0–1 trigram similarity) is set for name searches; distance_m is set for anchored searches — only the relevant one is present.

idinteger<int64>
Example: 142
slugstring
Example: kaneshie-market
namestring
Example: Kaneshie Market
name_localstring
kindstring
Example: market
region_codestring
Example: GH-AA
sourcestring

Where this landmark record came from (osm/field/user_submitted). See provenance.source for the same distinction normalized to AfriHex's shared trust-tier vocabulary.

Example: osm
confidenceinteger

Possible values: >= 0 and <= 100

Example: 100
centroid object
lngnumber<double>
Example: -0.2335
latnumber<double>
Example: 5.5641
distance_minteger

Metres from the anchor point (anchored searches only).

Example: 120
scorenumber<double>

Trigram name similarity 0–1 (name searches only).

Example: 0.83
streetstring

Street or road the landmark is on.

Example: Spintex Road
house_numberstring
Example: 12
postcodestring
Example: GA-107-7875
wikidatastring

Wikidata entity ID when the landmark has one.

Example: Q13143603
wikipediastring

English Wikipedia page title when present.

Example: Accra Mall
photo_urlstring

Wikimedia Commons photo thumbnail when resolved (~130 landmarks; growing).

Example: https://upload.wikimedia.org/wikipedia/commons/thumb/9/9a/Accra_Mall.jpg/600px-Accra_Mall.jpg
phonestring

Contact phone number from OSM, when tagged.

Example: +233 30 274 0000
websitestring

Official website from OSM, when tagged.

Example: https://www.accramall.com
opening_hoursstring

Opening-hours string from OSM, when tagged.

Example: Mo-Su 09:00-22:00
provenance object

How a coordinate was established — a distinct axis from precision (how exact the point is) or confidence (how much it's trusted). A user_confirmed point can be spatially rough; a third_party_match point can be spatially precise and confidently wrong.

sourcestring

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]

Example: agent_verified
providerstring

The upstream/system that produced the point (e.g. "ghanapostgps", "osm", "google_open_buildings", "customer_app"), separate from source's trust tier.

Example: ghanapostgps
accuracy_metersnumber<double>

A physical measurement (GPS accuracy, computed drift, snap distance) — independent of confidence.

confidencenumber<double>

Trust score, 0.0–1.0.

Possible values: >= 0 and <= 1

Example: 0.85
verified_atstring<date-time>
GeocodeMatch
{
  "id": 142,
  "slug": "kaneshie-market",
  "name": "Kaneshie Market",
  "name_local": "string",
  "kind": "market",
  "region_code": "GH-AA",
  "source": "osm",
  "confidence": 100,
  "centroid": {
    "lng": -0.2335,
    "lat": 5.5641
  },
  "distance_m": 120,
  "score": 0.83,
  "street": "Spintex Road",
  "house_number": "12",
  "postcode": "GA-107-7875",
  "wikidata": "Q13143603",
  "wikipedia": "Accra Mall",
  "photo_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/9/9a/Accra_Mall.jpg/600px-Accra_Mall.jpg",
  "phone": "+233 30 274 0000",
  "website": "https://www.accramall.com",
  "opening_hours": "Mo-Su 09:00-22:00",
  "provenance": {
    "source": "agent_verified",
    "provider": "ghanapostgps",
    "accuracy_meters": 0,
    "confidence": 0.85,
    "verified_at": "2024-07-29T15:51:28.071Z"
  }
}