LandmarkGeocodeResponse

Result of GET /v2/landmarks/geocode.

querystring

Echo of the q parameter, if supplied.

Example: kaneshie market

anchor object

The landmark an anchor name resolved to. Present only for anchored-by-name searches.

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>

matches object[]

Array [

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>

]

countinteger

Example: 3

LandmarkGeocodeResponse

{
  "query": "kaneshie market",
  "anchor": {
    "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"
    }
  },
  "matches": [
    {
      "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"
      }
    }
  ],
  "count": 3
}