PTV Truck Attributes

PTV provides truck attributes for most maps. The truck attributes are a subset of the segment attributes.
Following, those relevant for the RoadEditor / Truck attributes use case are described in the following sections.

Segment attributes overview

The following tables list all segment attributes and their usage in the request. See RoutingParameter ROADEDITOR_ADDITIONAL_OPTIONS for more information on the syntax. Please note that all segment attributes can also be configured by an XML profile which is referenced in the request. Such profiles adhere the structure of the xRoute XML Profile. You can find corresponding (partial) XML profiles below.

Segment attributes with a boolean parameter

The following segment attributes have a boolean parameter, that means they will be considered during route calculation if switched on. In order to override a profile or default setting, they can obtain the value false. They are divided into parameters which override a flag within the map data and those with (first and second table) and without (third table) a default meaning.

Parameters which override a flag within the map data (switched on by default)

These parameters correspond to profile attributes of the element SegmentSpecific within AdditionalDataRules:

  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <Profile>
      <Routing majorVersion="2" minorVersion="0">
          <Course>
              <AdditionalDataRules enabled="true" layerName="TruckAttributes">
                  <SegmentSpecific useSegmentLength="true" useFerryLength="true"
                         useFerryDuration="true" useUrbanAttribute="true"
                         useRampAttribute="true" useSpeed="true"
                         useBlockedForCarsAttribute="true" useBlockedForTrucksAttribute="true"
                         useTollForCarsAttribute="true" useTollForTrucksAttribute="true"/>
              </AdditionalDataRules>
          </Course>
    </Routing>
  </Profile>

Parameters with a default meaning

These parameters correspond to the profile elements VehicleSpecific and Legacy within AdditionalDataRules:

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Profile>
                <Routing majorVersion="2" minorVersion="0">
                    <Course>
                        <AdditionalDataRules enabled="true" layerName="TruckAttributes">
                            <Legacy>
                                <KeyValue key="HazardousToWaters" enabled="true"/>
                                <KeyValue key="HazardousGoods" enabled="true"/>
                                <KeyValue key="Combustibles" enabled="true"/>
                                <KeyValue key="HeavyLoad" enabled="true"/>
                                <KeyValue key="Vignette" enabled="true"/>
                            </Legacy>
                        </AdditionalDataRules>
                    </Course>
                </Routing>
            </Profile>
        

Parameters without a default meaning, i.e. the meaning will be defined by the data producer.

These parameters correspond to the profile element Legacy within AdditionalDataRules:

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Profile>
                <Routing majorVersion="2" minorVersion="0">
                    <Course>
                        <AdditionalDataRules enabled="true" layerName="TruckAttributes">
                            <Legacy>
                                <KeyValue key="OptBlocks1" enabled="true"/>
                                <KeyValue key="OptBlocks2" enabled="true"/>
                                <KeyValue key="OptBlocks3" enabled="true"/>
                                <KeyValue key="OptBlocks4" enabled="true"/>
                                <KeyValue key="OptBlocks5" enabled="true"/>
                                <KeyValue key="OptBlocks6" enabled="true"/>
                                <KeyValue key="OptBlocks7" enabled="true"/>
                                <KeyValue key="OptBlocks8" enabled="true"/>
                                <KeyValue key="OptBlocks9" enabled="true"/>
                                <KeyValue key="OptBlocks10" enabled="true"/>
                            </Legacy>
                        </AdditionalDataRules>
                    </Course>
                </Routing>
            </Profile>
        

Segment attributes with a malus parameter

The following segment attributes have a parameter which represents a malus, i.e. if present in ROADEDITOR_ADDITIONAL_OPTIONS all segments carrying the attribute in question will take the given malus. Each malus value must be in the range from -99 to 2501 (see RoutingParameter for more information on malus values). The attributes are divided into parameters with (first table) and without (second table) a default meaning.

It is recommended to use the following malus values:

• -99 for preferred routes (e.g. scenic routes)
• 2500 for routes to avoid except for start or destination (e.g. delivery traffic)
• 2501 for routes to be blocked (e.g. route segments blocked by law)

Parameters with a default meaning

These parameters correspond to the profile elements VehicleSpecific and Legacy within AdditionalDataRules:

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Profile>
                <Routing majorVersion="2" minorVersion="0">
                    <Course>
                        <AdditionalDataRules enabled="true" layerName="TruckAttributes">
                            <Legacy>
                                <KeyValue key="ScenicRouteType1" enabled="true" malus="-99"/>
                                <KeyValue key="ScenicRouteType2" enabled="true" malus="-99"/>
                                <KeyValue key="ScenicRouteType3" enabled="true" malus="-99"/>
                                <KeyValue key="ScenicRouteType4" enabled="true" malus="-99"/>
                                <KeyValue key="ScenicRouteType5" enabled="true" malus="-99"/>
                                <KeyValue key="Trailer" enabled="true" malus="2501"/>
                                <KeyValue key="ResidentialTrucks" enabled="true" malus="2501"/>
                                <KeyValue key="DeliveryTrucks" enabled="true" malus="2501"/>
                                <KeyValue key="PublicTrucks" enabled="true" malus="2501"/>
                                <KeyValue key="PreferredTrucks" enabled="true" malus="-99"/>
                                <KeyValue key="PreferredHazardousTrucks" enabled="true" malus="-99"/>
                            </Legacy>
                        </AdditionalDataRules>
                    </Course>
                </Routing>
            </Profile>
        

Parameters without a default meaning, i.e. the meaning will be defined by the data producer

These parameters correspond to profile element Legacy within AdditionalDataRules:

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Profile>
                <Routing majorVersion="2" minorVersion="0">
                    <Course>
                        <AdditionalDataRules enabled="true" layerName="TruckAttributes">
                            <Legacy>
                                <KeyValue key="OptMalus1" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus2" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus3" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus4" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus5" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus6" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus7" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus8" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus9" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus10" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus11" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus12" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus13" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus14" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus15" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus16" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus17" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus18" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus19" enabled="true" malus="2501"/>
                                <KeyValue key="OptMalus20" enabled="true" malus="2501"/>
                            </Legacy>
                        </AdditionalDataRules>
                    </Course>
                </Routing>
            </Profile>
        

Segment attributes with a vehicle property

The following segment attributes have a parameter which represents a numerical vehicle property value (e.g. weight, height, length), i.e. if present in ROADEDITOR_ADDITIONAL_OPTIONS all segments carrying the attribute in question will be blocked if the property value exceeds the threshold contained in the data. For example, the data contains all tunnel segments and the threshold value is the maximum height of the tunnel. If the vehicle height is stated in the request, all tunnels which cannot be traveled by this vehicle will be blocked.

Please note that the data usually do not contain both representations, the non-directional (e.g. MAX_WEIGHT) and the directional (e.g. MAX_WEIGHT_DIR), of a parameter. Please consult the data producer for more information.

All of these parameters have a default meaning. If the actual vehicle property is greater than the maximum value (allowed range), the parameter must be the maximum value.

These parameters correspond to the profile element Legacy within AdditionalDataRules:

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Profile>
                <Routing majorVersion="2" minorVersion="0">
                    <Course>
                        <AdditionalDataRules enabled="true" layerName="TruckAttributes">
                            <Legacy>
                                <KeyValue key="MaxHeight" enabled="true" threshold="600"/>
                                <KeyValue key="MaxWeight" enabled="true" threshold="3000"/>
                                <KeyValue key="MaxWidth" enabled="true" threshold="300"/>
                                <KeyValue key="MaxLength" enabled="true" threshold="1000"/>
                                <KeyValue key="MaxAxleLoad" enabled="true" threshold="300"/>
                                <KeyValue key="MaxHeightDir" enabled="true" threshold="60"/>
                                <KeyValue key="MaxWeightDir" enabled="true" threshold="30"/>
                                <KeyValue key="MaxWidthDir" enabled="true" threshold="30"/>
                                <KeyValue key="MaxLengthDir" enabled="true" threshold="100"/>
                                <KeyValue key="MaxAxleLoadDir" enabled="true" threshold="30"/>
                            </Legacy>
                        </AdditionalDataRules>
                    </Course>
                </Routing>
            </Profile>
        

Segment attributes with both parameters, a malus and a vehicle property

The following segment attributes have both a parameter which represents a malus (range -99 to 2501) and a numerical vehicle property value (range 0 to 255), i.e. if present in ROADEDITOR_ADDITIONAL_OPTIONS all segments carrying the attribute in question and their values exceeding the threshold will take the given malus. This is useful to avoid or prefer road segments with vehicles having a certain property (e.g. long or heavy trucks). Please note that the first parameter represents the malus and the second parameter represents the vehicle property value (MALUS;VALUE). The latter must be greater than 0 or can be omitted, the vehicle's length (or weight) will then be used. Please note that an error is thrown if omitted and neither MAX_LENGTH (MAX_WEIGHT) nor MAX_LENGTH_DIR (MAX_WEIGHT_DIR) is given.

Please note that the range of the vehicle property value is 0 to 255 (integer values). The meaning of the value is defined by the data producer.

These parameters correspond to the profile element Legacy within AdditionalDataRules:

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Profile>
                <Routing majorVersion="2" minorVersion="0">
                    <Course>
                        <AdditionalDataRules enabled="true" layerName="TruckAttributes">
                            <Legacy>
                                <KeyValue key="DirOptCondMalus1" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus2" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus3" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus4" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus5" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus6" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus7" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus8" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus9" enabled="true" malus="2501" threshold="100"/>
                                <KeyValue key="DirOptCondMalus10" enabled="true" malus="2501" threshold="100"/>
                            </Legacy>
                        </AdditionalDataRules>
                    </Course>
                </Routing>
            </Profile>
        

Special use case: truck attributes

Truck attributes with a default meaning

Truck attributes without a default meaning

Copyright © 2024 PTV Logistics GmbH All rights reserved. | Imprint