Routing with Timefold’s maps service
This model involves routing. To support real-world routing and optimizing for the shortest travel time or travel distance, the Timefold Platform includes a maps service.
| This model uses the maps service under the hood. Learn more about the maps service and the additional features it provides. |
Available maps
In the Timefold Cloud Platform UI, you can create a configuration profile and choose a maps provider (e.g. OSRM) to see a full list of available maps.
| Not all map locations are loaded by default. If you want to use a map that is currently not available, you can contact us. |
Automatic map selection
Choose "Auto-select" as "Maps location" and the maps service automatically selects the most suitable vehicle map based on the coordinates provided in the dataset input.
All coordinates (for example, vehicle start locations and visit locations) are evaluated and matched against the available map regions (see below). From the regions that fully cover all coordinates, the service selects the smallest possible map.
The selected map is determined once per problem and remains fixed for the entire optimization run.
Automatic map selection provides the following advantages:
-
Reduced configuration overhead: You no longer need to create and maintain multiple configuration profiles for different geographic regions.
-
Improved performance: Smaller maps lead to faster distance matrix calculations and typically shorter solver runtimes.
-
Safer defaults: The maps service always selects the most appropriate map based on the provided coordinates.
| We strongly recommend using automatic map selection as the default setting. |
If no map is found that fully covers all provided locations, the maps service falls back to selecting the map that covers the highest number of locations. The request only fails if none of the available maps cover any of the provided coordinates, in which case the service responds with a clear error message.
Vehicle maps
The available maps for typical vehicle traffic include (but are not limited to):
| Map | Description |
|---|---|
Australia |
This is the OSRM map for the country of Australia. |
Belgium |
This is the OSRM map for the country of Belgium. |
Benelux-Germany |
This is the OSRM map for the Benelux region and Germany, covering the countries of Belgium, the Netherlands, Luxembourg and Germany. |
Canada |
This is the OSRM map for the country of Canada. |
Dach |
This is the OSRM map for the DACH region, covering the countries of Germany, Austria and Switzerland. |
Mexico |
This is the OSRM map for the country of Mexico. |
Netherlands |
This is the OSRM map for the country of Netherlands. |
Ontario |
This is the OSRM map for the region of Ontario in Canada. |
Sweden |
This is the OSRM map for the country of Sweden. |
UK |
This is the OSRM map for the country of the United Kingdom. |
US |
This is the OSRM map for the United States. |
US Georgia |
This is the OSRM map for the state of Georgia in the United States. |
US Midwest |
This is the OSRM map for the Midwest region of the United States, covering the states Illinois, Indiana, Iowa ,Kansas, Michigan, Minnesota, Missouri, Nebraska, North Dakota, Ohio, South Dakota, and Wisconsin. |
US Northeast |
This is the OSRM map for the North-east region of the United States, covering the states Connecticut, Maine, Massachusetts, New Hampshire, New Jersey, New York, Pennsylvania, Rhode Island, and Vermont. |
US Pacific |
This is the OSRM map for the Pacific region of the United States, covering the states Hawaii and Alaska. |
US South |
This is the OSRM map for the Southern region of the United States, covering the states Alabama, Arkansas, Delaware, Florida, Georgia, Kentucky, Louisiana, Maryland, Mississippi, North Carolina, Oklahoma, South Carolina, Tennessee, Texas, Virginia, Washington DC, and West Virginia. |
US West |
This is the OSRM map for the Western region of the United States, covering the states Arizona, California, Colorado, Idaho, Montana, Nevada, New Mexico, Oregon, Utah, Washington, and Wyoming. |