{"id":37235943,"url":"https://github.com/kusaasira/uganda-geo-data","last_synced_at":"2026-01-16T04:51:38.499Z","repository":{"id":41874043,"uuid":"485117846","full_name":"kusaasira/uganda-geo-data","owner":"kusaasira","description":"Uganda's geo data i.e districts, counties, subcounties, parishes \u0026 villages.","archived":false,"fork":false,"pushed_at":"2024-02-18T15:37:55.000Z","size":822,"stargazers_count":10,"open_issues_count":4,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-14T14:49:29.148Z","etag":null,"topics":["districts-in-uganda","districts-uganda","hacktoberfest","hacktoberfest2022","uganda"],"latest_commit_sha":null,"homepage":"https://packagist.org/packages/kusaasira/uganda-geo","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kusaasira.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-24T19:14:48.000Z","updated_at":"2025-11-30T08:45:52.000Z","dependencies_parsed_at":"2023-02-08T13:46:40.845Z","dependency_job_id":null,"html_url":"https://github.com/kusaasira/uganda-geo-data","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kusaasira/uganda-geo-data","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusaasira%2Fuganda-geo-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusaasira%2Fuganda-geo-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusaasira%2Fuganda-geo-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusaasira%2Fuganda-geo-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kusaasira","download_url":"https://codeload.github.com/kusaasira/uganda-geo-data/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kusaasira%2Fuganda-geo-data/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28442357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-15T00:55:22.719Z","status":"online","status_checked_at":"2026-01-15T02:00:08.019Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["districts-in-uganda","districts-uganda","hacktoberfest","hacktoberfest2022","uganda"],"created_at":"2026-01-15T04:05:19.096Z","updated_at":"2026-01-15T04:05:19.670Z","avatar_url":"https://github.com/kusaasira.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Uganda Geo Data\n\nThis 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](https://passports.go.ug).\n\n# Description\n\nThis 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.\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n  - [Retrieve Districts data](#retrieve-districts-data)\n  - [Retrieve Individual geo units data.](#retrieve-individual-geo-units-data)\n- [Credits](#credits)\n- [Contributions](#contributions)\n- [License](#license)\n\n## Requirements\n\nIn order to run this project, ensure that you have installed;\n\n- PHP 7.4 or later\n- Composer\n\n## Installation\n\nThis project using composer.\n\n```\n$ composer require kusaasira/uganda-geo\n```\n\n## Usage\n\nThe examples below show examples of usage of the package and their resulting outputs\n\n### Retrieve Districts data.\n\n```php\nuse Uganda\\Uganda;\n\n$uganda = new Uganda();\n\n# Retrieve all districts\n$districts = $uganda-\u003edistricts();\n\n# Retrieve all counties in a particular district\n$counties = $uganda\n    -\u003edistrict('Mukono')\n    -\u003ecounties();\n\n# Retrieve all sub counties in a particular district\n$subCounties = $uganda\n    -\u003edistrict('Mukono')\n    -\u003esubCounties();\n\n\n# Retrieve all parishes in a particular district\n$parishes = $uganda\n    -\u003edistrict('Mukono')\n    -\u003eparishes();\n\n# Retrieve all villages in a particular district\n$villages = $uganda\n    -\u003edistrict('Mukono')\n    -\u003evillages();\n```\n\n### Retrieve County data.\n\n```php\nuse Uganda\\Uganda;\n\n$uganda = new Uganda();\n\n# Retrieve all counties\n$counties = $uganda-\u003ecounties();\n\n# Retrieve specific county\n$county = $uganda-\u003ecounty('Adjumani West County');\n\n# Retrieve all sub counties in a particular county\n$subCounties = $uganda\n    -\u003ecounty('Adjumani West County')\n    -\u003esubCounties();\n\n# Retrieve all parishes in a particular county\n$parishes = $uganda\n    -\u003ecounty('Adjumani West County')\n    -\u003eparishes();\n\n# Retrieve all villages in a particular county\n$villages = $uganda\n    -\u003ecounty('Adjumani West County')\n    -\u003evillages();\n```\n\n### Retrieve Sub County data.\n\n```php\nuse Uganda\\Uganda;\n\n$uganda = new Uganda();\n\n# Retrieve all sub counties\n$subCounties = $uganda-\u003esubCounties();\n\n# Retrieve specific sub county\n$subCounty = $uganda-\u003esubCounty('Namasale Town Council');\n\n# Retrieve all parishes in a particular sub county\n$parishes = $uganda\n    -\u003ecounty('Namasale Town Council')\n    -\u003eparishes();\n\n# Retrieve all villages in a particular sub county\n$villages = $uganda\n    -\u003ecounty('Namasale Town Council')\n    -\u003evillages();\n```\n\n### Retrieve Parish data.\n\n```php\nuse Uganda\\Uganda;\n\n$uganda = new Uganda();\n\n# Retrieve all parishes\n$parishes = $uganda-\u003eparishes();\n\n# Retrieve specific parish\n$parish = $uganda-\u003eparish('Bunamwamba');\n\n# Retrieve all villages in a particular parish\n$villages = $uganda\n    -\u003ecounty('Bunamwamba')\n    -\u003evillages();\n```\n\n### Retrieve Village data.\n\n```php\nuse Uganda\\Uganda;\n\n$uganda = new Uganda();\n\n# Retrieve all villages\n$villages = $uganda-\u003evillages();\n\n# Retrieve specific village\n$subCounty = $uganda-\u003evillage('Ayeye');\n```\n\n## Credits\n\nThe data used in this package has been scrapped off This data has been scrapped off [Uganda's passport's official portal](https://passports.go.ug) as there is no updated geo data source since 2018 published anywhere.\n\n## Collaborators ✨\n\n\u003c!-- readme: collaborators -start --\u003e\n\u003ctable\u003e\n\u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/timek\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/2828143?v=4\" width=\"100;\" alt=\"timek\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eTim3k\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/kusaasira\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/10392992?v=4\" width=\"100;\" alt=\"kusaasira\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eJoshua Kusaasira\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/Marshud\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/63245157?v=4\" width=\"100;\" alt=\"Marshud\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eMarshud\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\u003c/tr\u003e\n\u003c/table\u003e\n\u003c!-- readme: collaborators -end --\u003e\n\n## Contributors ✨\n\n\u003c!-- readme: contributors -start --\u003e\n\u003ctable\u003e\n\u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/kusaasira\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/10392992?v=4\" width=\"100;\" alt=\"kusaasira\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eJoshua Kusaasira\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/RoadSigns\"\u003e\n            \u003cimg src=\"https://avatars.githubusercontent.com/u/5822139?v=4\" width=\"100;\" alt=\"RoadSigns\"/\u003e\n            \u003cbr /\u003e\n            \u003csub\u003e\u003cb\u003eZack\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\u003c/tr\u003e\n\u003c/table\u003e\n\u003c!-- readme: contributors -end --\u003e\n\n## License\n\nThis package is free software distributed under the terms of the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkusaasira%2Fuganda-geo-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkusaasira%2Fuganda-geo-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkusaasira%2Fuganda-geo-data/lists"}