• java.lang.Object
    • com.here.sdk.transport.TruckSpecifications

  • public final class TruckSpecifications
    extends java.lang.Object

    Truck specifications contain vehicle related attributes. Examples: Dimensions, weight, axle count. Only the fields that are set are considered for restriction handling.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      java.lang.Integer axleCount
      Defines total number of axles in the vehicle.
      java.lang.Integer grossWeightInKilograms
      Truck weight including trailers and shipped goods in kilograms.
      java.lang.Integer heightInCentimeters
      Truck height in centimeters.
      boolean isTruckLight
      A flag indicating whether the truck is light enough to be classified more as a car than a truck in Japan.
      java.lang.Integer lengthInCentimeters
      Truck length in centimeters.
      java.lang.Integer payloadCapacityInKilograms
      Allowed payload capacity, including trailers, specified in kilograms.
      java.lang.Integer trailerAxleCount
      Defines total number of axles across all the trailers attached to the vehicle.
      java.lang.Integer trailerCount
      Defines number of trailers attached to the vehicle.
      TruckType truckType
      Defines the type of truck.
      WeightPerAxleGroup weightPerAxleGroup
      Allows specification of axle weights in a more fine-grained way than weight_per_axle_in_kilograms.
      java.lang.Integer weightPerAxleInKilograms
      Heaviest weight per axle, regardless of axle type or axle group.
      java.lang.Integer widthInCentimeters
      Truck width in centimeters.
    • Constructor Summary

      Constructors 
      Constructor Description
      TruckSpecifications()
      Creates a new instance.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean equals​(java.lang.Object obj)  
      int hashCode()  
      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • grossWeightInKilograms

        @Nullable
        public java.lang.Integer grossWeightInKilograms

        Truck weight including trailers and shipped goods in kilograms. The provided value must be greater than or equal to 0. By default, it is not set.

      • weightPerAxleInKilograms

        @Nullable
        public java.lang.Integer weightPerAxleInKilograms

        Heaviest weight per axle, regardless of axle type or axle group. It is evaluated against all axle weight restrictions, including single axle and tandem axle weight restrictions. The provided value must be greater or equal to 0. By default, it is not set. Note: weight_per_axle_in_kilograms and weight_per_axle_group are incompatible. When available for your edition, if both attributes are set, during online RoutingEngine an [sdk.routing.RoutingError.INVALID_PARAMETER] error is generated. Otherwise, when offline RoutingEngine is in place, both parameters are evaluated and the maximum value between them will be used.

      • weightPerAxleGroup

        @Nullable
        public WeightPerAxleGroup weightPerAxleGroup

        Allows specification of axle weights in a more fine-grained way than weight_per_axle_in_kilograms. This is relevant in countries with signs and regulations that specify different limits for different axle groups, like the USA and Sweden. By default is not set. Note: weight_per_axle_in_kilograms and weight_per_axle_group are incompatible. When available for your edition, if both attributes are set, during online RoutingEngine an [sdk.routing.RoutingError.INVALID_PARAMETER] error is generated. Otherwise, when offline RoutingEngine is in place, both parameters are evaluated and the maximum value between them will be used.

      • heightInCentimeters

        @Nullable
        public java.lang.Integer heightInCentimeters

        Truck height in centimeters. The provided value must be in the range [0, 5000]. By default, it is not set.

      • widthInCentimeters

        @Nullable
        public java.lang.Integer widthInCentimeters

        Truck width in centimeters. The provided value must be in the range [0, 5000]. By default, it is not set.

      • lengthInCentimeters

        @Nullable
        public java.lang.Integer lengthInCentimeters

        Truck length in centimeters. The provided value must be in the range [0, 30000]. By default, it is not set.

      • axleCount

        @Nullable
        public java.lang.Integer axleCount

        Defines total number of axles in the vehicle. The provided value must be greater than or equal to 2. By default, it is not set. Route calculation: When not set, possible axle count restrictions will not be taken into consideration. Rendering sdk.mapview.TruckProfile: When set, truck restriction icons for an axle count greater than axleCount will not be displayed. When specifying trailerAxleCount, then axleCount is required and must be greater than trailerAxleCount.

      • trailerCount

        @Nullable
        public java.lang.Integer trailerCount

        Defines number of trailers attached to the vehicle. The provided value must be in the range [0, 255]. By default, it is not set. When specifying trailerAxleCount, then trailerCount is required and must be greater than 0.

      • truckType

        @NonNull
        public TruckType truckType

        Defines the type of truck. By default, it is TruckType.STRAIGHT. Rendering sdk.mapview.TruckProfile: truckType is ignored and has no effect.

      • isTruckLight

        public boolean isTruckLight

        A flag indicating whether the truck is light enough to be classified more as a car than a truck in Japan. The flag should not be set to true in other countries than Japan. The flag defaults to false.

        A light truck exempts from many legal restrictions for normal trucks in Japan, for example, which streets the vehicle can access, which access restrictions apply, and which speed limits are applicable. Restrictions related to the dimensions of the truck, or its cargo may still apply and setting this flag will not always overwrite these settings: Make sure to not exceed the specifications that classify a truck as light.

        In Japan, for light trucks the same restrictions apply as for cars. Therefore, when the flag is set to true, you will get, for example, the same speed limits as for cars. Make sure to set the flag only to true, when a vehicle matches the classification for light trucks according to the vehicle regulations in Japan.

        When TruckSpecifications are set as part of MapContentSettings, then this flag will be ignored and has no effect.

        Note: This flag and the concept of light trucks are supported only in Japan as beta and are considered to be experimental in other regions. Therefore, for now, it is recommended to use this flag only in Japan. Note that this is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases with a deprecation process.

      • payloadCapacityInKilograms

        @Nullable
        public java.lang.Integer payloadCapacityInKilograms

        Allowed payload capacity, including trailers, specified in kilograms. The provided value must be greater then or equal to 0. By default, it is not set.

      • trailerAxleCount

        @Nullable
        public java.lang.Integer trailerAxleCount

        Defines total number of axles across all the trailers attached to the vehicle. This number is included in axleCount, hence trailerAxleCount must be less than axleCount and greater than or equal to 1. axleCount and trailerCount are required to specify trailerAxleCount. By default, it is not set. Note: This parameter is currently used only for the calculation of tolls in regions where it is applicable.

    • Constructor Detail

      • TruckSpecifications

        public TruckSpecifications()

        Creates a new instance.

    • Method Detail

      • equals

        public boolean equals​(java.lang.Object obj)
        Overrides:
        equals in class java.lang.Object
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object