Overview

Display travel routes, estimate durations for different transport modes (driving, walking, flight), and visualize them on Google Maps,  all inside your Mendix app.

Documentation

Typical usage scenario

The RouteIQ widget is designed for Mendix developers building applications that require route optimization, distance calculation, and travel-time estimation.

Typical Usage Scenario

The RouteIQ widget is designed for Mendix developers building applications that require route optimization, distance calculation, and travel-time estimation.

Common Use Cases:

• Logistics & Delivery Management: Plan and display optimized routes with multiple delivery points.

• Field Service Applications: Help agents visualize efficient travel paths between appointments.

• Fleet Management: Show real-time route updates for vehicles and delivery personnel.

• Travel & Navigation Apps: Enhance user experience with accurate routing and estimated arrival times.

Value Proposition:

RouteIQ simplifies complex routing logic, saving development time and improving application accuracy in travel-intensive scenarios.

✨ Features and Limitations

✅ Features:

• Display routes between multiple points on an interactive map

• Real-time distance and travel-time calculation using third-party APIs (e.g., Google Maps)

• Customizable start and end points through Mendix expressions

• Dynamic waypoint support

• Map styling and responsive layout support

• Error handling for missing/invalid input

⚠ Limitations:

• Requires external API (Google Maps or similar) for routing and mapping services

• API usage may incur costs depending on volume and provider

• Only supports web-based Mendix applications (not native mobile)

• Currently supports driving mode; cycling/walking/public transport coming in future updates

🔗 Dependencies [Optional]

To use RouteIQ, you will need:

• A valid API key from a supported map provider (e.g., Google Maps Platform or HERE Maps)

• Internet access to retrieve routing and map data

• Mendix version 10.0.0 or higher

⚙️ Installation [Optional]

1. Download the RouteIQ widget from the Mendix Marketplace

2. Import it into your Mendix Studio Pro project

3. Place the widget in your desired page or layout

4. Commit and run the application locally or in the cloud

🔧 Configuration [Optional]

1. API Key Setup:

   • Go to your map provider’s console (e.g., Google Cloud Platform)

   • Create a project and generate an API key

   • Enable required services like Directions API and Maps JavaScript API

2. Widget Properties:

   • Configure input parameters such as Start Location, End Location, Waypoints

   • Customize visual styling options (height, width, colors)

3. Dynamic Binding:

   • Bind data from your Mendix entities using expressions (e.g., location from a microflow)

🐞 Known Bugs [Optional]

• In rare cases, if invalid coordinates or null values are passed, the widget may not render the map correctly

• UI responsiveness may vary slightly on very low-resolution devices

• No built-in fallback for API quota limits; custom handling recommended