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.
require 'vendor/autoload.php';
use Uganda\Geo;
$geo = new Geo();
# Retrieve all districts
$all_districts = $geo->districts()->all();
echo $all_districts;
# Retrieve all counties in particular ditrict
$counties = $geo
->districts('Mukono')
->counties()->all();
echo $counties;
# Retrieve all sub counties under county in particular ditrict
$sub_counties = $geo
->districts('Mukono')
->counties('Mukono Municipality')
->sub_counties()->all();
echo $sub_counties;
# Retrieve all parishes in a sub county under county in particular ditrict
$parishes = $geo
->districts('Mukono')
->counties('Mukono Municipality')
->sub_counties('Goma Division')
->parishes()->all();
echo $parishes;
# Retrieve villages in a parish under a sub county under county in particular ditrict
$villages = $geo
->districts('Mukono')
->counties('Mukono Municipality')
->sub_counties('Goma Division')
->parishes('Nantabulirwa Ward')
->villages()->all();
echo $villages;
Retrieve Individual geo units data.
Retrieve all districts
# Query Districts
require 'vendor/autoload.php';
use Uganda\Geo;
$geo = new Geo();
$all_districts = $geo->districts()->all();
echo $all_districts;
{
"districts": {
"count": 135,
"data": [
{
"id": "98",
"name": "Abim"
},
{
"id": "68",
"name": "Adjumani"
},
{
"id": "23",
"name": "Agago"
},
...
]
}
}
Retrieve all counties in Uganda
require 'vendor/autoload.php';
use Uganda\Geo;
$geo = new Geo();
$counties = $geo->counties()->all();
echo $counties;
{
"counties": {
"count": 303,
"data": [
{
"id": "242",
"name": "Labwor County",
"district": "98"
},
{
"id": "166",
"name": "Adjumani East County",
"district": "68"
},
{
"id": "165",
"name": "Adjumani West County",
"district": "68"
},
...
]
}
}
Retrieve all sub counties in Uganda
require 'vendor/autoload.php';
use Uganda\Geo;
$geo = new Geo();
$sub_counties = $geo->sub_counties()->all();
echo $sub_counties;
{
"sub_counties": {
"count": 2120,
"data": [
{
"id": "242",
"name": "Labwor County",
"district": "98"
},
{
"id": "166",
"name": "Adjumani East County",
"district": "68"
},
{
"id": "165",
"name": "Adjumani West County",
"district": "68"
},
...
]
}
}
Retrieve all parishes in Uganda
require 'vendor/autoload.php';
use Uganda\Geo;
$geo = new Geo();
$parishes = $geo->parishes()->all();
echo $parishes;
{
"parishes": {
"count": 10365,
"data": [
{
"id": "9127",
"name": "Abongepach",
"subcounty": "1546"
},
{
"id": "9150",
"Name": "Adwal",
"subcounty": "1546"
},
{
"id": "7279",
"name": "Aninata",
"subcounty": "1546"
},
...
]
}
}
Retrieve villages in Uganda
require 'vendor/autoload.php';
use Uganda\Geo;
$geo = new Geo();
$villages = $geo->villages()->all();
echo $villages;
{
"villages": {
"count": 71250,
"data": [
{
"id":"57217",
"name":"ABONGEPACH",
"parish":"9127"
},
{
"id":"58161",
"name":"AMITA PRISON",
"parish":"9127"
},
{
"id":"58171",
"name":"AMONICEK",
"parish":"9127"
},
...
]
}
}
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
✨
 Timo Ek |
 Joshua Kusaasira |
 Marshud |
Contributors
✨
| Joshua Kusaasira |
License
This package is free software distributed under the terms of the MIT license.
2.8k Jan 6, 2023
8 Aug 9, 2022
101 Oct 19, 2022
223 Jan 5, 2023
288 Dec 24, 2022
486 Dec 31, 2022
7 Jul 18, 2022
61 Dec 14, 2022
3.7k Jan 7, 2023
4 Nov 12, 2022
74 Apr 12, 2020
180 Dec 28, 2022
0 Dec 19, 2022
362 Nov 27, 2022
103 Jan 2, 2023
3 Sep 22, 2022
1 Jan 6, 2022
1.1k Dec 22, 2022
2 Mar 29, 2022