{"id":21423161,"url":"https://github.com/jerry-felipe/real-time-geolocation-api","last_synced_at":"2025-04-19T14:34:47.323Z","repository":{"id":263474259,"uuid":"890483807","full_name":"jerry-felipe/Real-Time-Geolocation-API","owner":"jerry-felipe","description":"A backend system for tracking and managing location data in real time. It supports live updates for deliveries or users, integrates with tools like Google Maps API, and optimizes geospatial queries using PostGIS. With caching via Redis and a scalable architecture, it ensures low-latency performance for location-based services.","archived":false,"fork":false,"pushed_at":"2024-12-19T14:58:42.000Z","size":17,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T08:43:34.733Z","etag":null,"topics":["ci-cd","docker","java","jwt","logging","microservices","resilience4j","scalability","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jerry-felipe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-18T16:39:40.000Z","updated_at":"2025-01-05T13:49:08.000Z","dependencies_parsed_at":"2024-11-18T19:18:47.914Z","dependency_job_id":"bf05e46b-3435-4b33-bee1-f657b13f0bdb","html_url":"https://github.com/jerry-felipe/Real-Time-Geolocation-API","commit_stats":null,"previous_names":["jerry-felipe/real-time-geolocation-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry-felipe%2FReal-Time-Geolocation-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry-felipe%2FReal-Time-Geolocation-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry-felipe%2FReal-Time-Geolocation-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry-felipe%2FReal-Time-Geolocation-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jerry-felipe","download_url":"https://codeload.github.com/jerry-felipe/Real-Time-Geolocation-API/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249715499,"owners_count":21315055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["ci-cd","docker","java","jwt","logging","microservices","resilience4j","scalability","spring-boot"],"created_at":"2024-11-22T21:14:36.586Z","updated_at":"2025-04-19T14:34:47.273Z","avatar_url":"https://github.com/jerry-felipe.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Real-Time-Geolocation-API\nA backend system for tracking and managing location data in real time. It supports live updates for deliveries or users, integrates with Google Maps API, and optimizes geospatial queries using Oracle Spatial and Graph. With caching via Redis and a scalable architecture, it ensures low-latency performance for location-based services.\n\n# Features  \n- Real-Time Updates: Track users or assets with low latency.  \n- Geospatial Optimization: Efficient queries using PostGIS or similar tools.  \n- Google Maps Integration: Enable routing, distance calculation, and mapping.  \n- Caching: Accelerate performance with Redis.  \n- Scalability: Handle high traffic with a resilient architecture.  \n\n# Technologies Used  \n- Backend Framework: Node.js and Spring Boot.  \n- Database: OracleDB for geospatial data.  \n- Caching: Redis for optimized query performance.  \n- Geolocation API: Google Maps API.  \n- Containerization: Docker for easy deployment and scaling.  \n\n# Installation  \n1. Clone the repository:  \n   '''bash\n   git clone https://github.com/jerry-felipe/realtime-geolocation-api.git\n   cd realtime-geolocation-api\n   '''  \n2. Set up the environment:  \n   - Create a '.env' file with the following variables:  \n     '''env\n     DATABASE_URL=oracle+cx_oracle://username:password@localhost:1521/xe\n     REDIS_URL=redis://localhost:6379\n     GOOGLE_MAPS_API_KEY=your_api_key\n     '''  \n3. Run the Docker containers:  \n   '''bash\n   docker-compose up --build\n   '''  \n\n# Usage  \n- Start the API server:  \n  '''bash\n  uvicorn app.main:app --reload\n  '''  \n- Access API documentation at:  \n  '''\n  http://localhost:8000/docs\n  '''  \n\n# Endpoints  \n| Endpoint               | Method | Description                            |  \n|------------------------|--------|----------------------------------------|  \n| '/locations/update'    | POST   | Update location data in real time.    |  \n| '/locations/track/{id}'| GET    | Track a specific user or asset.       |  \n| '/locations/routes'    | GET    | Calculate optimal routes.             |  \n\n# Contributing  \nContributions are welcome! Please fork the repository and submit a pull request with detailed notes.  \n\n# License  \nThis project is licensed under the MIT License.  \n\n---  \nFor more information, contact jerry.felipe@gmail.com.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerry-felipe%2Freal-time-geolocation-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjerry-felipe%2Freal-time-geolocation-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerry-felipe%2Freal-time-geolocation-api/lists"}