Viindoo Unified Routing Framework
| Lines of Code | 3328 |
| Technical name | to_geo_routes |
| License | OPL-1 |
| Website | https://viindoo.com/apps/app/17.0/to_geo_routes |
| Read description for | v 10.0 v 11.0 v 12.0 v 13.0 v 14.0 v 15.0 v 16.0 |
| Required Apps | Discuss (mail) |
| Included Dependencies | Viindoo Base API Request Logger |
| Extensions | Google Routes API Integration HERE Routing API Integration Vietmap Matrix & Routing API Integration Mapbox Matrix API Integration SeaRoutes Ocean Routing Integration Geo Route Map |
What it does
Viindoo Unified Routing Framework (to_geo_routes) provides a unified routing framework for Odoo/Viindoo, allowing the system to request directions, distance, duration, polyline geometry, and multi-leg routes from different providers through a single standardized API.
The module acts as the core abstraction layer for all mapping/routing integrations (Google, Mapbox, HERE, SeaRoutes, Vietmap, etc.) and enables any business module (Fleet, Logistics, Delivery, VRP, Booking, Field Services) to compute routes in a provider-independent, reliable, and extensible way.
Key Features
- Unified Routing API
- Standardized output for distance, duration, polylines, steps, and legs.
- Abstract models for routes, sections, points, and transport modes.
- Clean isolation between business modules and external providers.
- Multi-provider Architecture
- Plugin architecture for adding routing providers.
- Automatic fallback and provider selection logic.
- Support for different modes: driving, trucking, walking, cycling.
- Foundation for Fleet & Logistics Optimization
- Provides normalized route data for VRP optimizers.
- Supports trip planning, booking allocation, dispatching, and transport cycles.
- Works seamlessly with routing provider modules such as: - to_geo_routes_google - to_geo_routes_mapbox - to_geo_routes_here - to_geo_routes_searoutes - to_geo_routes_vietmap
- Designed for Large-scale Operations
- Efficient caching and low-latency lookup.
- Provider switching by country, use-case, or cost strategy.
- Fully extensible for enterprise-grade logistics applications.
Note
This is a core module for complex routing requirements. Detailed functionalities like delivery, passenger, or employee travel management require additional modules to leverage the full potential of this foundation.
Technical Requirements
This module requires Google's ortools library version 9.11.4210 and polyline version 2.0.3. You could install it with pip
pip install ortools==9.11.4210 pip install polyline==2.0.3
Editions Supported
- Community Edition
- Enterprise Edition
Installation
- Navigate to Apps.
- Find with keyword to_geo_routes.
- Install it as usual then you are done.
Concepts
- Route Section: is a section defined by two addresses where each Address (aka From and To) is a partner record. This design model to ensure short learning curve and easy to extend and fully integrated with existing features in the system.
- Waypoint: also known as Route Waypoint, is a model that presents an instance of an Address which creates a data link between a Route and an Address in the system.
- Segment: also known as Route Section, is a model that presents an instance of a Section which creates a data link between a Route and an Route Section in the system.
- Route: is a model to present a route that defined by Waypoints and Sections. Then the system will automatically find and link the related Sections and Addresses for the Route.
Instructions
- Without other modules that extending this module, you are required to be a system administrator to access the module's menu: Settings > Geo-Routes. If you have other modules that developed on top of this, there should be other ways to access the features. For example, if you have the module to_fleet_operation_planning installed, you may access the features through Fleet Operation > Routes & Waypoints which does not required administrator access rights. In this document, it is assumed that you have administration access rights.
- Define a new Route:
- Navigate to Settings > Geo-Routes > Routes to see the routes list view.
- Press Create to open the route form view, on which you can input:
- The name of the route. For example: Hanoi to Ha Long Bay via Hai Phong City.
- In the Waypoint tab, press Add a line to add waypoints for your route.
- In the Segments tab, you can add information about distance and average speed. The estimated time will be automatically computed.
This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file).
You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software.
The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.