Sometimes, you may need to limit a location's throughput so that multiple vehicles don't arrive at the same time for loading or unloading. For example, if your client has goods delivered from multiple depots and they have to use the pickup & delivery method.

To set the throughput, use the points_throughputs option.

For each pickup or delivery location where you need to limit the throughput, specify:

  • The location's and point.lon coordinates.

  • The value of one parameter that determines the limit type and size:

    • throughput.kg_per_hour: Location throughput capacity in kg/hour.

    • throughput.units_per_hour: Location throughput capacity in cargo units/hour (pallets, boxes, kegs).

    • throughput.vehicle_count: Location throughput capacity in vehicles/hour.


    You can set only one limit for each location.

  • If the location's throughput capacity is violated, the following data is used to calculate the penalty:

    • penalty.throughput.fixed: For exceeding the throughput capacity.

    • For violating a limit:

      • For each kg over throughput.kg_per_hour.

      • penalty.throughput.unit: For each cargo unit over throughput.units_per_hour.

      • penalty.throughput.vehicle: For violating the number of vehicles during loading or unloading in throughput.vehicle_count.


You can set the depot throughput capacity using the depot.throughput parameter.

Example 1

Two vehicles deliver several orders from different locations to one client. Both vehicles are scheduled to unload at about the same time.

API request (JSON) API response View on map

Example 2

The same as example 1, but with a throughput limit of one vehicle per hour at the client's address. This led to orders being reassigned and a slight increase in the total mileage. The unloading time windows don't overlap.

API request (JSON) API response View on map

Contact support