This first stable release of GeoLocateAPI includes:
Core Features
- IP → Location lookup
- Coordinates → Reverse geocoding
- City → Coordinates search
- Unified GeoLocationData response model
Architecture
- Clean Architecture (domain/application/infrastructure/presentation)
- Hexagonal structure with provider-specific adapters
- Stateless by design (no database, no cache, no external costs)
Testing & Quality
- WireMock integration tests for external providers
- MockMvc controller tests
- Domain/service unit tests
- Global exception handling with structured error responses
Documentation
- Swagger/OpenAPI auto-generated documentation
- Architecture diagram (PlantUML + SVG)
- Full README with examples and endpoints
License
- MIT License