Skip to content

Uganda's geo data i.e districts, counties, subcounties, parishes & villages.

License

Notifications You must be signed in to change notification settings

Marshud/uganda-geo-data

 
 

Repository files navigation

Uganda Geo Data

This is a PHP package that retrieves Uganda's districts with their respective counties, sub counties, parishes and villages in Uganda. This data has been scrapped off Uganda's passport's official portal.

Description

This package gives you the leverage to access all sub levels ranging from districts, counties, subcounties, parishes to villages in Uganda. You can also access the different mentioned areas independently.

Table of Contents

Requirements

In order to run this project, ensure that you have installed;

  • PHP 7.4 or later
  • Composer

Installation

This project using composer.

$ composer require kusaasira/uganda-geo

Usage

The examples below show examples of usage of the package and their resulting outputs

Retrieve Districts data.

use Uganda\Geo;

$uganda = new Geo();

# Retrieve all districts
$districts = $uganda->districts();

# Retrieve all counties in a particular district
$counties = $uganda
    ->district('Mukono')
    ->counties();

# Retrieve all sub counties in a particular district
$subCounties = $uganda
    ->district('Mukono')
    ->subCounties();


# Retrieve all parishes in a particular district
$parishes = $uganda
    ->district('Mukono')
    ->parishes();

# Retrieve all villages in a particular district
$villages = $uganda
    ->district('Mukono')
    ->villages();

Retrieve County data.

use Uganda\Geo;

$uganda = new Geo();

# Retrieve all counties
$counties = $uganda->counties();

# Retrieve specific county
$county = $uganda->county('Adjumani West County');

# Retrieve all sub counties in a particular county
$subCounties = $uganda
    ->county('Adjumani West County')
    ->subCounties();

# Retrieve all parishes in a particular county
$parishes = $uganda
    ->county('Adjumani West County')
    ->parishes();

# Retrieve all villages in a particular county
$villages = $uganda
    ->county('Adjumani West County')
    ->villages();

Retrieve Sub County data.

use Uganda\Geo;

$uganda = new Geo();

# Retrieve all sub counties
$subCounties = $uganda->subCounties();

# Retrieve specific sub county
$subCounty = $uganda->subCounty('Namasale Town Council');

# Retrieve all parishes in a particular sub county
$parishes = $uganda
    ->county('Namasale Town Council')
    ->parishes();

# Retrieve all villages in a particular sub county
$villages = $uganda
    ->county('Namasale Town Council')
    ->villages();

Retrieve Parish data.

use Uganda\Geo;

$uganda = new Geo();

# Retrieve all parishes
$parishes = $uganda->parishes();

# Retrieve specific parish
$parish = $uganda->parish('Bunamwamba');

# Retrieve all villages in a particular parish
$villages = $uganda
    ->county('Bunamwamba')
    ->villages();

Retrieve Village data.

use Uganda\Geo;

$uganda = new Geo();

# Retrieve all villages
$villages = $uganda->villages();

# Retrieve specific village
$subCounty = $uganda->village('Ayeye');

Credits

The data used in this package has been scrapped off This data has been scrapped off Uganda's passport's official portal as there is no updated geo data source since 2018 published anywhere.

Collaborators ✨

timek
Tim3k
kusaasira
Joshua Kusaasira
Marshud
Marshud

Contributors ✨

kusaasira
Joshua Kusaasira
RoadSigns
Zack

License

This package is free software distributed under the terms of the MIT license.

About

Uganda's geo data i.e districts, counties, subcounties, parishes & villages.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 100.0%