Geosanga is an open source package project to provide Ugandan based geolocation data using endpoints/packages that can be consumed directly within your applications. This is to help you reduce on the time that would be needed to collect and build the functionality within your application.
- The provides a PHP package that you can install directly in your PHP based applications using package managers like composer
- Endpoints are available to consume the data directly through http calls without any installation
- Run
composer install geosangato install the package
| HTTP Verbs | Endpoints | Action |
|---|---|---|
| GET | /v1/districts | To fetch all districts |
| GET | /v1/counties | To fetch all counties |
| GET | /v1/subcounties | To fetch all subcounties |
| GET | /v1/parishes | To fetch all parishes |
| GET | /v1/villages | To fetch all villages |
For further reference, please check out the postman collection
- PHP A popular general-purpose scripting language that is especially suited to web development. Fast, flexible and pragmatic, PHP powers everything from your blog to the most popular websites in the world.
- JSON JSON (JavaScript Object Notation) is a lightweight data-interchange format.
To try out the example
-
Clone the repo
git clone https://github.com/OSCA-Kampala-Chapter/geonsanga -
Navigate to the project directory
cd geosanga -
Install the dependencies
composer install -
Start the local server
php -S localhost:8321 -
Open http://localhost:8321/examples in your prefered browser
- Project Structure - View API Pattern
- Router (Still in the Structure) - Steampixel's Simple Router
- The Ugandan Locale Package - Uganda Geo Data
This project is available for use under the MIT License.