com.tomtom.online.sdk.data

Class CommonParamsBuilder

java.lang.Object

com.tomtom.online.sdk.data.CommonParamsBuilder

All Implemented Interfaces:

CommonParams

public class CommonParamsBuilder
extends java.lang.Object
implements CommonParams

Constructor Summary

Constructors

Constructor and Description
CommonParamsBuilder()

Method Summary

Modifier and Type	Method and Description
void	dispose() Remove all internal references, clear memory, invalidate the native handle.
long	getNativeHandle() Get unique query id, valid until CommonParams.dispose() is called.
CommonParamsBuilder	withAccelerationEfficiency(double accelerationEfficiency) Specifies the efficiency of converting chemical energy stored in fuel to kinetic energy when the vehicle accelerates (i.e.
CommonParams	withAllowVignettes(java.util.List<java.lang.String> allowVignettes) A list of 3-character ISO 3166-1 alpha-3 country codes of countries in which toll roads with vignettes are allowed.
CommonParamsBuilder	withAuxiliaryPowerInKW(double auxiliaryPowerInKW) Specifies the amount of power consumed for sustaining auxiliary systems, in kilowatts (kW).
CommonParamsBuilder	withAuxiliaryPowerInLitersPerHour(double auxiliaryPowerInLitersPerHour) Specifies the amount of fuel consumed for sustaining auxiliary systems of the vehicle, in liters per hour.
CommonParams	withAvoidAreas(java.util.List<com.tomtom.online.sdk.common.location.BoundingBox> avoidAreas) A list of rectangles that define areas that are to be avoided during reachable range calculation.
CommonParamsBuilder	withAvoidType(Avoid avoidType) Specifies what the route calculation should try to avoid when determining the route.
CommonParamsBuilder	withAvoidVignettes(java.util.List<java.lang.String> avoidVignettes) A list of 3-character ISO 3166-1 alpha-3 country codes of countries in which all toll roads with vignettes are to be avoided.
CommonParamsBuilder	withConsiderTraffic(boolean considerTraffic) Specifies if all available traffic information should be considered during routing.
CommonParamsBuilder	withConstantSpeedConsumptionInKWhPerHundredKm(SpeedToConsumptionMap constantSpeedConsumptionInKWhPerHundredKm) Specifies the speed-dependent component of consumption.
CommonParamsBuilder	withConstantSpeedConsumptionInLitersPerHundredKm(SpeedToConsumptionMap constantSpeedConsumptionInLitersPerHundredKm) Specifies the speed-dependent component of consumption.
CommonParamsBuilder	withCurrentChargeInKWh(double currentChargeInKWh) Specifies the current electric energy supply in kilowatt hours (kWh).
CommonParamsBuilder	withCurrentFuelInLiters(double currentFuelInLiters) Specifies the current supply of fuel in liters.
CommonParamsBuilder	withDecelerationEfficiency(double decelerationEfficiency) Specifies the efficiency of converting kinetic energy to saved (not consumed) fuel when the vehicle decelerates (i.e.
CommonParamsBuilder	withDepartAt(java.util.Date departAt) Specifies the departure time.
CommonParamsBuilder	withDownhillEfficiency(double downhillEfficiency) Specifies the efficiency of converting potential energy to saved (not consumed) fuel when the vehicle loses elevation (i.e.
CommonParamsBuilder	withFuelEnergyDensityInMJoulesPerLiter(double fuelEnergyDensityInMJoulesPerLiter) Specifies the amount of chemical energy stored in one liter of fuel in megajoules (MJ).
CommonParamsBuilder	withHilliness(Hilliness hilliness) Specifies the hilliness type for route calculation.
CommonParamsBuilder	withIsVehicleCommercial(boolean isVehicleCommercial) Specifies if the vehicle is used for commercial to calculate route.
CommonParamsBuilder	withMaxChargeInKWh(double maxChargeInKWh) Specifies the capacity of the vehicle's battery in kilowatt hours (kWh).
CommonParamsBuilder	withReport(Report report) Specifies what data should be reported for diagnostic purposes.
CommonParamsBuilder	withRouteType(RouteType routeType) Specifies the route type.
CommonParamsBuilder	withTravelMode(TravelMode travelMode) Specifies the travel mode for route calculation.
CommonParamsBuilder	withUphillEfficiency(double uphillEfficiency) Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e.
CommonParamsBuilder	withVehicleAxleWeightInKg(int vehicleAxleWeightInKg) Specifies the vehicle axle weight for route calculation.
CommonParamsBuilder	withVehicleEngineType(VehicleEngineType vehicleEngineType) Specifies the vehicle engine type for route query.
CommonParamsBuilder	withVehicleHeightInMeters(double vehicleHeightInMeters) Specifies the vehicle height for route calculation.
CommonParamsBuilder	withVehicleLengthInMeters(double vehicleLengthInMeters) Specifies the vehicle length for route calculation.
CommonParamsBuilder	withVehicleLoadType(VehicleLoadType vehicleLoadType) Specifies the vehicle load type for route calculation.
CommonParamsBuilder	withVehicleMaxSpeedInKph(int vehicleMaxSpeedInKph) Specifies the vehicle max speed for route calculation.
CommonParamsBuilder	withVehicleWeightInKg(int vehicleWeightInKg) Specifies the vehicle weight in kilograms for route calculation.
CommonParamsBuilder	withVehicleWidthInMeters(double vehicleWidthInMeters) Specifies the vehicle width for route calculation.
CommonParamsBuilder	withWindingness(Windingness windingness) Specifies the windingness type for route calculation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CommonParamsBuilder

public CommonParamsBuilder()

Method Detail

getNativeHandle

public long getNativeHandle()

Description copied from interface: CommonParams

Get unique query id, valid until CommonParams.dispose() is called.

Specified by:

getNativeHandle in interface CommonParams

dispose

public void dispose()

Description copied from interface: CommonParams

Remove all internal references, clear memory, invalidate the native handle.

Specified by:

dispose in interface CommonParams

withReport

public CommonParamsBuilder withReport(Report report)

Description copied from interface: CommonParams

Specifies what data should be reported for diagnostic purposes.

Specified by:

withReport in interface CommonParams

Returns:

reference to the common params object

withDepartAt

public CommonParamsBuilder withDepartAt(java.util.Date departAt)

Description copied from interface: CommonParams

Specifies the departure time.

Specified by:

withDepartAt in interface CommonParams

Returns:

reference to the common params object

withRouteType

public CommonParamsBuilder withRouteType(RouteType routeType)

Description copied from interface: CommonParams

Specifies the route type.

Specified by:

withRouteType in interface CommonParams

Returns:

reference to the common params object

withConsiderTraffic

public CommonParamsBuilder withConsiderTraffic(boolean considerTraffic)

Description copied from interface: CommonParams

Specifies if all available traffic information should be considered during routing.

Specified by:

withConsiderTraffic in interface CommonParams

Returns:

reference to the common params object

withAvoidType

public CommonParamsBuilder withAvoidType(Avoid avoidType)

Description copied from interface: CommonParams

Specifies what the route calculation should try to avoid when determining the route. Can be specified multiple times.

Specified by:

withAvoidType in interface CommonParams

Returns:

reference to the common params object

withTravelMode

public CommonParamsBuilder withTravelMode(TravelMode travelMode)

Description copied from interface: CommonParams

Specifies the travel mode for route calculation.

Specified by:

withTravelMode in interface CommonParams

Returns:

reference to the common params object

withHilliness

public CommonParamsBuilder withHilliness(Hilliness hilliness)

Description copied from interface: CommonParams

Specifies the hilliness type for route calculation.

Specified by:

withHilliness in interface CommonParams

Returns:

reference to the common params object

withWindingness

public CommonParamsBuilder withWindingness(Windingness windingness)

Description copied from interface: CommonParams

Specifies the windingness type for route calculation.

Specified by:

withWindingness in interface CommonParams

Returns:

reference to the common params object

withVehicleMaxSpeedInKph

public CommonParamsBuilder withVehicleMaxSpeedInKph(int vehicleMaxSpeedInKph)

Description copied from interface: CommonParams

Specifies the vehicle max speed for route calculation.

Specified by:

withVehicleMaxSpeedInKph in interface CommonParams

Returns:

reference to the common params object

withVehicleWeightInKg

public CommonParamsBuilder withVehicleWeightInKg(int vehicleWeightInKg)

Description copied from interface: CommonParams

Specifies the vehicle weight in kilograms for route calculation.

Specified by:

withVehicleWeightInKg in interface CommonParams

Returns:

reference to the common params object

withVehicleAxleWeightInKg

public CommonParamsBuilder withVehicleAxleWeightInKg(int vehicleAxleWeightInKg)

Description copied from interface: CommonParams

Specifies the vehicle axle weight for route calculation.

Specified by:

withVehicleAxleWeightInKg in interface CommonParams

Returns:

reference to the common params object

withVehicleLengthInMeters

public CommonParamsBuilder withVehicleLengthInMeters(double vehicleLengthInMeters)

Description copied from interface: CommonParams

Specifies the vehicle length for route calculation.

Specified by:

withVehicleLengthInMeters in interface CommonParams

Returns:

reference to the common params object

withVehicleWidthInMeters

public CommonParamsBuilder withVehicleWidthInMeters(double vehicleWidthInMeters)

Description copied from interface: CommonParams

Specifies the vehicle width for route calculation.

Specified by:

withVehicleWidthInMeters in interface CommonParams

Returns:

reference to the common params object

withVehicleHeightInMeters

public CommonParamsBuilder withVehicleHeightInMeters(double vehicleHeightInMeters)

Description copied from interface: CommonParams

Specifies the vehicle height for route calculation.

Specified by:

withVehicleHeightInMeters in interface CommonParams

Returns:

reference to the common params object

withIsVehicleCommercial

public CommonParamsBuilder withIsVehicleCommercial(boolean isVehicleCommercial)

Description copied from interface: CommonParams

Specifies if the vehicle is used for commercial to calculate route.

Specified by:

withIsVehicleCommercial in interface CommonParams

Returns:

reference to the common params object

withVehicleLoadType

public CommonParamsBuilder withVehicleLoadType(VehicleLoadType vehicleLoadType)

Description copied from interface: CommonParams

Specifies the vehicle load type for route calculation.

Specified by:

withVehicleLoadType in interface CommonParams

Returns:

reference to the common params object

withVehicleEngineType

public CommonParamsBuilder withVehicleEngineType(VehicleEngineType vehicleEngineType)

Description copied from interface: CommonParams

Specifies the vehicle engine type for route query.

Specified by:

withVehicleEngineType in interface CommonParams

Returns:

reference to the common params object

withConstantSpeedConsumptionInLitersPerHundredKm

public CommonParamsBuilder withConstantSpeedConsumptionInLitersPerHundredKm(SpeedToConsumptionMap constantSpeedConsumptionInLitersPerHundredKm)

Description copied from interface: CommonParams

Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate in liters-per-100km pairs. Applicable only for combustion engines.

Specified by:

withConstantSpeedConsumptionInLitersPerHundredKm in interface CommonParams

Parameters:

constantSpeedConsumptionInLitersPerHundredKm - constraints: size - [1, 25], consumption value - [0.01, 100000.0]

Returns:

reference to the common params object

withCurrentFuelInLiters

public CommonParamsBuilder withCurrentFuelInLiters(double currentFuelInLiters)

Description copied from interface: CommonParams

Specifies the current supply of fuel in liters. Applicable only for combustion engines.

Specified by:

withCurrentFuelInLiters in interface CommonParams

Returns:

reference to the common params object

withAuxiliaryPowerInLitersPerHour

public CommonParamsBuilder withAuxiliaryPowerInLitersPerHour(double auxiliaryPowerInLitersPerHour)

Description copied from interface: CommonParams

Specifies the amount of fuel consumed for sustaining auxiliary systems of the vehicle, in liters per hour. It can be used to specify consumption due to devices and systems such as AC systems, radio, heating, etc. Applicable only for combustion engines.

Specified by:

withAuxiliaryPowerInLitersPerHour in interface CommonParams

Returns:

reference to the common params object

withFuelEnergyDensityInMJoulesPerLiter

public CommonParamsBuilder withFuelEnergyDensityInMJoulesPerLiter(double fuelEnergyDensityInMJoulesPerLiter)

Description copied from interface: CommonParams

Specifies the amount of chemical energy stored in one liter of fuel in megajoules (MJ). It is used in conjunction with the *Efficiency parameters for conversions between saved or consumed energy and fuel. For example, energy density is 34.2 MJ/l for gasoline, and 35.8 MJ/l for Diesel fuel. Applicable only for combustion engines.

Specified by:

withFuelEnergyDensityInMJoulesPerLiter in interface CommonParams

Returns:

reference to the common params object

withAccelerationEfficiency

public CommonParamsBuilder withAccelerationEfficiency(double accelerationEfficiency)

Description copied from interface: CommonParams

Specifies the efficiency of converting chemical energy stored in fuel to kinetic energy when the vehicle accelerates (i.e. KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed is obtained by converting consumed fuel to chemical energy using fuelEnergyDensityInMJoulesPerLiter. Applicable only for combustion engines. If used at all, must be used in conjunction with CommonParams.withDecelerationEfficiency(double). If used, CommonParams.withVehicleWeightInKg(int) has to be used as well.

Specified by:

withAccelerationEfficiency in interface CommonParams

Parameters:

accelerationEfficiency - valid values: [0.0, 1/decelerationEfficiency]

Returns:

reference to the common params object

withDecelerationEfficiency

public CommonParamsBuilder withDecelerationEfficiency(double decelerationEfficiency)

Description copied from interface: CommonParams

Specifies the efficiency of converting kinetic energy to saved (not consumed) fuel when the vehicle decelerates (i.e. ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved is obtained by converting saved (not consumed) fuel to energy using fuelEnergyDensityInMJoulesPerLiter. Applicable only for combustion engines. If used at all, must be used in conjunction with CommonParams.withAccelerationEfficiency(double). If used, CommonParams.withVehicleWeightInKg(int) has to be used as well.

Specified by:

withDecelerationEfficiency in interface CommonParams

Parameters:

decelerationEfficiency - valid values: [0.0, 1/accelerationEfficiency]

Returns:

reference to the common params object

withUphillEfficiency

public CommonParamsBuilder withUphillEfficiency(double uphillEfficiency)

Description copied from interface: CommonParams

Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed is obtained by converting consumed fuel to chemical energy using fuelEnergyDensityInMJoulesPerLiter. Applicable only for combustion engines. If used at all, must be used in conjunction with CommonParams.withDownhillEfficiency(double). If used, CommonParams.withVehicleWeightInKg(int) has to be used as well.

Specified by:

withUphillEfficiency in interface CommonParams

Parameters:

uphillEfficiency - valid values: [0.0, 1/downhillEfficiency]

Returns:

reference to the common params object

withDownhillEfficiency

public CommonParamsBuilder withDownhillEfficiency(double downhillEfficiency)

Description copied from interface: CommonParams

Specifies the efficiency of converting potential energy to saved (not consumed) fuel when the vehicle loses elevation (i.e. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved is obtained by converting saved (not consumed) fuel to energy using fuelEnergyDensityInMJoulesPerLiter. Applicable only for combustion engines. If used at all, must be used in conjunction with CommonParams.withUphillEfficiency(double). If used, CommonParams.withVehicleWeightInKg(int) has to be used as well.

Specified by:

withDownhillEfficiency in interface CommonParams

Parameters:

downhillEfficiency - valid values: [0.0, 1/uphillEfficiency]

Returns:

reference to the common params object

withConstantSpeedConsumptionInKWhPerHundredKm

public CommonParamsBuilder withConstantSpeedConsumptionInKWhPerHundredKm(SpeedToConsumptionMap constantSpeedConsumptionInKWhPerHundredKm)

Description copied from interface: CommonParams

Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate in kWh pairs. Applicable only for electric engines.

Specified by:

withConstantSpeedConsumptionInKWhPerHundredKm in interface CommonParams

Parameters:

constantSpeedConsumptionInKWhPerHundredKm - constraints: size - [1, 25], consumption value - [0.01, 100000.0]

Returns:

reference to the common params object

withCurrentChargeInKWh

public CommonParamsBuilder withCurrentChargeInKWh(double currentChargeInKWh)

Description copied from interface: CommonParams

Specifies the current electric energy supply in kilowatt hours (kWh). Applicable only for electric engines. If used at all, must be used in conjunction with CommonParams.withMaxChargeInKWh(double).

Specified by:

withCurrentChargeInKWh in interface CommonParams

Returns:

reference to the common params object

withMaxChargeInKWh

public CommonParamsBuilder withMaxChargeInKWh(double maxChargeInKWh)

Description copied from interface: CommonParams

Specifies the capacity of the vehicle's battery in kilowatt hours (kWh). Applicable only for electric engines. If used at all, must be used in conjunction with CommonParams.withCurrentChargeInKWh(double).

Specified by:

withMaxChargeInKWh in interface CommonParams

Returns:

reference to the common params object

withAuxiliaryPowerInKW

public CommonParamsBuilder withAuxiliaryPowerInKW(double auxiliaryPowerInKW)

Description copied from interface: CommonParams

Specifies the amount of power consumed for sustaining auxiliary systems, in kilowatts (kW). It can be used to specify consumption due to devices and systems such as AC systems, radio, heating, etc. Applicable only for electric engines.

Specified by:

withAuxiliaryPowerInKW in interface CommonParams

Returns:

reference to the common params object

withAvoidVignettes

public CommonParamsBuilder withAvoidVignettes(@NonNull
                                              java.util.List<java.lang.String> avoidVignettes)

Description copied from interface: CommonParams

A list of 3-character ISO 3166-1 alpha-3 country codes of countries in which all toll roads with vignettes are to be avoided. Toll roads with vignettes in countries not on the list are unaffected. It is an error to use both withAvoidVignettes and withAllowVignettes.

Specified by:

withAvoidVignettes in interface CommonParams

Returns:

reference to the common params object

withAllowVignettes

public CommonParams withAllowVignettes(java.util.List<java.lang.String> allowVignettes)

Description copied from interface: CommonParams

A list of 3-character ISO 3166-1 alpha-3 country codes of countries in which toll roads with vignettes are allowed. Specifying allowVignettes with some countries X is equivalent to specifying avoidVignette with all countries but X. Using withAllowVignettes with an empty list is the same as avoiding all toll roads with vignettes. It is an error to use both withAvoidVignettes and withAllowVignettes.

Specified by:

withAllowVignettes in interface CommonParams

Returns:

reference to the common params object

withAvoidAreas

public CommonParams withAvoidAreas(java.util.List<com.tomtom.online.sdk.common.location.BoundingBox> avoidAreas)

Description copied from interface: CommonParams

A list of rectangles that define areas that are to be avoided during reachable range calculation.

Specified by:

withAvoidAreas in interface CommonParams

Returns:

reference to the common params object