Docs
  • Solver
  • Models
    • Field Service Routing
    • Employee Shift Scheduling
  • Platform
Try models
  • Field Service Routing
  • Introduction

Field Service Routing

    • Introduction
    • Planning AI concepts
    • Metrics and optimization goals
    • Getting started with field service routing
    • Understanding the API
    • User guide
      • Constraints
      • Time zones and daylight-saving time (DST)
      • Routing with Timefold’s maps service
    • Vehicle resource constraints
      • Shift hours and overtime
      • Lunch breaks and personal appointments
      • Fairness
      • Route optimization
      • Technician costs
      • Technician ratings
    • Visit service constraints
      • Time windows and opening hours
      • Skills
      • Visit dependencies
      • Visit requirements
      • Multi-vehicle visits
      • Movable visits and multi-day schedules
      • Priority visits and optional visits
      • Visit service level agreement (SLA)
    • Recommendations
      • Recommendations
      • Visit time window recommendations
      • Visit group time window recommendations
    • Real-time planning
      • Real-time planning
      • Real-time planning: extended visit
      • Real-time planning: reassignment
      • Real-time planning: emergency visit
      • Real-time planning: no show
      • Real-time planning: technician ill
      • Real-time planning: pinning visits
    • Scenarios
      • Long-running visits
    • Changelog
    • Upgrade to the latest version
    • Feature requests
    • Reference guide

Introduction

The Field Service Routing model is one of Timefold’s Planning AI models and is available on the Timefold Platform.

The Field Service Routing model assigns customer visits to technicians with the goal of increasing the number of scheduled visits technicians can make by minimizing the amount of time they spend traveling and waiting between visits.

Field Service Routing model is built using the Timefold Solver SDK and the application includes Timefold Enterprise Solver, a scalable optimization engine that can solve complex constraint satisfaction problems.

The Field Service Routing model includes constraints for:

  1. Scheduling customer visits when customers have agreed to be available.

  2. Assigning technicians with the right skills for the visit.

  3. Coordinating visits that require multiple technicians.

  4. Prioritizing visits and meeting visit requirements.

  5. Fairly assigning work to technicians and respecting their work hours.

For details about these and other constraints, see the vehicle resource constraints and visit service constraints guides.

Constraints have configurable weights, making them adjustable to meet different business goals and priorities.

The integrated maps service provides real-world routing and optimizing for the shortest travel time or travel distance.

Field Service Routing map view

The real time planning API makes plans adaptable when unforeseen events inevitably occur, and the recommendations API can help you figure out which technicians to assign to which customer visits.

The REST API layer is defined on top of the model and serves as a communication point with the engine to provide a stable interface that allows you to manage the lifecycle of the optimization problem, from submitting the initial dataset to retrieving the final solution.

Next

  • See the full API spec or try the online API.

  • Learn more about field service routing from our YouTube playlist.

  • Follow the Getting started guide.

  • © 2025 Timefold BV
  • Timefold.ai
  • Documentation
  • Changelog
  • Send feedback
  • Privacy
  • Legal
    • Light mode
    • Dark mode
    • System default