How stanislavorlov/geo-maps works
geo-maps serves map pages, geocoding, and road routing over an OpenStreetMap-derived graph. The main route workflow accepts coordinates and travel preferences, loads a nearby mode-filtered road graph, snaps endpoints to nodes, selects a routing algorithm, and returns route metrics; its WebSocket variant also streams progress. The map interface, parser/import path, and database-backed location search are separate meaningful capabilities. Edges reflect explicit excerpts, the source index, or README; unshown wiring is omitted.
Main entry points: directions.py Directions API · graph.py Road graph · astar_routing.py A-star routing · main.py FastAPI app
Components 26
User interface
- Map page
app/templates/index.html - Map client
app/templates/js/main.js
API and search
- FastAPI app
app/main.py - Page routes
app/api/pages.py - Directions API
app/api/directions.py - Geocoding API
app/api/geocoding.py - Search requests
app/models/search_model.py - Geocode service
app/services/geocode_service.py
Routing
- Graph factory
app/graph/graph_factory.py - Road graph
app/graph/graph.py - Spatial indexes
app/graph/kd_tree.py - Algorithm selector
app/routing_algorithms/routing_factory.py - Routing contract
app/routing_algorithms/abstract_routing.py - A-star routing
app/routing_algorithms/astar_routing.py - Dijkstra routing
app/routing_algorithms/dijkstra_routing.py - Bidirectional routing
app/routing_algorithms/bidirectional_dijkstra_routing.py - Mode access rules
app/services/speed_limit_service.py - Travel-time calculator
app/services/travel_time_service.py - Route progress
app/models/notification_model.py
Road data
- Location lookup
app/database/location_repository.py - DB dependencies
app/api/dependencies.py - Database session
app/database/database.py - Road entities
app/database/models.py - Route graph query
app/database/graph_repository.py - OSM parser
data/parser/osm_parser.py
Other components
- Map user
Connections 40
- Map user → Map client: uses
app/templates/js/main.js - Map client → FastAPI app: requests pages
- FastAPI app → Page routes: routes pages
app/main.py - FastAPI app → Directions API: registers routes
app/main.py - FastAPI app → Geocoding API: registers routes
app/main.py - FastAPI app → Database session: initializes
app/main.py - Map user → Directions API: requests route
app/api/directions.py - Directions API → Search requests: validates request
app/api/directions.py - Directions API → Route graph query: loads graph
app/api/directions.py - Directions API → Algorithm selector: selects algorithm
app/api/directions.py - Directions API → Road graph: snaps endpoints
app/api/directions.py - Directions API → Map client: streams progress
- Geocoding API → Search requests: uses requests
app/api/geocoding.py - Geocoding API → Location lookup: looks up locations
app/api/geocoding.py - Geocoding API → Geocode service: geocodes
app/api/geocoding.py - DB dependencies → Database session: opens sessions
app/api/dependencies.py - DB dependencies → Route graph query: provides repository
app/api/dependencies.py - DB dependencies → Location lookup: provides repository
app/api/dependencies.py - Location lookup → Road entities: queries
app/database/location_repository.py - Route graph query → Road entities: queries roads
app/database/graph_repository.py - Route graph query → Mode access rules: filters road types
app/database/graph_repository.py - Route graph query → Graph factory: builds graph
app/database/graph_repository.py - Graph factory → Road graph: creates
app/graph/graph_factory.py - Road graph → Spatial indexes: indexes nodes
- Algorithm selector → A-star routing: selects
app/routing_algorithms/routing_factory.py - Algorithm selector → Dijkstra routing: selects
app/routing_algorithms/routing_factory.py - Algorithm selector → Bidirectional routing: selects
app/routing_algorithms/routing_factory.py - A-star routing → Routing contract: implements
app/routing_algorithms/astar_routing.py - Dijkstra routing → Routing contract: implements
app/routing_algorithms/dijkstra_routing.py - Bidirectional routing → Routing contract: implements
app/routing_algorithms/bidirectional_dijkstra_routing.py - A-star routing → Road graph: traverses
app/routing_algorithms/astar_routing.py - Dijkstra routing → Road graph: traverses
app/routing_algorithms/dijkstra_routing.py - Bidirectional routing → Road graph: traverses
app/routing_algorithms/bidirectional_dijkstra_routing.py - A-star routing → Mode access rules: checks access
app/routing_algorithms/astar_routing.py - Bidirectional routing → Mode access rules: checks access
app/routing_algorithms/bidirectional_dijkstra_routing.py - A-star routing → Travel-time calculator: calculates time
app/routing_algorithms/astar_routing.py - A-star routing → Route progress: emits progress
app/routing_algorithms/astar_routing.py - Bidirectional routing → Route progress: emits progress
app/routing_algorithms/bidirectional_dijkstra_routing.py - OSM parser → Road graph: builds map graph
data/parser/osm_parser.py - OSM parser → Road entities: uses entities
data/parser/osm_parser.py