Skip to content

A microservice to provide Ugandan based geolocation data

License

Notifications You must be signed in to change notification settings

OSCA-Kampala-Chapter/geonsanga

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Geosanga

Introduction

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.

Geosanga Features

  • 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

Installation Guide

  • Run composer install geosanga to install the package

API Endpoints

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

Technologies Used

  • 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.

Examples

To try out the example

  1. Clone the repo

    git clone https://github.com/OSCA-Kampala-Chapter/geonsanga

  2. Navigate to the project directory

    cd geosanga

  3. Install the dependencies

    composer install

  4. Start the local server php -S localhost:8321

  5. Open http://localhost:8321/examples in your prefered browser

alt text

Contribution Guide

Authors

Reference Docs

  1. Project Structure - View API Pattern
  2. Router (Still in the Structure) - Steampixel's Simple Router
  3. The Ugandan Locale Package - Uganda Geo Data

License

This project is available for use under the MIT License.

About

A microservice to provide Ugandan based geolocation data

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published