Addresses & Geocoding

Standardize African street addresses with autocomplete and accurate lat/lng.

GET

Return normalized address suggestions (LocationIQ, with a public OpenStreetMap/Nominatim fallback) with coordinates and structured components for street text queries. Country defaults to the authenticated user's country or NG.

Authentication: Public / None (rate-limited)

Query Parameters

Field	Type	Requirement	Description
q	string	Required	Search query string (e.g. "Admiralty Way, Lekki").
country	string	Optional	Two-letter ISO country code to restrict search. Allowed:`"NG""GH""KE""ZA"` Default: `NG`

Request ExampleHTTPS Live Endpoint

curl -X GET "https://api.tumr.app/api/v1/addresses/autocomplete/?q=Admiralty+Way&country=NG"

Response Payload

200 OK

application/json

{
  "country": "NG",
  "query": "Admiralty Way",
  "suggestions": [
    {
      "place_id": "322123240136",
      "description": "12 Admiralty Way, Lekki Phase 1, Lagos, Nigeria",
      "main_text": "12 Admiralty Way",
      "secondary_text": "Lekki Phase 1, Lagos, Nigeria",
      "latitude": 6.4474,
      "longitude": 3.4084,
      "components": {
        "street_number": "12",
        "street_name": "Admiralty Way",
        "area": "Lekki Phase 1",
        "city": "Lagos",
        "state_region": "Lagos",
        "country": "Nigeria",
        "country_code": "NG"
      }
    }
  ]
}

GET

Resolve an address suggestion place_id into exact geographic coordinates and structured locality components.

Authentication: Public / None (rate-limited)

Request ExampleHTTPS Live Endpoint

curl -X GET "https://api.tumr.app/api/v1/addresses/geocode/322123240136/"

Response Payload

200 OK

application/json

{
  "place_id": "322123240136",
  "latitude": 6.4474,
  "longitude": 3.4084,
  "formatted_address": "12 Admiralty Way, Lekki Phase 1, Lagos, Nigeria",
  "components": {
    "street_number": "12",
    "street_name": "Admiralty Way",
    "area": "Lekki Phase 1",
    "city": "Lagos",
    "state": "Lagos",
    "country": "Nigeria"
  }
}

Previous TopicWebhooks & Event Streams

Next TopicFleet & Rider Dispatch