github.com/ktamas77/geocode ↗

About ktamas77/geocode

This is a geocoding service written in Python that converts location names into geographic coordinates. It provides a simple REST API with a single endpoint that accepts a search query and returns latitude and longitude information for the requested location.

The service is built with a plugin architecture, allowing it to integrate with multiple geocoding providers dynamically. Users configure their desired services and API keys in a YAML configuration file, and the service attempts to resolve locations by querying providers in the order specified. Each provider is implemented as a Python plugin that returns coordinate data or signals failure if unable to process the request.

The application runs in Docker and includes a Swagger UI interface for testing and documentation, accessible on port 8080, while the main API listens on port 80. This makes it easy to deploy and experiment with different geocoding backends without modifying the core service code.