MatrixRoutingQueryBuilder (Android Routing SDK

java.lang.Object
- com.tomtom.online.sdk.routing.data.matrix.MatrixRoutingQueryBuilder

public class MatrixRoutingQueryBuilder
extends java.lang.Object

The default builder for MatrixRoutingQuery objects.

Constructor Summary

Constructors
Constructor and Description

MatrixRoutingQueryBuilder(java.util.List<LatLng> origins, java.util.List<LatLng> destinations)

Constructors
Constructor and Description
`MatrixRoutingQueryBuilder(java.util.List<LatLng> origins, java.util.List<LatLng> destinations)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`MatrixRoutingQuery`	`build()` Creates new instance of `MatrixRoutingQuery`
`static MatrixRoutingQueryBuilder`	`create(java.util.List<LatLng> origins, java.util.List<LatLng> destinations)` Creates an instance of `MatrixRoutingQueryBuilder` with given origins and destinations lists.
`MatrixRoutingQueryBuilder`	`withAccelerationEfficiency(java.lang.Double accelerationEfficiency)` Specifies the efficiency of converting kinetic energy to saved (not consumed) fuel when the vehicle decelerates (i.e.
`MatrixRoutingQueryBuilder`	`withAuxiliaryPowerInKW(java.lang.Double auxiliaryPowerInKW)` Specifies the amount of power consumed for sustaining auxiliary systems, in kilowatts (kW).
`MatrixRoutingQueryBuilder`	`withAuxiliaryPowerInLitersPerHour(java.lang.Double auxiliaryPowerInLitersPerHour)` Specifies the amount of fuel consumed for sustaining auxiliary systems of the vehicle, in liters per hour.
`MatrixRoutingQueryBuilder`	`withAvoidType(Avoid avoidType)` Specifies what the route calculation should try to avoid when determining the route.Can be specified multiple times.
`MatrixRoutingQueryBuilder`	`withConsiderTraffic(java.lang.Boolean considerTraffic)` Specifies if all available traffic information should be considered during routing.
`MatrixRoutingQueryBuilder`	`withConstantSpeedConsumptionInKWhPerHundredKm(SpeedToConsumptionMap constantSpeedConsumptionInKWhPerHundredKm)` Specifies the speed-dependent component of consumption.
`MatrixRoutingQueryBuilder`	`withConstantSpeedConsumptionInLitersPerHundredKm(SpeedToConsumptionMap constantSpeedConsumptionInLitersPerHundredKm)` Specifies the speed-dependent component of consumption.
`MatrixRoutingQueryBuilder`	`withCurrentChargeInKWh(java.lang.Double currentChargeInKWh)` Specifies the current electric energy supply in kilowatt hours (kWh).
`MatrixRoutingQueryBuilder`	`withCurrentFuelInLiters(java.lang.Double currentFuelInLiters)` Specifies the current supply of fuel in liters.
`MatrixRoutingQueryBuilder`	`withDecelerationEfficiency(java.lang.Double decelerationEfficiency)` Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e.
`MatrixRoutingQueryBuilder`	`withDepartAt(java.util.Date departAt)` Specifies the departure time.
`MatrixRoutingQueryBuilder`	`withDownhillEfficiency(java.lang.Double downhillEfficiency)` Specifies the efficiency of converting potential energy to saved (not consumed) fuel when the vehicle loses elevation (i.e.
`MatrixRoutingQueryBuilder`	`withFuelEnergyDensityInMJoulesPerLiter(java.lang.Double fuelEnergyDensityInMJoulesPerLiter)` Specifies the amount of chemical energy stored in one liter of fuel in megajoules (MJ).
`MatrixRoutingQueryBuilder`	`withHilliness(Hilliness hilliness)` Specifies the hilliness type for route calculation.
`MatrixRoutingQueryBuilder`	`withMaxChargeInKWh(java.lang.Double maxChargeInKWh)` Specifies the capacity of the vehicle's battery in kilowatt hours (kWh).
`MatrixRoutingQueryBuilder`	`withRouteType(RouteType routeType)` Specifies the route type.
`MatrixRoutingQueryBuilder`	`withTravelMode(TravelMode travelMode)` Specifies the travel mode for route calculation.
`MatrixRoutingQueryBuilder`	`withUphillEfficiency(java.lang.Double uphillEfficiency)` Specifies the efficiency of converting chemical energy stored in fuel to potential energy when the vehicle gains elevation (i.e.
`MatrixRoutingQueryBuilder`	`withVehicleAxleWeightInKg(java.lang.Integer vehicleAxleWeightInKg)` Specifies the vehicle axle weight for route calculation.
`MatrixRoutingQueryBuilder`	`withVehicleCommercial(java.lang.Boolean vehicleCommercial)` Specifies if the vehicle is used for commercial to calculate route.
`MatrixRoutingQueryBuilder`	`withVehicleEngineType(VehicleEngineType vehicleEngineType)` Specifies the vehicle engine type for route query.
`MatrixRoutingQueryBuilder`	`withVehicleHeightInMeters(java.lang.Double vehicleHeightInMeters)` Specifies the vehicle height for route calculation.
`MatrixRoutingQueryBuilder`	`withVehicleLengthInMeters(java.lang.Double vehicleLengthInMeters)` Specifies the vehicle length for route calculation.
`MatrixRoutingQueryBuilder`	`withVehicleLoadType(VehicleLoadType vehicleLoadType)` Specifies the vehicle load type for route calculation.
`MatrixRoutingQueryBuilder`	`withVehicleMaxSpeedInKph(java.lang.Integer vehicleMaxSpeedInKph)` Specifies the vehicle max speed for route calculation.
`MatrixRoutingQueryBuilder`	`withVehicleWeightInKg(java.lang.Integer vehicleWeightInKg)` Specifies the vehicle weight in kilograms for route calculation.
`MatrixRoutingQueryBuilder`	`withVehicleWidthInMeters(java.lang.Double vehicleWidthInMeters)` Specifies the vehicle width for route calculation.
`MatrixRoutingQueryBuilder`	`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
  - MatrixRoutingQueryBuilder
```
public MatrixRoutingQueryBuilder(java.util.List<LatLng> origins,
                                 java.util.List<LatLng> destinations)
```
- Method Detail
  - withDepartAt
```
public MatrixRoutingQueryBuilder withDepartAt(java.util.Date departAt)
```
    Specifies the departure time.
    
    Parameters:
    
    departAt -
    
    Returns:
    
    reference to the builder object
  - withRouteType
```
public MatrixRoutingQueryBuilder withRouteType(RouteType routeType)
```
    Specifies the route type.
    
    Parameters:
    
    routeType -
    
    Returns:
    
    reference to the builder object
  - withConsiderTraffic
```
public MatrixRoutingQueryBuilder withConsiderTraffic(java.lang.Boolean considerTraffic)
```
    Specifies if all available traffic information should be considered during routing.
    
    Parameters:
    
    considerTraffic -
    
    Returns:
    
    reference to the builder object
  - withAvoidType
```
public MatrixRoutingQueryBuilder withAvoidType(Avoid avoidType)
```
    Specifies what the route calculation should try to avoid when determining the route.Can be specified multiple times.
    
    Parameters:
    
    avoidType -
    
    Returns:
    
    reference to the common params object
  - withTravelMode
```
public MatrixRoutingQueryBuilder withTravelMode(TravelMode travelMode)
```
    Specifies the travel mode for route calculation.
    
    Parameters:
    
    travelMode -
    
    Returns:
    
    reference to the common params object
  - withHilliness
```
public MatrixRoutingQueryBuilder withHilliness(Hilliness hilliness)
```
    Specifies the hilliness type for route calculation.
    
    Parameters:
    
    hilliness -
    
    Returns:
    
    reference to the common params object
  - withWindingness
```
public MatrixRoutingQueryBuilder withWindingness(Windingness windingness)
```
    Specifies the windingness type for route calculation.
    
    Parameters:
    
    windingness -
    
    Returns:
    
    reference to the common params object
  - withVehicleMaxSpeedInKph
```
public MatrixRoutingQueryBuilder withVehicleMaxSpeedInKph(java.lang.Integer vehicleMaxSpeedInKph)
```
    Specifies the vehicle max speed for route calculation.
    
    Parameters:
    
    vehicleMaxSpeedInKph -
    
    Returns:
    
    reference to the common params object
  - withVehicleWeightInKg
```
public MatrixRoutingQueryBuilder withVehicleWeightInKg(java.lang.Integer vehicleWeightInKg)
```
    Specifies the vehicle weight in kilograms for route calculation.
    
    Parameters:
    
    vehicleWeightInKg -
    
    Returns:
    
    reference to the common params object
  - withVehicleAxleWeightInKg
```
public MatrixRoutingQueryBuilder withVehicleAxleWeightInKg(java.lang.Integer vehicleAxleWeightInKg)
```
    Specifies the vehicle axle weight for route calculation.
    
    Parameters:
    
    vehicleAxleWeightInKg -
    
    Returns:
    
    reference to the common params object
  - withVehicleLengthInMeters
```
public MatrixRoutingQueryBuilder withVehicleLengthInMeters(java.lang.Double vehicleLengthInMeters)
```
    Specifies the vehicle length for route calculation.
    
    Parameters:
    
    vehicleLengthInMeters -
    
    Returns:
    
    reference to the common params object
  - withVehicleWidthInMeters
```
public MatrixRoutingQueryBuilder withVehicleWidthInMeters(java.lang.Double vehicleWidthInMeters)
```
    Specifies the vehicle width for route calculation.
    
    Parameters:
    
    vehicleWidthInMeters -
    
    Returns:
    
    reference to the common params object
  - withVehicleHeightInMeters
```
public MatrixRoutingQueryBuilder withVehicleHeightInMeters(java.lang.Double vehicleHeightInMeters)
```
    Specifies the vehicle height for route calculation.
    
    Parameters:
    
    vehicleHeightInMeters -
    
    Returns:
    
    reference to the common params object
  - withVehicleCommercial
```
public MatrixRoutingQueryBuilder withVehicleCommercial(java.lang.Boolean vehicleCommercial)
```
    Specifies if the vehicle is used for commercial to calculate route.
    
    Parameters:
    
    isVehicleCommercial -
    
    Returns:
    
    reference to the common params object
  - withVehicleLoadType
```
public MatrixRoutingQueryBuilder withVehicleLoadType(VehicleLoadType vehicleLoadType)
```
    Specifies the vehicle load type for route calculation.
    
    Parameters:
    
    vehicleLoadType -
    
    Returns:
    
    reference to the common params object
  - withVehicleEngineType
```
public MatrixRoutingQueryBuilder withVehicleEngineType(VehicleEngineType vehicleEngineType)
```
    Specifies the vehicle engine type for route query.
    
    Parameters:
    
    vehicleEngineType -
    
    Returns:
    
    reference to the common params object
  - withConstantSpeedConsumptionInLitersPerHundredKm
```
public MatrixRoutingQueryBuilder withConstantSpeedConsumptionInLitersPerHundredKm(SpeedToConsumptionMap constantSpeedConsumptionInLitersPerHundredKm)
```
    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.
    
    Parameters:
    
    constantSpeedConsumptionInLitersPerHundredKm - constraints: size - [1, 25], consumption value - [0.01, 100000.0]
    
    Returns:
    
    reference to the common params object
  - withCurrentFuelInLiters
```
public MatrixRoutingQueryBuilder withCurrentFuelInLiters(java.lang.Double currentFuelInLiters)
```
    Specifies the current supply of fuel in liters. Applicable only for combustion engines.
    
    Parameters:
    
    currentFuelInLiters -
    
    Returns:
    
    reference to the common params object
  - withAuxiliaryPowerInLitersPerHour
```
public MatrixRoutingQueryBuilder withAuxiliaryPowerInLitersPerHour(java.lang.Double auxiliaryPowerInLitersPerHour)
```
    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.
    
    Parameters:
    
    auxiliaryPowerInLitersPerHour -
    
    Returns:
    
    reference to the common params object
  - withFuelEnergyDensityInMJoulesPerLiter
```
public MatrixRoutingQueryBuilder withFuelEnergyDensityInMJoulesPerLiter(java.lang.Double fuelEnergyDensityInMJoulesPerLiter)
```
    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.
    
    Parameters:
    
    fuelEnergyDensityInMJoulesPerLiter -
    
    Returns:
    
    reference to the common params object
  - withAccelerationEfficiency
```
public MatrixRoutingQueryBuilder withAccelerationEfficiency(java.lang.Double accelerationEfficiency)
```
    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 #withAccelerationEfficiency(double). If used, #withVehicleWeightInKg(int) has to be used as well.
    
    Parameters:
    
    decelerationEfficiency - valid values: [0.0, 1/accelerationEfficiency]
    
    Returns:
    
    reference to the common params object
  - withDecelerationEfficiency
```
public MatrixRoutingQueryBuilder withDecelerationEfficiency(java.lang.Double decelerationEfficiency)
```
    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 #withDownhillEfficiency(double). If used, #withVehicleWeightInKg(int) has to be used as well.
    
    Parameters:
    
    uphillEfficiency - valid values: [0.0, 1/downhillEfficiency]
    
    Returns:
    
    reference to the common params object
  - withUphillEfficiency
```
public MatrixRoutingQueryBuilder withUphillEfficiency(java.lang.Double uphillEfficiency)
```
    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 #withDownhillEfficiency(double). If used, #withVehicleWeightInKg(int) has to be used as well.
    
    Parameters:
    
    uphillEfficiency - valid values: [0.0, 1/downhillEfficiency]
    
    Returns:
    
    reference to the common params object
  - withDownhillEfficiency
```
public MatrixRoutingQueryBuilder withDownhillEfficiency(java.lang.Double downhillEfficiency)
```
    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 #withUphillEfficiency(double). If used, #withVehicleWeightInKg(int) has to be used as well.
    
    Parameters:
    
    downhillEfficiency - valid values: [0.0, 1/uphillEfficiency]
    
    Returns:
    
    reference to the common params object
  - withConstantSpeedConsumptionInKWhPerHundredKm
```
public MatrixRoutingQueryBuilder withConstantSpeedConsumptionInKWhPerHundredKm(SpeedToConsumptionMap constantSpeedConsumptionInKWhPerHundredKm)
```
    Specifies the speed-dependent component of consumption. Provided as an unordered list of speed/consumption-rate in kWh pairs. Applicable only for electric engines.
    
    Parameters:
    
    constantSpeedConsumptionInKWhPerHundredKm - constraints: size - [1, 25], consumption value - [0.01, 100000.0]
    
    Returns:
    
    reference to the common params object
  - withCurrentChargeInKWh
```
public MatrixRoutingQueryBuilder withCurrentChargeInKWh(java.lang.Double currentChargeInKWh)
```
    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 #withMaxChargeInKWh(double).
    
    Parameters:
    
    currentChargeInKWh -
    
    Returns:
    
    reference to the common params object
  - withMaxChargeInKWh
```
public MatrixRoutingQueryBuilder withMaxChargeInKWh(java.lang.Double maxChargeInKWh)
```
    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 #withCurrentChargeInKWh(double).
    
    Parameters:
    
    maxChargeInKWh -
    
    Returns:
    
    reference to the common params object
  - withAuxiliaryPowerInKW
```
public MatrixRoutingQueryBuilder withAuxiliaryPowerInKW(java.lang.Double auxiliaryPowerInKW)
```
    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.
    
    Parameters:
    
    auxiliaryPowerInKW -
    
    Returns:
    
    reference to the common params object
  - create
```
public static MatrixRoutingQueryBuilder create(java.util.List<LatLng> origins,
                                               java.util.List<LatLng> destinations)
```
    Creates an instance of MatrixRoutingQueryBuilder with given origins and destinations lists.
    
    Parameters:
    
    origins - list of origin locations used to calculate matrix routes.
    
    destinations - list of destination locations used to calculate matrix routes.
    
    Returns:
    
    newly created builder object for MatrixRoutingQuery to be used for further processing
  - build
```
public MatrixRoutingQuery build()
```
    Creates new instance of MatrixRoutingQuery

Class MatrixRoutingQueryBuilder

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MatrixRoutingQueryBuilder

Method Detail

withDepartAt

withRouteType

withConsiderTraffic

withAvoidType

withTravelMode

withHilliness

withWindingness

withVehicleMaxSpeedInKph

withVehicleWeightInKg

withVehicleAxleWeightInKg

withVehicleLengthInMeters

withVehicleWidthInMeters

withVehicleHeightInMeters

withVehicleCommercial

withVehicleLoadType

withVehicleEngineType

withConstantSpeedConsumptionInLitersPerHundredKm

withCurrentFuelInLiters

withAuxiliaryPowerInLitersPerHour

withFuelEnergyDensityInMJoulesPerLiter

withAccelerationEfficiency

withDecelerationEfficiency

withUphillEfficiency

withDownhillEfficiency

withConstantSpeedConsumptionInKWhPerHundredKm

withCurrentChargeInKWh

withMaxChargeInKWh

withAuxiliaryPowerInKW

create

build