← Projects

Geographic data API

Tanzania Geo-Data API

A Django REST API for looking up Tanzania’s regions, districts and wards through a consistent set of endpoints.

My roleAPI design and implementation.
DATA HIERARCHY
Tanzania Geo-Data API
01Region
02District
03Ward

The API exposes geographic lookups at each level of the administrative hierarchy.

Overview

Project overview

  • Regions
  • Districts
  • Wards
  • JSON responses

Engineering contribution

My contribution

  • Exposed geographic lookup endpoints for applications.
  • Documented region, district and ward queries and response formats.

Technology & scope

  • Python
  • Django REST Framework

Technical details

Technical implementation

Administrative geography as a clear hierarchy: regions, districts and wards.

01

Administrative hierarchy

Region, district and ward lookups reflect the administrative structure documented by the API.

02

Geographic lookup endpoints

Applications can request the geographic records they need through the API rather than duplicating those lists in every interface.

Workflow

Geographic hierarchy

  1. 01

    Region

    Start with the top-level administrative area.

  2. 02

    District

    Look up the districts for the region.

  3. 03

    Ward

    Resolve the wards within a district.

The hierarchy follows the documented API. The historical hosted endpoint is not presented as a current live service.

Next projectUSSD & SMS Voting