NDD LocationLocation

Overview

Locations represent the physical positions at which tasks are performed. Each location has a unique identifier, a geocode for positioning on the road network, and optional attributes that define dimensional properties such as service times or arrival/departure windows at the location level.

Applicable models

• NDD ndd-cmibu6krtqja

Location

Schema definition

message Location {
  required string id = 1;
  optional Geocode geocode = 2;
  repeated Attribute attributes = 3;
}

Fields

id

A unique identifier for this location.

geocode

The geographic coordinates of this location, specified as a geocode. The geocode is used to position the location on the road network for distance and time matrix generation.

attributes

A list of location attributes which define dimensional properties at this location, such as service times or time windows.

Examples

A location with a geocode and a time window:

id: "depot-01"
geocode {
  longitude: -6.2603
  latitude: 53.3498
}
attributes {
  dimensionId: "time"
  arrivalWindows {
    start: 480
    end: 1020
  }
}

Location Attribute

A location attribute defines dimensional properties at a specific location, optionally scoped to a particular vehicle.

Schema definition

message Attribute {
  required string dimensionId = 1;
  optional string vehicleId = 2;
  optional float quantity = 3;
  repeated Window arrivalWindows = 4;
  repeated Window departureWindows = 5;
}

Fields

dimensionId

The dimension to which this attribute applies.

vehicleId

An optional vehicle identifier. When specified, this attribute only applies when the nominated vehicle visits this location. When omitted, the attribute applies to all vehicles.

quantity

A quantity on the specified dimension that is incurred when visiting this location. In the context of time, this represents service time. In the context of capacity, this represents pickup or delivery quantity.

arrivalWindows

A list of windows defining feasible arrival intervals at this location on the specified dimension.

departureWindows

A list of windows defining feasible departure intervals from this location on the specified dimension.

Examples

A location attribute defining a 15-minute service time and a morning arrival window:

dimensionId: "time"
quantity: 15
arrivalWindows {
  start: 480
  end: 720
}

A vehicle-specific location attribute with a capacity quantity:

dimensionId: "weight"
vehicleId: "truck-01"
quantity: 50

Notes

• Location attributes and task attributes both contribute to the dimensional evaluation. When both are present for the same dimension, they are combined.
• Arrival and departure windows at a location are evaluated independently of task-level windows.