VRP API Changelog

​

🎯 Resource Ranking System

Express nuanced preferences for resource-job assignments with our new flexible ranking system.

{
  "jobs": [{
    "name": "Premium-Service",
    "rankings": [
      {"name": "Senior-Tech-1", "ranking": 10},  // Strongly preferred
      {"name": "Junior-Tech-1", "ranking": 70}   // Acceptable if needed
    ]
  }],
  "weights": {
    "rankingWeight": 10
  }
}

​

📍 Location Inheritance

Simplify multi-stop scenarios where jobs share locations through automatic location inheritance.

{
  "jobs": [
    {
      "name": "pickup",
      "location": {"latitude": 51.1279, "longitude": 17.0485}
    },
    {
      "name": "delivery",
      "location": {"latitude": 51.1279, "longitude": 17.0485}  // Duplicate
    }
  ]
}

Perfect for:

• Pickup and delivery pairs
• Multi-service appointments at same address
• Loading/unloading operations
• Any co-located job sequences

​

🔍 Enhanced Unassigned Job Explanations

Get detailed, actionable insights when jobs cannot be assigned to understand exactly why and how to resolve issues.

Common Unassignment Reasons:

• DATE_TIME_WINDOW_CONFLICT - No overlap between job window and shifts
• CAPACITY_EXCEEDED - Vehicle capacity insufficient
• SKILL_MISMATCH - Required tags not available
• DISTANCE_CONSTRAINT - Location outside service area
• BREAK_CONFLICT - Mandatory breaks prevent service

​

⚖️ Job Complexity & Fair Distribution

Define job difficulty independent of duration to ensure fair workload distribution across your team.

{
  "jobs": [{
    "name": "Technical-Installation",
    "duration": 3600,
    "complexity": 80  // High complexity
  }, {
    "name": "Standard-Delivery",
    "duration": 3600,
    "complexity": 20  // Low complexity
  }],
  "options": {
    "fairness": {
      "complexityFairness": true,
      "targetComplexityPerResource": 200
    },
    "weights": {"complexityWeight": 15}
  }
}

​

🚦 Full TomTom Traffic Integration

Enhanced real-time and predictive traffic routing with complete TomTom API integration.

{
  "options": {
    "routingEngine": "TOMTOM",
    "traffic": 1.2  // Traffic modifier for TOMTOM routing
  }
}

Key Enhancements:

• Live Traffic: Real-time congestion avoidance
• Predictive Routing: Historical patterns for future planning
• Departure Optimization: Find best start times to avoid traffic
• Vehicle-Specific Routes: Truck restrictions and clearances
• 15% Average Time Savings: Compared to static routing

​

💰 Resource Hourly Wage Optimization

Optimize routes considering different hourly rates to balance service quality with labor costs.

{
  "resources": [{
    "name": "Senior-Tech",
    "hourlyCost": 75
  }, {
    "name": "Junior-Tech", 
    "hourlyCost": 45
  }]
}

Optimization Strategies:

• Assign simple tasks to lower-cost resources
• Use senior staff for complex/critical jobs
• Minimize overtime by balancing workloads
• Consider total cost including travel time

​

🚫 Unavailability Breaks

Model realistic schedules with unavailability periods for meetings, training, or personal time.

{
  "resources": [{
    "name": "Tech-1",
    "shifts": [{
      "from": "2025-01-01T08:00:00Z",
      "to": "2025-01-01T17:00:00Z",
      "breaks": [{
        "type": "UNAVAILABILITY",
        "from": "2025-01-01T10:00:00Z",
        "to": "2025-01-01T11:30:00Z",
        "location": {"latitude": 51.1079, "longitude": 17.0385}
      }, {
        "type": "WINDOWED",
        "from": "2025-01-01T12:00:00Z",
        "to": "2025-01-01T13:00:00Z", 
        "duration": 3600
      }]
    }]
  }]
}

Supported Break Types:

• UNAVAILABILITY - Cannot be scheduled during this period
• WINDOWED - Flexible timing within window
• DRIVE - Mandatory after specified driving time

​

🥇 First Job Relation

Force specific jobs to be scheduled first in a resource’s route with the new FIRST_JOB relation type.

{
  "jobs": [{
    "name": "warehouse-pickup"
  }],
  "relations": [{
    "type": "SEQUENCE",
    "jobs": ["warehouse-pickup"]
  }]
}

Common Use Cases:

• Warehouse pickups before deliveries
• Equipment collection at start of day
• Mandatory briefings or check-ins
• Load vehicles before service rounds

​

🔤 Group Sequence Relations

Define execution order between groups of jobs using tags with the GROUP_SEQUENCE relation.

{
  "jobs": [
    {"name": "urgent-1", "tags": [{"name": "priority-high"}]},
    {"name": "urgent-2", "tags": [{"name": "priority-high"}]},
    {"name": "normal-1", "tags": [{"name": "priority-normal"}]},
    {"name": "low-1", "tags": [{"name": "priority-low"}]}
  ],
  "relations": [{
    "type": "GROUP_SEQUENCE",
    "tags": ["priority-high", "priority-normal", "priority-low"]
  }]
}

Benefits:

• Implement service level agreements
• Handle emergency vs routine work
• Manage phased operations
• Prioritize revenue-generating activities

​

🚀 Large-Scale TSP Optimizations

Significant performance improvements for Traveling Salesman Problem instances with 100+ stops.

{
  "options": {
    "partialPlanning": true,
    "minimizeResources": true
  }
}

​

📈 Enterprise-Scale Problem Handling

Revolutionary improvements for handling massive routing problems with 10,000+ jobs.

Real-World Results:

• Before: 5,000 job limit, 45-minute processing
• After: 50,000 jobs supported, 15-minute average
• Quality: Maintained 98%+ optimality
• Stability: 99.9% completion rate

​

🗺️ TomTom Traffic Integration

Time-dependent routing with real-world traffic conditions for accurate ETAs and optimal departure times.

Configuration Example:

{
  "options": {
    "routingEngine": "TOMTOM",
    "traffic": 1.1  // Traffic multiplier
  }
}

​

📅 Multi-Day Job Support

Execute long-duration jobs across multiple shifts and days with intelligent work continuation.

{
  "jobs": [{
    "name": "major-project",
    "duration": 72000,  // 20 hours total
    "resumable": true,
    "windows": [
      {"from": "2024-07-01T08:00:00Z", "to": "2024-07-01T17:00:00Z"},
      {"from": "2024-07-02T08:00:00Z", "to": "2024-07-02T17:00:00Z"},
      {"from": "2024-07-03T08:00:00Z", "to": "2024-07-03T17:00:00Z"}
    ]
  }],
  "resources": [{
    "name": "tech-1",
    "shifts": [
      {"from": "2024-07-01T08:00:00Z", "to": "2024-07-01T17:00:00Z"},
      {"from": "2024-07-02T08:00:00Z", "to": "2024-07-02T17:00:00Z"},
      {"from": "2024-07-03T08:00:00Z", "to": "2024-07-03T17:00:00Z"}
    ]
  }]
}

​

⚡ Synchronous API Endpoints

New /sync/* endpoints for immediate responses perfect for interactive applications.

// Synchronous call for immediate response
const response = await fetch('/v2/vrp/sync/solve', {
  method: 'POST',
  body: JSON.stringify({
    jobs: [...],  // Limited to 50 jobs
    resources: [...],
    options: { timeout: 2000 }
  })
});

const solution = await response.json();
// Solution returned directly, no polling needed

​

🎉 VRP API v2 Release

After 2 years of development, v2 brings a complete architectural redesign focused on scalability, reliability, and performance.

​

Architecture Evolution

​

Migration Guide