route4me / route4me-php-sdk

src/Route4Me/V5/Vehicles/DataTypes/Vehicle.php

Indentation +374 added lines, -374 removed lines

@@ -18,378 +18,378 @@
  */
 class Vehicle extends Common
 {
-    /** The vehicle ID
-     * @var string $vehicle_id
-     */
-    public $vehicle_id;
-
-    /** Member ID assigned to the vehicle.
-     * @var integer $member_id
-     */
-    public $member_id;
-
-    /** If true, the vehicle is marked as deleted.
-     * @var boolean $is_deleted
-     */
-    public $is_deleted;
-
-    /** Vehicle alias
-     * @var string $vehicle_alias
-     */
-    public $vehicle_alias;
-
-    /** Vehicle VIN
-     * @var string $vehicle_vin
-     */
-    public $vehicle_vin;
-
-    /** Vehicle registration state ID.
-     * @var integer $vehicle_reg_state_id
-     */
-    public $vehicle_reg_state_id;
-
-    /** Vehicle registration country ID.
-     * @var integer $vehicle_reg_country_id
-     */
-    public $vehicle_reg_country_id;
-
-    /** A license plate of the vehicle.
-     * @var string $vehicle_license_plate
-     */
-    public $vehicle_license_plate;
-
-    /** Vehicle type.
-     * <para>Availbale values:</para>
-     * sedan', 'suv', 'pickup_truck', 'van', '18wheeler', 'cabin', 'hatchback',
-     * '<para>motorcyle', 'waste_disposal', 'tree_cutting', 'bigrig', 'cement_mixer', </para>
-     * 'livestock_carrier', 'dairy','tractor_trailer'.
-     * @var string $vehicle_type_id
-     */
-    public $vehicle_type_id;
-
-    /** When the vehicle was added.
-     * @var string $timestamp_added
-     */
-    public $timestamp_added;
-
-    /** Vehicle maker brend.
-     * <para>Available values:</para>
-     * "american coleman", "bmw", "chevrolet", "ford", "freightliner", "gmc",
-     * <para>"hino", "honda", "isuzu", "kenworth", "mack", "mercedes-benz", "mitsubishi", </para>
-     * "navistar", "nissan", "peterbilt", "renault", "scania", "sterling", "toyota",
-     * <para>"volvo", "western star" </para>
-     * </value>"
-     * @var string $vehicle_make
-     */
-    public $vehicle_make;
-
-    /** Vehicle model year
-     * @var integer $vehicle_model_year
-     */
-    public $vehicle_model_year;
-
-    /** Vehicle model
-     * @var string $vehicle_model
-     */
-    public $vehicle_model;
-
-    /** The year, vehicle was acquired
-     * @var integer $vehicle_year_acquired
-     */
-    public $vehicle_year_acquired;
-
-    /** A cost of the new vehicle
-     * @var float $vehicle_cost_new
-     */
-    public $vehicle_cost_new;
-
-    /** If true, the vehicle was purchased new.
-     * @var boolean $purchased_new
-     */
-    public $purchased_new;
-
-    /** Start date of the license
-     * @var string $license_start_date
-     */
-    public $license_start_date;
-
-    /** End date of the license
-     * @var string $license_end_date
-     */
-    public $license_end_date;
-
-    /** If equal to '1', the vehicle is operational.
-     * @var boolean $is_operational
-     */
-    public $is_operational;
-
-    /** A type of the fuel
-     * @var string $fuel_type
-     * enum: ['unleaded 87','unleaded 89','unleaded 91','unleaded 93','diesel','electric','hybrid']
-     */
-    public $fuel_type;
-
-    /** External telematics vehicle IDs
-     * @var integer $external_telematics_vehicle_ids
-     */
-    public $external_telematics_vehicle_id;
-
-    /** When the vehcile was marked as deleted.
-     * @var integer $timestamp_removed
-     */
-    public $timestamp_removed;
-
-    /** Vehicle profile ID
-     * @var integer $vehicle_profile_id
-     */
-    public $vehicle_profile_id;
-
-    /** Fuel consumption city
-     * @var float $fuel_consumption_city
-     */
-    public $fuel_consumption_city;
-
-    /** Fuel consumption in the highway area
-     * @var float $fuel_consumption_highway
-     */
-    public $fuel_consumption_highway;
-
-    /** Fuel consumption units in the city area (e.g. mi/l)
-     * @var string $fuel_consumption_city_unit
-     */
-    public $fuel_consumption_city_unit;
-
-    /** Fuel consumption units in the highway area (e.g. mi/l)
-     * @var string $fuel_consumption_highway_unit
-     */
-    public $fuel_consumption_highway_unit;
-
-    /** Miles per gallon in the city area
-     * @var float $mpg_city
-     */
-    public $mpg_city;
-
-    /** Miles per gallon in the highway area
-     * @var float $mpg_highway
-     */
-    public $mpg_highway;
-
-    /** Fuel consumption UF value in the city area (e.g. '20.01 mi/l')
-     * @var string $fuel_consumption_city_uf_value
-     */
-    public $fuel_consumption_city_uf_value;
-
-    /** Fuel consumption UF value in the highway area (e.g. '2,000.01 mpg')
-     * @var string $fuel_consumption_highway_uf_value
-     */
-    public $fuel_consumption_highway_uf_value;
-
-    public static function fromArray(array $params)
-    {
-        $vehicle = new self();
-
-        foreach ($params as $key => $value) {
-            if (is_null(Common::getValue($params, $key))) continue;
-            if (property_exists($vehicle, $key)) {
-                $vehicle->$key = $value;
-            }
-        }
-
-        return $vehicle;
-    }
-
-    public function __construct()
-    {
-        Route4Me::setBaseUrl("");
-    }
-
-    /** Creates a vehicle
-     * @param $vehicleParams
-     * Returns a vehicle object or failure info.
-     */
-    public function createVehicle($vehicleParams)
-    {
-        $excludeFields = ['vehicle_id', 'is_deleted', 'created_time', 'timestamp_added', 'timestamp_removed'];
-        $allBodyFields = Route4Me::getObjectProperties(new self(), $excludeFields);
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::Vehicles,
-            'method' => 'POST',
-            'body' => Route4Me::generateRequestParameters($allBodyFields, $vehicleParams),
-            'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
-        ]);
-
-        return $response;
-    }
-
-    /** Removes a vehicle by specified vehicle ID.
-     * @param string $vehicleID - Vehicle ID
-     * @return Vehicle object - removed vehicle object.
-     * @throws \Route4Me\Exception\ApiError
-     */
-    public function removeVehicle($vehicleParams)
-    {
-        $vehicleId = $vehicleParams['vehicle_id'];
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::Vehicles . '/' . $vehicleId,
-            'method' => 'DELETE',
-            'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
-        ]);
-
-        return $response;
-    }
-
-    /** Returns the VehiclesPaginated type object containing an array of the vehicles.
-     * @param array $params - an array from the VehicleParameters object.
-     * @return an array of the Vehicle objects.
-     * @throws \Route4Me\Exception\ApiError
-     */
-    public function getVehiclesPaginatedList($params)
-    {
-        $allQueryFields = ['with_pagination', 'page', 'perPage'];
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::Vehicles,
-            'method' => 'GET',
-            'query' => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $response;
-    }
-
-    /** Creates temporary vehicle in the database.
-     * @param $vehicleParams - an array from the VehicleTemporary object.
-     * @return an object of the type VehicleTemporary.
-     * @throws \Route4Me\Exception\ApiError
-     */
-    public function createTemporaryVehicle($vehicleParams)
-    {
-        $excludeFields = [];
-        $allBodyFields = Route4Me::getObjectProperties(new VehicleTemporary(), $excludeFields);
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::VehicleTemporary,
-            'method' => 'POST',
-            'body' => Route4Me::generateRequestParameters($allBodyFields, $vehicleParams),
-            'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
-        ]);
-
-        return $response;
-    }
-
-    /** Execute a vehicle order.
-     * @param $vehicleParams - Vehicle order parameters.
-     * @return an object of the type VehicleOrderResponse
-     * @throws \Route4Me\Exception\ApiError
-     */
-    public function executeVehicleOrder($vehicleParams)
-    {
-        $excludeFields = [];
-        $allBodyFields = Route4Me::getObjectProperties(new VehicleOrderParameters(), $excludeFields);
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::VehicleExecuteOrder,
-            'method' => 'POST',
-            'body' => Route4Me::generateRequestParameters($allBodyFields, $vehicleParams),
-            'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
-        ]);
-
-        return $response;
-    }
-
-    /** Get latest vehicle locations by specified vehicle IDs.
-     * @param $vehicleParams - Vehicle query parameters containing vehicle IDs
-     * @return Data with vehicles
-     * @throws \Route4Me\Exception\ApiError
-     */
-    public function getVehicleLocations($vehicleParams)
-    {
-        $allQueryFields = ['ids'];
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::VehicleLocation,
-            'method' => 'GET',
-            'query' => Route4Me::generateRequestParameters($allQueryFields, $vehicleParams),
-        ]);
-
-        return $response;
-    }
-
-    /** Get the Vehicle by specifying vehicle ID.
-     * @param $vehicleParams - Vehicle query parameters containing vehicle ID.
-     * @return an object of the type Vehicle
-     * @throws \Route4Me\Exception\ApiError
-     */
-    public function getVehicleById($vehicleParams)
-    {
-        $allQueryFields = ['vehicle_id'];
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::Vehicles.'/'.$vehicleParams['vehicle_id'],
-            'method' => 'GET',
-            'query' => null,
-        ]);
-
-        return $response;
-    }
-
-    /** Get the Vehicle track by specifying vehicle ID.
-     * @param $vehicleParams - Vehicle query parameters containing vehicle ID.
-     * @return Vehicle track object
-     * @throws \Route4Me\Exception\ApiError
-     */
-    public function getVehicleTrack($vehicleParams)
-    {
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::Vehicles.'/'.$vehicleParams['vehicle_id'].'/track',
-            'method' => 'GET',
-            'query' => null,
-        ]);
-
-        return $response;
-    }
-
-    public function getVehicleByLicensePlate($vehicleParams)
-    {
-        $allQueryFields = ['vehicle_license_plate'];
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::VehicleLicense,
-            'method' => 'GET',
-            'query' => Route4Me::generateRequestParameters($allQueryFields, $vehicleParams),
-        ]);
-
-        return $response;
-    }
-
-    public function searchVehicles($searchParams)
-    {
-        $excludeFields = [];
-        $allBodyFields = Route4Me::getObjectProperties(new VehicleSearchParameters(), $excludeFields);
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::VehicleSearch,
-            'method' => 'POST',
-            'body' => Route4Me::generateRequestParameters($allBodyFields, $searchParams),
-            'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
-        ]);
-
-        return $response;
-    }
-
-    public function updateVehicle($vehicleParams)
-    {
-        $excludeFields = ['vehicle_id', 'is_deleted', 'created_time', 'timestamp_added', 'timestamp_removed'];
-        $allBodyFields = Route4Me::getObjectProperties(new self(), $excludeFields);
-
-        $response = Route4Me::makeRequst([
-            'url' => Endpoint::Vehicles.'/'.$vehicleParams['vehicle_id'],
-            'method' => 'PATCH',
-            'body' => Route4Me::generateRequestParameters($allBodyFields, $vehicleParams),
-            'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
-        ]);
-
-        return $response;
-    }
+	/** The vehicle ID
+	 * @var string $vehicle_id
+	 */
+	public $vehicle_id;
+
+	/** Member ID assigned to the vehicle.
+	 * @var integer $member_id
+	 */
+	public $member_id;
+
+	/** If true, the vehicle is marked as deleted.
+	 * @var boolean $is_deleted
+	 */
+	public $is_deleted;
+
+	/** Vehicle alias
+	 * @var string $vehicle_alias
+	 */
+	public $vehicle_alias;
+
+	/** Vehicle VIN
+	 * @var string $vehicle_vin
+	 */
+	public $vehicle_vin;
+
+	/** Vehicle registration state ID.
+	 * @var integer $vehicle_reg_state_id
+	 */
+	public $vehicle_reg_state_id;
+
+	/** Vehicle registration country ID.
+	 * @var integer $vehicle_reg_country_id
+	 */
+	public $vehicle_reg_country_id;
+
+	/** A license plate of the vehicle.
+	 * @var string $vehicle_license_plate
+	 */
+	public $vehicle_license_plate;
+
+	/** Vehicle type.
+	 * <para>Availbale values:</para>
+	 * sedan', 'suv', 'pickup_truck', 'van', '18wheeler', 'cabin', 'hatchback',
+	 * '<para>motorcyle', 'waste_disposal', 'tree_cutting', 'bigrig', 'cement_mixer', </para>
+	 * 'livestock_carrier', 'dairy','tractor_trailer'.
+	 * @var string $vehicle_type_id
+	 */
+	public $vehicle_type_id;
+
+	/** When the vehicle was added.
+	 * @var string $timestamp_added
+	 */
+	public $timestamp_added;
+
+	/** Vehicle maker brend.
+	 * <para>Available values:</para>
+	 * "american coleman", "bmw", "chevrolet", "ford", "freightliner", "gmc",
+	 * <para>"hino", "honda", "isuzu", "kenworth", "mack", "mercedes-benz", "mitsubishi", </para>
+	 * "navistar", "nissan", "peterbilt", "renault", "scania", "sterling", "toyota",
+	 * <para>"volvo", "western star" </para>
+	 * </value>"
+	 * @var string $vehicle_make
+	 */
+	public $vehicle_make;
+
+	/** Vehicle model year
+	 * @var integer $vehicle_model_year
+	 */
+	public $vehicle_model_year;
+
+	/** Vehicle model
+	 * @var string $vehicle_model
+	 */
+	public $vehicle_model;
+
+	/** The year, vehicle was acquired
+	 * @var integer $vehicle_year_acquired
+	 */
+	public $vehicle_year_acquired;
+
+	/** A cost of the new vehicle
+	 * @var float $vehicle_cost_new
+	 */
+	public $vehicle_cost_new;
+
+	/** If true, the vehicle was purchased new.
+	 * @var boolean $purchased_new
+	 */
+	public $purchased_new;
+
+	/** Start date of the license
+	 * @var string $license_start_date
+	 */
+	public $license_start_date;
+
+	/** End date of the license
+	 * @var string $license_end_date
+	 */
+	public $license_end_date;
+
+	/** If equal to '1', the vehicle is operational.
+	 * @var boolean $is_operational
+	 */
+	public $is_operational;
+
+	/** A type of the fuel
+	 * @var string $fuel_type
+	 * enum: ['unleaded 87','unleaded 89','unleaded 91','unleaded 93','diesel','electric','hybrid']
+	 */
+	public $fuel_type;
+
+	/** External telematics vehicle IDs
+	 * @var integer $external_telematics_vehicle_ids
+	 */
+	public $external_telematics_vehicle_id;
+
+	/** When the vehcile was marked as deleted.
+	 * @var integer $timestamp_removed
+	 */
+	public $timestamp_removed;
+
+	/** Vehicle profile ID
+	 * @var integer $vehicle_profile_id
+	 */
+	public $vehicle_profile_id;
+
+	/** Fuel consumption city
+	 * @var float $fuel_consumption_city
+	 */
+	public $fuel_consumption_city;
+
+	/** Fuel consumption in the highway area
+	 * @var float $fuel_consumption_highway
+	 */
+	public $fuel_consumption_highway;
+
+	/** Fuel consumption units in the city area (e.g. mi/l)
+	 * @var string $fuel_consumption_city_unit
+	 */
+	public $fuel_consumption_city_unit;
+
+	/** Fuel consumption units in the highway area (e.g. mi/l)
+	 * @var string $fuel_consumption_highway_unit
+	 */
+	public $fuel_consumption_highway_unit;
+
+	/** Miles per gallon in the city area
+	 * @var float $mpg_city
+	 */
+	public $mpg_city;
+
+	/** Miles per gallon in the highway area
+	 * @var float $mpg_highway
+	 */
+	public $mpg_highway;
+
+	/** Fuel consumption UF value in the city area (e.g. '20.01 mi/l')
+	 * @var string $fuel_consumption_city_uf_value
+	 */
+	public $fuel_consumption_city_uf_value;
+
+	/** Fuel consumption UF value in the highway area (e.g. '2,000.01 mpg')
+	 * @var string $fuel_consumption_highway_uf_value
+	 */
+	public $fuel_consumption_highway_uf_value;
+
+	public static function fromArray(array $params)
+	{
+		$vehicle = new self();
+
+		foreach ($params as $key => $value) {
+			if (is_null(Common::getValue($params, $key))) continue;
+			if (property_exists($vehicle, $key)) {
+				$vehicle->$key = $value;
+			}
+		}
+
+		return $vehicle;
+	}
+
+	public function __construct()
+	{
+		Route4Me::setBaseUrl("");
+	}
+
+	/** Creates a vehicle
+	 * @param $vehicleParams
+	 * Returns a vehicle object or failure info.
+	 */
+	public function createVehicle($vehicleParams)
+	{
+		$excludeFields = ['vehicle_id', 'is_deleted', 'created_time', 'timestamp_added', 'timestamp_removed'];
+		$allBodyFields = Route4Me::getObjectProperties(new self(), $excludeFields);
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::Vehicles,
+			'method' => 'POST',
+			'body' => Route4Me::generateRequestParameters($allBodyFields, $vehicleParams),
+			'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
+		]);
+
+		return $response;
+	}
+
+	/** Removes a vehicle by specified vehicle ID.
+	 * @param string $vehicleID - Vehicle ID
+	 * @return Vehicle object - removed vehicle object.
+	 * @throws \Route4Me\Exception\ApiError
+	 */
+	public function removeVehicle($vehicleParams)
+	{
+		$vehicleId = $vehicleParams['vehicle_id'];
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::Vehicles . '/' . $vehicleId,
+			'method' => 'DELETE',
+			'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
+		]);
+
+		return $response;
+	}
+
+	/** Returns the VehiclesPaginated type object containing an array of the vehicles.
+	 * @param array $params - an array from the VehicleParameters object.
+	 * @return an array of the Vehicle objects.
+	 * @throws \Route4Me\Exception\ApiError
+	 */
+	public function getVehiclesPaginatedList($params)
+	{
+		$allQueryFields = ['with_pagination', 'page', 'perPage'];
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::Vehicles,
+			'method' => 'GET',
+			'query' => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $response;
+	}
+
+	/** Creates temporary vehicle in the database.
+	 * @param $vehicleParams - an array from the VehicleTemporary object.
+	 * @return an object of the type VehicleTemporary.
+	 * @throws \Route4Me\Exception\ApiError
+	 */
+	public function createTemporaryVehicle($vehicleParams)
+	{
+		$excludeFields = [];
+		$allBodyFields = Route4Me::getObjectProperties(new VehicleTemporary(), $excludeFields);
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::VehicleTemporary,
+			'method' => 'POST',
+			'body' => Route4Me::generateRequestParameters($allBodyFields, $vehicleParams),
+			'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
+		]);
+
+		return $response;
+	}
+
+	/** Execute a vehicle order.
+	 * @param $vehicleParams - Vehicle order parameters.
+	 * @return an object of the type VehicleOrderResponse
+	 * @throws \Route4Me\Exception\ApiError
+	 */
+	public function executeVehicleOrder($vehicleParams)
+	{
+		$excludeFields = [];
+		$allBodyFields = Route4Me::getObjectProperties(new VehicleOrderParameters(), $excludeFields);
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::VehicleExecuteOrder,
+			'method' => 'POST',
+			'body' => Route4Me::generateRequestParameters($allBodyFields, $vehicleParams),
+			'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
+		]);
+
+		return $response;
+	}
+
+	/** Get latest vehicle locations by specified vehicle IDs.
+	 * @param $vehicleParams - Vehicle query parameters containing vehicle IDs
+	 * @return Data with vehicles
+	 * @throws \Route4Me\Exception\ApiError
+	 */
+	public function getVehicleLocations($vehicleParams)
+	{
+		$allQueryFields = ['ids'];
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::VehicleLocation,
+			'method' => 'GET',
+			'query' => Route4Me::generateRequestParameters($allQueryFields, $vehicleParams),
+		]);
+
+		return $response;
+	}
+
+	/** Get the Vehicle by specifying vehicle ID.
+	 * @param $vehicleParams - Vehicle query parameters containing vehicle ID.
+	 * @return an object of the type Vehicle
+	 * @throws \Route4Me\Exception\ApiError
+	 */
+	public function getVehicleById($vehicleParams)
+	{
+		$allQueryFields = ['vehicle_id'];
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::Vehicles.'/'.$vehicleParams['vehicle_id'],
+			'method' => 'GET',
+			'query' => null,
+		]);
+
+		return $response;
+	}
+
+	/** Get the Vehicle track by specifying vehicle ID.
+	 * @param $vehicleParams - Vehicle query parameters containing vehicle ID.
+	 * @return Vehicle track object
+	 * @throws \Route4Me\Exception\ApiError
+	 */
+	public function getVehicleTrack($vehicleParams)
+	{
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::Vehicles.'/'.$vehicleParams['vehicle_id'].'/track',
+			'method' => 'GET',
+			'query' => null,
+		]);
+
+		return $response;
+	}
+
+	public function getVehicleByLicensePlate($vehicleParams)
+	{
+		$allQueryFields = ['vehicle_license_plate'];
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::VehicleLicense,
+			'method' => 'GET',
+			'query' => Route4Me::generateRequestParameters($allQueryFields, $vehicleParams),
+		]);
+
+		return $response;
+	}
+
+	public function searchVehicles($searchParams)
+	{
+		$excludeFields = [];
+		$allBodyFields = Route4Me::getObjectProperties(new VehicleSearchParameters(), $excludeFields);
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::VehicleSearch,
+			'method' => 'POST',
+			'body' => Route4Me::generateRequestParameters($allBodyFields, $searchParams),
+			'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
+		]);
+
+		return $response;
+	}
+
+	public function updateVehicle($vehicleParams)
+	{
+		$excludeFields = ['vehicle_id', 'is_deleted', 'created_time', 'timestamp_added', 'timestamp_removed'];
+		$allBodyFields = Route4Me::getObjectProperties(new self(), $excludeFields);
+
+		$response = Route4Me::makeRequst([
+			'url' => Endpoint::Vehicles.'/'.$vehicleParams['vehicle_id'],
+			'method' => 'PATCH',
+			'body' => Route4Me::generateRequestParameters($allBodyFields, $vehicleParams),
+			'HTTPHEADER' => Constants::DEFAULT_HTTP_HEADER,
+		]);
+
+		return $response;
+	}
 }
\ No newline at end of file

src/Route4Me/V5/AccountProfile.php

Indentation +35 added lines, -35 removed lines

@@ -9,46 +9,46 @@
  */
 class AccountProfile extends Common
 {
-    /**
-     * Account profile email
-     * @var type string
-     */
-    public $email;
+	/**
+	 * Account profile email
+	 * @var type string
+	 */
+	public $email;
     
-    /**
-     * Account member ID
-     * @var type integer
-     */
-    public $member_id;
+	/**
+	 * Account member ID
+	 * @var type integer
+	 */
+	public $member_id;
     
-    /**
-     * Account API key
-     * @var type string
-     */
-    public $api_key;
+	/**
+	 * Account API key
+	 * @var type string
+	 */
+	public $api_key;
     
-    /**
-     * Account root member ID
-     * @var type integer
-     */
-    public $root_member_id;
+	/**
+	 * Account root member ID
+	 * @var type integer
+	 */
+	public $root_member_id;
     
-    /**
-     * Preferred units of the account.
-     * @var type string
-     */
-    public $preferred_units;
+	/**
+	 * Preferred units of the account.
+	 * @var type string
+	 */
+	public $preferred_units;
     
-    public static function fromArray(array $params)
-    {
-        $thisParams = new self();
+	public static function fromArray(array $params)
+	{
+		$thisParams = new self();
 
-        foreach ($params as $key => $value) {
-            if (property_exists($thisParams, $key)) {
-                $thisParams->{$key} = $value;
-            }
-        }
+		foreach ($params as $key => $value) {
+			if (property_exists($thisParams, $key)) {
+				$thisParams->{$key} = $value;
+			}
+		}
 
-        return $thisParams;
-    }
+		return $thisParams;
+	}
 }

src/Route4Me/V5/TelematicsVendorFeature.php

Indentation +14 added lines, -14 removed lines

@@ -9,10 +9,10 @@ 
  */
 class TelematicsVendorFeature extends Common
 {
-    /**
-     * Feature ID
-     * @var type string
-     */
+	/**
+	 * Feature ID
+	 * @var type string
+	 */
    public $id;
    
    /**
@@ -33,16 +33,16 @@ 
     */
    public $feature_group;
 
-    public static function fromArray(array $params)
-    {
-        $thisParams = new self();
+	public static function fromArray(array $params)
+	{
+		$thisParams = new self();
 
-        foreach ($params as $key => $value) {
-            if (property_exists($thisParams, $key)) {
-                $thisParams->{$key} = $value;
-            }
-        }
+		foreach ($params as $key => $value) {
+			if (property_exists($thisParams, $key)) {
+				$thisParams->{$key} = $value;
+			}
+		}
 
-        return $thisParams;
-    }
+		return $thisParams;
+	}
 }

src/Route4Me/V5/DataObjectBase.php

Indentation +29 added lines, -29 removed lines

@@ -6,33 +6,33 @@
 
 class DataObjectBase extends \Route4Me\Common
 {
-    /** @var string $optimization_problem_id
-     * Optimization problem ID
-     */
-    public $optimization_problem_id;
-
-    /** @var string $smart_optimization_id
-     * Smart Optimization Problem ID
-     */
-    public $smart_optimization_id;
-
-    /** @var long $created_timestamp
-     * When the optimization problem was created.
-     */
-    public $created_timestamp;
-
-    /** @var RouteParameters $parameters
-     * Route Parameters.
-     */
-    public $parameters = [];
-
-    /** @var Address[] $addresses
-     * An array ot the Address type objects.
-     */
-    public $addresses = [];
-
-    /** @var string[] $links
-     * The links to the GET operations for the optimization problem.
-     */
-    public $links = [];
+	/** @var string $optimization_problem_id
+	 * Optimization problem ID
+	 */
+	public $optimization_problem_id;
+
+	/** @var string $smart_optimization_id
+	 * Smart Optimization Problem ID
+	 */
+	public $smart_optimization_id;
+
+	/** @var long $created_timestamp
+	 * When the optimization problem was created.
+	 */
+	public $created_timestamp;
+
+	/** @var RouteParameters $parameters
+	 * Route Parameters.
+	 */
+	public $parameters = [];
+
+	/** @var Address[] $addresses
+	 * An array ot the Address type objects.
+	 */
+	public $addresses = [];
+
+	/** @var string[] $links
+	 * The links to the GET operations for the optimization problem.
+	 */
+	public $links = [];
 }
\ No newline at end of file

src/Route4Me/ScheduleCalendarParameters.php

Indentation +97 added lines, -97 removed lines

@@ -9,101 +9,101 @@
  */
 class ScheduleCalendarParameters extends Common
 {
-    /**
-     * Start date to filter the schedules in the string format<br>
-     * (e.g. 2020-10-27).
-     * @var string
-     */
-    public $date_from_string;
-
-    /**
-     * End date to filter the schedules in the string format<br>
-     * (e.g. 2020-10-30).
-     * @var string
-     */
-    public $date_to_string;
-
-    /**
-     * Member ID
-     * @var integer
-     */
-    public $member_id;
-
-    /**
-     * Timezone offset (in minutes)<br>
-     * (e.g. NYT: -4*60 = -480, Kiev: 3*60 = 180).
-     * @var integer
-     */
-    public $timezone_offset_minutes;
-
-    /**
-     * If true, the scheduled orders are included in the calendar.
-     * @var Boolean
-     */
-    public $orders;
-
-    /**
-     * If true, the scheduled address book contacts
-     * are included in the calendar.
-     * @var Boolean
-     */
-    public $ab;
-
-    /**
-     * If true, the scheduled routes are included in the calendar.
-     * @var Boolean
-     */
-    public $routes_count;
-
-    /**
-     * Class constructor.
-     * @var
-     */
-    public function __construct()
-    {
-        Route4Me::setBaseUrl(Endpoint::BASE_URL);
-    }
-
-    /**
-     * Convert an array to this object
-     */
-    public static function fromArray(array $params)
-    {
-        $scheduleCalendarParameters = new self();
-
-        foreach ($params as $key => $value) {
-            if (property_exists($scheduleCalendarParameters, $key)) {
-                $scheduleCalendarParameters->{$key} = $value;
-            }
-        }
-
-        return $scheduleCalendarParameters;
-    }
-
-    public function setTimezoneOffsetMinutes($tz)
-    {
-        $this->timezone_offset_minutes = -$tz;
-    }
-
-    public function getTimezoneOffsetMinutes()
-    {
-        if (is_numeric($this->timezone_offset_minutes)) {
-            return -$this->timezone_offset_minutes;
-        } else {
-            return 0;
-        }
-    }
-
-    public function getScheduleCalendar($params)
-    {
-        $allQueryFields = ['date_from_string', 'date_to_string', 'member_id', 'timezone_offset_minutes', 'orders', 'ab', 'routes_count'];
-
-        $schedCalendar = Route4Me::makeRequst([
-            'url'       => Endpoint::SCHEDULE_CALENDAR,
-            'method'    => 'GET',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $schedCalendar;
-    }
+	/**
+	 * Start date to filter the schedules in the string format<br>
+	 * (e.g. 2020-10-27).
+	 * @var string
+	 */
+	public $date_from_string;
+
+	/**
+	 * End date to filter the schedules in the string format<br>
+	 * (e.g. 2020-10-30).
+	 * @var string
+	 */
+	public $date_to_string;
+
+	/**
+	 * Member ID
+	 * @var integer
+	 */
+	public $member_id;
+
+	/**
+	 * Timezone offset (in minutes)<br>
+	 * (e.g. NYT: -4*60 = -480, Kiev: 3*60 = 180).
+	 * @var integer
+	 */
+	public $timezone_offset_minutes;
+
+	/**
+	 * If true, the scheduled orders are included in the calendar.
+	 * @var Boolean
+	 */
+	public $orders;
+
+	/**
+	 * If true, the scheduled address book contacts
+	 * are included in the calendar.
+	 * @var Boolean
+	 */
+	public $ab;
+
+	/**
+	 * If true, the scheduled routes are included in the calendar.
+	 * @var Boolean
+	 */
+	public $routes_count;
+
+	/**
+	 * Class constructor.
+	 * @var
+	 */
+	public function __construct()
+	{
+		Route4Me::setBaseUrl(Endpoint::BASE_URL);
+	}
+
+	/**
+	 * Convert an array to this object
+	 */
+	public static function fromArray(array $params)
+	{
+		$scheduleCalendarParameters = new self();
+
+		foreach ($params as $key => $value) {
+			if (property_exists($scheduleCalendarParameters, $key)) {
+				$scheduleCalendarParameters->{$key} = $value;
+			}
+		}
+
+		return $scheduleCalendarParameters;
+	}
+
+	public function setTimezoneOffsetMinutes($tz)
+	{
+		$this->timezone_offset_minutes = -$tz;
+	}
+
+	public function getTimezoneOffsetMinutes()
+	{
+		if (is_numeric($this->timezone_offset_minutes)) {
+			return -$this->timezone_offset_minutes;
+		} else {
+			return 0;
+		}
+	}
+
+	public function getScheduleCalendar($params)
+	{
+		$allQueryFields = ['date_from_string', 'date_to_string', 'member_id', 'timezone_offset_minutes', 'orders', 'ab', 'routes_count'];
+
+		$schedCalendar = Route4Me::makeRequst([
+			'url'       => Endpoint::SCHEDULE_CALENDAR,
+			'method'    => 'GET',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $schedCalendar;
+	}
 }
\ No newline at end of file

src/Route4Me/OptimizationProblemParams.php

Indentation +127 added lines, -127 removed lines

@@ -6,131 +6,131 @@
 
 class OptimizationProblemParams extends Common
 {
-    public $optimization_problem_id;
-    public $reoptimize;
-    public $addresses = [];
-    public $depots = [];
-    public $parameters;
-    public $directions;
-    public $format;
-    public $route_path_output;
-    public $optimized_callback_url;
-    public $redirect = true;
-
-    public static function fromArray($params)
-    {
-        $param = new self();
-        if (!isset($params['addresses'])) {
-            throw new BadParam('addresses must be provided.');
-        }
-
-        if (!isset($params['parameters'])) {
-            throw new BadParam('parameters must be provided.');
-        }
-
-        if ($params['parameters'] instanceof RouteParameters) {
-            $param->setParameters($params['parameters']);
-        } else {
-            $param->setParameters(RouteParameters::fromArray($params['parameters']));
-        }
-
-        foreach ($params['addresses'] as $address) {
-            if (!($address instanceof Address)) {
-                $address = Address::fromArray($address);
-            }
-
-            $param->addAddress($address);
-        }
-
-        if (isset($params['depots'] )) {
-            foreach ($params['depots'] as $depot) {
-                if (!($depot instanceof Address)) {
-                    $depot = Address::fromArray($depot);
-                }
-
-                $param->addAddress($address);
-            }
-        }
-
-        $param->directions = self::getValue($params, 'directions');
-        $param->format = self::getValue($params, 'format');
-        $param->route_path_output = self::getValue($params, 'route_path_output');
-        $param->optimized_callback_url = self::getValue($params, 'optimized_callback_url');
-        $param->optimization_problem_id = self::getValue($params, 'optimization_problem_id');
-        $param->reoptimize = self::getValue($params, 'reoptimize');
-        $param->redirect = filter_var(self::getValue($params, 'redirect', true), FILTER_VALIDATE_BOOLEAN);
-
-        return $param;
-    }
-
-    public function __construct()
-    {
-        $this->parameters = new RouteParameters();
-    }
-
-    public function setParameters(RouteParameters $params)
-    {
-        $this->parameters = $params;
-
-        return $this;
-    }
-
-    public function addAddress(Address $address)
-    {
-        $this->addresses[] = $address;
-
-        return $this;
-    }
-
-    public function addDepot(Address $depot)
-    {
-        $this->depots[] = $depot;
-
-        return $this;
-    }
-
-    public function getAddressesArray()
-    {
-        $addresses = [];
-
-        foreach ($this->addresses as $address) {
-            $addresses[] = $address->toArray();
-        }
-
-        return $addresses;
-    }
-
-    public function getDepotsArray()
-    {
-        $depots = [];
-
-        foreach ($this->depots as $depot) {
-            $depots[] = $depot->toArray();
-        }
-
-        return $depots;
-    }
-
-    public function getParametersArray()
-    {
-        return $this->parameters->toArray();
-    }
-
-    public function setAddresses(array $addresses)
-    {
-        foreach ($addresses as $address) {
-            $this->addAddress($address);
-        }
-
-        return $this;
-    }
-
-    public function setDepots(array $depots)
-    {
-        foreach ($depots as $depot) {
-            $this->addDepot($depot);
-        }
-
-        return $this;
-    }
+	public $optimization_problem_id;
+	public $reoptimize;
+	public $addresses = [];
+	public $depots = [];
+	public $parameters;
+	public $directions;
+	public $format;
+	public $route_path_output;
+	public $optimized_callback_url;
+	public $redirect = true;
+
+	public static function fromArray($params)
+	{
+		$param = new self();
+		if (!isset($params['addresses'])) {
+			throw new BadParam('addresses must be provided.');
+		}
+
+		if (!isset($params['parameters'])) {
+			throw new BadParam('parameters must be provided.');
+		}
+
+		if ($params['parameters'] instanceof RouteParameters) {
+			$param->setParameters($params['parameters']);
+		} else {
+			$param->setParameters(RouteParameters::fromArray($params['parameters']));
+		}
+
+		foreach ($params['addresses'] as $address) {
+			if (!($address instanceof Address)) {
+				$address = Address::fromArray($address);
+			}
+
+			$param->addAddress($address);
+		}
+
+		if (isset($params['depots'] )) {
+			foreach ($params['depots'] as $depot) {
+				if (!($depot instanceof Address)) {
+					$depot = Address::fromArray($depot);
+				}
+
+				$param->addAddress($address);
+			}
+		}
+
+		$param->directions = self::getValue($params, 'directions');
+		$param->format = self::getValue($params, 'format');
+		$param->route_path_output = self::getValue($params, 'route_path_output');
+		$param->optimized_callback_url = self::getValue($params, 'optimized_callback_url');
+		$param->optimization_problem_id = self::getValue($params, 'optimization_problem_id');
+		$param->reoptimize = self::getValue($params, 'reoptimize');
+		$param->redirect = filter_var(self::getValue($params, 'redirect', true), FILTER_VALIDATE_BOOLEAN);
+
+		return $param;
+	}
+
+	public function __construct()
+	{
+		$this->parameters = new RouteParameters();
+	}
+
+	public function setParameters(RouteParameters $params)
+	{
+		$this->parameters = $params;
+
+		return $this;
+	}
+
+	public function addAddress(Address $address)
+	{
+		$this->addresses[] = $address;
+
+		return $this;
+	}
+
+	public function addDepot(Address $depot)
+	{
+		$this->depots[] = $depot;
+
+		return $this;
+	}
+
+	public function getAddressesArray()
+	{
+		$addresses = [];
+
+		foreach ($this->addresses as $address) {
+			$addresses[] = $address->toArray();
+		}
+
+		return $addresses;
+	}
+
+	public function getDepotsArray()
+	{
+		$depots = [];
+
+		foreach ($this->depots as $depot) {
+			$depots[] = $depot->toArray();
+		}
+
+		return $depots;
+	}
+
+	public function getParametersArray()
+	{
+		return $this->parameters->toArray();
+	}
+
+	public function setAddresses(array $addresses)
+	{
+		foreach ($addresses as $address) {
+			$this->addAddress($address);
+		}
+
+		return $this;
+	}
+
+	public function setDepots(array $depots)
+	{
+		foreach ($depots as $depot) {
+			$this->addDepot($depot);
+		}
+
+		return $this;
+	}
 }

src/Route4Me/DirectionLocation.php

Indentation +45 added lines, -45 removed lines

@@ -11,58 +11,58 @@
  */
 class DirectionLocation extends Common
 {
-    /**
-     * Direction name
-     * @var string
-     */
-    public $name;
+	/**
+	 * Direction name
+	 * @var string
+	 */
+	public $name;
 
-    /**
-     * Required time for passing the segment (seconds)
-     * @var integer
-     */
-    public $time;
+	/**
+	 * Required time for passing the segment (seconds)
+	 * @var integer
+	 */
+	public $time;
 
-    /**
-     * Segment distance
-     * @var double
-     */
-    public $segment_distance;
+	/**
+	 * Segment distance
+	 * @var double
+	 */
+	public $segment_distance;
 
-    /**
-     * Start Location
-     * @var string
-     */
-    public $start_location;
+	/**
+	 * Start Location
+	 * @var string
+	 */
+	public $start_location;
 
-    /**
-     * End Location
-     * @var string
-     */
-    public $end_location;
+	/**
+	 * End Location
+	 * @var string
+	 */
+	public $end_location;
 
-    /**
-     * Directions Error
-     * @var string
-     */
-    public $directions_error;
+	/**
+	 * Directions Error
+	 * @var string
+	 */
+	public $directions_error;
 
-    /**
-     * Error Code
-     * @var integer
-     */
-    public $error_code;
+	/**
+	 * Error Code
+	 * @var integer
+	 */
+	public $error_code;
 
-    public static function fromArray(array $params)
-    {
-        $thisParams = new self();
+	public static function fromArray(array $params)
+	{
+		$thisParams = new self();
 
-        foreach ($params as $key => $value) {
-            if (property_exists($thisParams, $key)) {
-                $thisParams->{$key} = $value;
-            }
-        }
+		foreach ($params as $key => $value) {
+			if (property_exists($thisParams, $key)) {
+				$thisParams->{$key} = $value;
+			}
+		}
 
-        return $thisParams;
-    }
+		return $thisParams;
+	}
 }
\ No newline at end of file

src/Route4Me/Common.php

Indentation +11 added lines, -11 removed lines

@@ -4,17 +4,17 @@
 
 class Common
 {
-    public static function getValue($array, $item, $default = null)
-    {
-        return (isset($array[$item])) ? $array[$item] : $default;
-    }
+	public static function getValue($array, $item, $default = null)
+	{
+		return (isset($array[$item])) ? $array[$item] : $default;
+	}
 
-    public function toArray()
-    {
-        $params = array_filter(get_object_vars($this), function ($item) {
-            return (null !== $item) && !(is_array($item) && !count($item));
-        });
+	public function toArray()
+	{
+		$params = array_filter(get_object_vars($this), function ($item) {
+			return (null !== $item) && !(is_array($item) && !count($item));
+		});
 
-        return $params;
-    }
+		return $params;
+	}
 }

src/Route4Me/Route.php

Indentation +805 added lines, -805 removed lines

@@ -12,809 +12,809 @@
  */
 class Route extends Common
 {
-    /**
-     * The route ID
-     * @var string
-     */
-    public $route_id;
-
-    /**
-     * Member ID of a route owner
-     * @var integer
-     */
-    public $member_id;
-
-    /**
-     * Optimization problem ID
-     * @var string
-     */
-    public $optimization_problem_id;
-
-    /**
-     * Vehicle alias
-     * @var string
-     */
-    public $vehicle_alias;
-
-    /**
-     * Driver alias
-     * @var string
-     */
-    public $driver_alias;
-
-    /**
-     * Total route's trip distance
-     * @var double
-     */
-    public $trip_distance;
-
-    /**
-     * The UDU distance measurement unit for the route.<br>
-     * @note km or mi, the route4me api will convert all distance measurements into these units.
-     * @var string
-     */
-    public $udu_distance_unit;
-
-    /**
-     * Total route's UDU trip distance
-     * @var double
-     */
-    public $udu_trip_distance;
-
-    /** Miles per gallon
-     * @var double
-     */
-    public $mpg;
-
-    /**
-     * Gas price
-     * @var double
-     */
-    public $gas_price;
-
-    /**
-     * Total route duration (seconds)
-     * @var integer
-     */
-    public $route_duration_sec;
-
-    /**
-     * Number of the destinations in the route.
-     * @var integer
-     */
-    public $destination_count;
-
-    /**
-     * Notes count in the route.
-     * @var integer
-     */
-    public $notes_count;
-
-    /**
-     * Route parameters
-     * @var RouteParameters
-     */
-    public $parameters;
-
-    /**
-     * An array of the route addresses
-     * @var Address[]
-     */
-    public $addresses = [];
-
-    /**
-     * An array of the links
-     * @var string[]
-     */
-    public $links = [];
-
-    /**
-     * Edge by edge turn-by-turn directions.
-     * @var Direction[]
-     */
-    public $directions = [];
-
-    /**
-     * Edge-wise path to be drawn on the map.
-     * @var GeoPoint[]
-     */
-    public $path = [];
-
-    /**
-     * A collection of device tracking data with coordinates, speed, and timestamps.
-     * @var Tracking\TrackingHistory[]
-     */
-    public $tracking_history = [];
-
-    /**
-     * HTTP headers
-     * @var string
-     */
-    public $httpheaders;
-
-    /**
-     * If true, the route is unrouted.
-     * @var Boolean
-     */
-    public $is_unrouted;
-
-    /**
-     * User route rating [0, 5]. A null value means no rating was given.<br>
-     * Users can rate routes so that future optimizations take these ratings into account.
-     * @var integer
-     */
-    public $user_route_rating;
-
-    /**
-     * The member's email
-     * @var string
-     */
-    public $member_email;
-
-    /**
-     * URL to a member picture
-     * @var string
-     */
-    public $member_picture;
-
-    /**
-     * Member tracking subheadline.
-     * @var string
-     */
-    public $member_tracking_subheadline;
-
-    /**
-     * If true, the order is approved for execution.
-     * @var Boolean
-     */
-    public $approved_for_execution;
-
-    /**
-     * Counter of the approved revisions.
-     * @var integer
-     */
-    public $approved_revisions_counter;
-
-    /**
-     * The member's first name.
-     * @var string
-     */
-    public $member_first_name;
-
-    /**
-     * The member's last name.
-     * @var string
-     */
-    public $member_last_name;
-
-    /**
-     * Channel name
-     * @var string
-     */
-    public $channel_name;
-
-    /**
-     * Total cost of the route.
-     * @var double
-     */
-    public $route_cost;
-
-    /**
-     * Total route revenue
-     * @var double
-     */
-    public $route_revenue;
-
-    /**
-     * Net revenue per distance unit.
-     * @var double
-     */
-    public $net_revenue_per_distance_unit;
-
-    /**
-     * When route created (UNIX format timestamp).
-     * @var integer
-     */
-    public $created_timestamp;
-
-    /**
-     * Planned total route duration (seconds).
-     * @var integer
-     */
-    public $planned_total_route_duration;
-
-    /**
-     * Total wait time (seconds).
-     * @var integer
-     */
-    public $total_wait_time;
-
-    /**
-     * UDU Actual travel distance.
-     * @var double
-     */
-    public $udu_actual_travel_distance;
-
-    /**
-     * Actual travel distance.
-     * @var double
-     */
-    public $actual_travel_distance;
-
-    /**
-     * Actual travel time (seconds).
-     * @var integer
-     */
-    public $actual_travel_time;
-
-    /**
-     * Actual footsteps.
-     * @var integer
-     */
-    public $actual_footsteps;
-
-    /**
-     * Working time.
-     * @var integer
-     */
-    public $working_time;
-
-    /**
-     * Driving time.
-     * @var integer
-     */
-    public $driving_time;
-
-    /**
-     * Idling time.
-     * @var integer
-     */
-    public $idling_time;
-
-    /**
-     * Paying miles
-     * @var double
-     */
-    public $paying_miles;
-
-    /**
-     * Geofence polygon type.<br>
-     * enum: ["circle", "poly", "rect"]
-     * @var string
-     */
-    public $geofence_polygon_type;
-
-    /**
-     * Geofence polygon size.
-     * @var integer
-     */
-    public $geofence_polygon_size;
-
-    /**
-     * Route notes
-     * @var AddressNote[]
-     */
-    public $notes=[];
-
-    /**
-     * A vehicle assigned to the route.
-     * @var Vehicles\VehicleResponseV4
-     */
-    public $vehicle=[];
-
-    /**
-     * Member config key-value pairs.
-     * @var array
-     */
-    public $member_config_storage;
-
-    /**
-     * Original route
-     * @var Route
-     */
-    public $original_route;
-
-    /**
-     * If true, the route will be unlinked from the master optimization.
-     * @var Boolean
-     */
-    public $unlink_from_master_optimization;
-
-    public function __construct()
-    {
-        Route4Me::setBaseUrl(Endpoint::BASE_URL);
-    }
-
-    public static function fromArray(array $params)
-    {
-        $route = new self();
-        $route->route_id = Common::getValue($params, 'route_id');
-        $route->member_id = Common::getValue($params, 'member_id');
-        $route->member_email = Common::getValue($params, 'member_email');
-        $route->member_picture = Common::getValue($params, 'member_picture');
-        $route->member_tracking_subheadline = Common::getValue($params, 'member_tracking_subheadline');
-        $route->approved_for_execution = Common::getValue($params, 'approved_for_execution');
-        $route->approved_revisions_counter = Common::getValue($params, 'approved_revisions_counter');
-        $route->member_first_name = Common::getValue($params, 'member_first_name');
-        $route->member_last_name = Common::getValue($params, 'member_last_name');
-        $route->channel_name = Common::getValue($params, 'channel_name');
-        $route->optimization_problem_id = Common::getValue($params, 'optimization_problem_id');
-        $route->user_route_rating = Common::getValue($params, 'user_route_rating');
-        $route->vehicle_alias = Common::getValue($params, 'vehicle_alias');
-        $route->driver_alias = Common::getValue($params, 'driver_alias');
-        $route->trip_distance = Common::getValue($params, 'trip_distance');
-        $route->udu_distance_unit = Common::getValue($params, 'udu_distance_unit');
-        $route->udu_trip_distance = Common::getValue($params, 'udu_trip_distance');
-        $route->mpg = Common::getValue($params, 'mpg');
-        $route->gas_price = Common::getValue($params, 'gas_price');
-        $route->route_duration_sec = Common::getvalue($params, 'route_duration_sec');
-        $route->planned_total_route_duration = Common::getvalue($params, 'planned_total_route_duration');
-        $route->total_wait_time = Common::getvalue($params, 'total_wait_time');
-        $route->udu_actual_travel_distance = Common::getvalue($params, 'udu_actual_travel_distance');
-        $route->actual_travel_distance = Common::getvalue($params, 'actual_travel_distance');
-        $route->actual_travel_time = Common::getvalue($params, 'actual_travel_time');
-        $route->actual_footsteps = Common::getvalue($params, 'actual_footsteps');
-        $route->working_time = Common::getvalue($params, 'working_time');
-        $route->driving_time = Common::getvalue($params, 'driving_time');
-        $route->idling_time = Common::getvalue($params, 'idling_time');
-        $route->paying_miles = Common::getvalue($params, 'paying_miles');
-        $route->geofence_polygon_type = Common::getvalue($params, 'geofence_polygon_type');
-        $route->geofence_polygon_size = Common::getvalue($params, 'geofence_polygon_size');
-        $route->destination_count = Common::getvalue($params, 'destination_count');
-        $route->notes_count = Common::getvalue($params, 'notes_count');
-        $route->is_unrouted = Common::getvalue($params, 'is_unrouted');
-        $route->route_cost = Common::getvalue($params, 'route_cost');
-        $route->route_revenue = Common::getvalue($params, 'route_revenue');
-        $route->net_revenue_per_distance_unit = Common::getvalue($params, 'net_revenue_per_distance_unit');
-        $route->created_timestamp = Common::getvalue($params, 'created_timestamp');
-
-        if (isset($params['vehicle'])) {
-            $route->vehicle = new Vehicle();
-            $route->vehicle = Vehicle::fromArray($params['vehicle']);
-            Route4Me::setBaseUrl(Endpoint::BASE_URL);
-        };
-
-        $route->member_config_storage = Common::getvalue($params, 'member_config_storage');
-
-        // Make RouteParameters
-        if (isset($params['parameters'])) {
-            $route->parameters = new RouteParameters();
-            $route->parameters = RouteParameters::fromArray($params['parameters']);
-            Route4Me::setBaseUrl(Endpoint::BASE_URL);
-        }
-
-        if (isset($params['addresses'])) {
-            $addresses = [];
-
-            foreach ($params['addresses'] as $address) {
-                $addresses[] = Address::fromArray($address);
-            }
-
-            $route->addresses = $addresses;
-        }
-
-        $route->links = Common::getValue($params, 'links', []);
-        $route->notes = Common::getValue($params, 'notes', []);
-        $route->directions = Common::getValue($params, 'directions', []);
-        $route->path = Common::getValue($params, 'path', []);
-        $route->tracking_history = Common::getValue($params, 'tracking_history', []);
-
-        if (isset($params['original_route'])) {
-            $route->original_route = Route::fromArray($params['original_route']);
-        };
-
-        return $route;
-    }
-
-    /**
-     * @param RouteParametersQuery $params
-     * @return An array of the routes
-     * @throws Exception\ApiError
-     */
-    public static function getRoutes($params = null)
-    {
-        $allQueryFields = ['route_id', 'original', 'route_path_output', 'query', 'directions', 'device_tracking_history', 'limit', 'offset','start_date','end_date'];
-
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::ROUTE_V4,
-            'method'    => 'GET',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        if (isset($params['route_id'])) {
-            if (strlen($params['route_id'])==32) {
-                return self::fromArray($result);
-            } else {
-                return $result;
-            }
-        } else {
-            $routes = [];
-            foreach ($result as $route) {
-                $routes[] = self::fromArray($route);
-            }
-
-            return $routes;
-        }
-    }
-
-    public function getRoutePoints($params)
-    {
-        $allQueryFields = ['route_id', 'route_path_output', 'compress_path_points', 'directions'];
-
-        $result = Route4Me::makeRequst([
-            'url'    => Endpoint::ROUTE_V4,
-            'method' => 'GET',
-            'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $result;
-    }
-
-    public function duplicateRoute($routeIDs)
-    {
-        $result = Route4Me::makeRequst([
-            'url'    => Endpoint::ROUTE_V4,
-            'method' => 'POST',
-            'body'   => [
-                'duplicate_routes_id' => $routeIDs
-            ],
-        ]);
-
-        return $result;
-    }
-
-    public function resequenceRoute($params)
-    {
-        $allQueryFields = ['route_id', 'route_destination_id'];
-        $allBodyFields = ['addresses'];
-
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::ROUTE_V4,
-            'method'    => 'PUT',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'      => Route4Me::generateRequestParameters($allBodyFields, $params),
-        ]);
-
-        return $result;
-    }
-
-    /**
-     * @deprecated 'The method is obsolete, use the method ReoptimizeRoute instead.'
-     * @param $params
-     * @return mixed|string
-     */
-    public function resequenceAllAddresses($params)
-    {
-        $allQueryFields = ['route_id', 'disable_optimization', 'optimize'];
-
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::REOPTIMIZE_V3_2,
-            'method'    => 'GET',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $result;
-    }
-
-    /**
-     * Reoptimize a route
-     * @param $params type Route
-     * @return mixed|string
-     * @throws Exception\ApiError
-     */
-    public function reoptimizeRoute($params)
-    {
-        $allQueryFields = ['route_id', 'reoptimize', 'remaining', 'device_type'];
-
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::ROUTE_V4,
-            'method'    => 'PUT',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $result;
-    }
-
-    /**
-     * Merges the routes
-     * @param $params array contains:
-     * @param route_ids IDs of the routes to be merged.
-     * @param depot_address a depot address of the merged route.
-     * @param remove_origin if true, the origin routes will be removed.
-     * @param depot_lat the depot's latitude
-     * @param depot_lng the depot's longitude
-     * @return Status response
-     * @throws Exception\ApiError
-     */
-    public function mergeRoutes($params)
-    {
-        $allBodyFields = ['route_ids', 'depot_address', 'remove_origin', 'depot_lat',  'depot_lng'];
-
-        $result = Route4Me::makeRequst([
-            'url'           => Endpoint::ROUTES_MERGE,
-            'method'        => 'POST',
-            'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
-            'HTTPHEADER'    => 'Content-Type: multipart/form-data',
-        ]);
-
-        return $result;
-    }
-
-    /**
-     * Share a route by an email
-     * @param $params RouteParametersQuery contains:
-     * @param route_id a route ID to be shared.
-     * @param response_format the response format.
-     * @param recipient_email Recipient email.
-     * @return Status response
-     * @throws Exception\ApiError
-     */
-    public function shareRoute($params)
-    {
-        $allQueryFields = ['route_id', 'response_format'];
-        $allBodyFields = ['recipient_email'];
-
-        $result = Route4Me::makeRequst([
-            'url'           => Endpoint::ROUTE_SHARE,
-            'method'        => 'POST',
-            'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
-            'HTTPHEADER'    => 'Content-Type: multipart/form-data',
-        ]);
-
-        return $result;
-    }
-
-    /**
-     * Returns random route_id from existing routes between $offset and $offset+$limit
-     * @param $offset integer The page number for route listing pagination.
-     * @param $limit integer The maximum number of the returned routes.
-     * @return string random route ID
-     * @throws Exception\ApiError
-     */
-    public function getRandomRouteId($offset, $limit)
-    {
-        $params = [
-            'offset'    => !is_null($offset) ? $offset : 0,
-            'limit'     => !is_null($limit) ? $limit : 30,
-        ];
-
-        $route = new self();
-        $routes = $route->getRoutes($params);
-
-        if (is_null($routes) || sizeof($routes) < 1) {
-            echo '<br> There are no routes in the account. Please, create the routes first. <br>';
-
-            return null;
-        }
-
-        $randomIndex = rand(0, sizeof($routes) - 1);
-
-        return $routes[$randomIndex]->route_id;
-    }
-
-    /**
-     * Update a route
-     * @param $params array contains:
-     * @param route_id string : route ID
-     * @param reoptimize int : if equal to 1 the route re-optimized.
-     * @param route_destination_id int : route destination ID
-     * @param addresses Address[] : an array of a route addresses.
-     * @param parameters RouteParameters : route parameters.
-     * @param unlink_from_master_optimization  Boolean : if true, the route will be unlinked from optimization.
-     * @return Route updated route
-     * @throws Exception\ApiError
-     */
-    public function updateRoute($params)
-    {
-        $allQueryFields = ['route_id', 'reoptimize','route_destination_id'];
-        $allBodyFields = ['addresses', 'parameters', 'unlink_from_master_optimization'];
-
-        $result = Route4Me::makeRequst([
-            'url'       => Endpoint::ROUTE_V4,
-            'method'    => 'PUT',
-            'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'      => (isset($params['addresses']) || isset($params['parameters']) || isset($params['unlink_from_master_optimization']))
-                            ? Route4Me::generateRequestParameters($allBodyFields, $params)
-                            : null,
-        ]);
-
-        return $result;
-    }
-
-    public function update()
-    {
-        $route = Route4Me::makeRequst([
-            'url'    => Endpoint::ROUTE_V4,
-            'method' => 'PUT',
-            'query'  => [
-                'route_id' => isset($this->route_id) ? $this->route_id : null,
-            ],
-            'body'   => [
-                'parameters' => $this->parameters,
-                ],
-            'HTTPHEADER' => isset($this->httpheaders) ? $this->httpheaders : null,
-        ]);
-
-        return self::fromArray($route);
-    }
-
-    public function updateAddress($address = null)
-    {
-        $body = sizeof($this->addresses) < 1 ? get_object_vars($this->parameters)
-            : (isset($this->addresses[0]) ? $this->addresses[0] : get_object_vars($this->parameters));
-
-        $result = Route4Me::makeRequst([
-            'url'    => Endpoint::ADDRESS_V4,
-            'method' => 'PUT',
-            'query'  => [
-                'route_id' => isset($this->route_id) ? $this->route_id : null,
-                'route_destination_id' => isset($this->route_destination_id) ? $this->route_destination_id : null,
-            ],
-            'body'   => $body,
-            'HTTPHEADER' => isset($this->httpheaders) ? $this->httpheaders : null,
-        ]);
-
-        return $result;
-    }
-
-    public function updateRouteAddress()
-    {
-        $result = Route4Me::makeRequst([
-            'url'    => Endpoint::ADDRESS_V4,
-            'method' => 'PUT',
-            'query'  => [
-                'route_id' => isset($this->route_id) ? $this->route_id : null,
-                'route_destination_id' => isset($this->route_destination_id) ? $this->route_destination_id : null,
-            ],
-            'body'   => [
-                'parameters' => isset($this->parameters) ? get_object_vars($this->parameters) : null,
-                'addresses' => isset($this->addresses) ? $this->addresses : null,
-            ],
-            'HTTPHEADER' => isset($this->httpheaders) ? $this->httpheaders : null,
-        ]);
-
-        return $result;
-    }
-
-    public function addAddresses($params)
-    {
-        $allQueryFields = ['route_id'];
-        $allBodyFields = ['addresses'];
-
-        $route = Route4Me::makeRequst([
-            'url'           => Endpoint::ROUTE_V4,
-            'method'        => 'PUT',
-            'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
-            'HTTPHEADER'    => isset($this->httpheaders) ? $this->httpheaders : null,
-        ]);
-
-        return self::fromArray($route);
-    }
-
-    public function insertAddressOptimalPosition(array $params)
-    {
-        $allQueryFields = ['route_id'];
-        $allBodyFields = ['addresses', 'optimal_position'];
-
-        $route = Route4Me::makeRequst([
-            'url'    => Endpoint::ROUTE_V4,
-            'method' => 'PUT',
-            'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'   => Route4Me::generateRequestParameters($allBodyFields, $params),
-        ]);
-
-        return self::fromArray($route);
-    }
-
-    public function addNoteFile($params)
-    {
-        $fname = isset($params['strFilename']) ? $params['strFilename'] : null;
-        $rpath = realpath($fname);
-
-        $allQueryFields = ['route_id', 'address_id', 'dev_lat', 'dev_lng', 'device_type'];
-        $allBodyFields = ['strUpdateType', 'strFilename', 'strNoteContents'];
-
-        $result = Route4Me::makeRequst([
-            'url'    => Endpoint::ROUTE_NOTES_ADD,
-            'method' => 'POST',
-            'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
-            'body'   => Route4Me::generateRequestParameters($allBodyFields, $params),
-            'FILE'   => $rpath,
-            'HTTPHEADER' => [
-                'Content-Type: application/x-www-form-urlencoded',
-            ],
-        ]);
-
-        return $result;
-    }
-
-    public function deleteRoutes($route_id)
-    {
-        $result = Route4Me::makeRequst([
-            'url'    => Endpoint::ROUTE_V4,
-            'method' => 'DELETE',
-            'query'  => [
-                'route_id' => $route_id,
-            ],
-        ]);
-
-        return $result;
-    }
-
-    public function GetAddressesFromRoute($route_id)
-    {
-        $route1 = self::getRoutes(['route_id' => $route_id]);
-
-        if (isset($route1)) {
-            return $route1->addresses;
-        } else {
-            return null;
-        }
-    }
-
-    public function GetRandomAddressFromRoute($route_id)
-    {
-        $route1 = self::getRoutes(['route_id' => $route_id]);
-
-        if (isset($route1)) {
-            $addresses = $route1->addresses;
-
-            $rnd = rand(0, sizeof($addresses) - 1);
-
-            return $addresses[$rnd];
-        } else {
-            return null;
-        }
-    }
-
-    public function getRouteId()
-    {
-        return $this->route_id;
-    }
-
-    public function getOptimizationId()
-    {
-        return $this->optimization_problem_id;
-    }
-
-    public function GetLastLocation(array $params)
-    {
-        $allQueryFields = ['route_id', 'device_tracking_history'];
-
-        $route = Route4Me::makeRequst([
-            'url'    => Endpoint::ROUTE_V4,
-            'method' => 'GET',
-            'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return self::fromArray($route);
-    }
-
-    public function GetTrackingHistoryFromTimeRange(array $params)
-    {
-        $allQueryFields = ['route_id', 'format', 'time_period', 'start_date', 'end_date'];
-
-        $route = Route4Me::makeRequst([
-            'url'    => Endpoint::GET_DEVICE_LOCATION,
-            'method' => 'GET',
-            'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $route;
-    }
-
-    public function GetAssetTracking(array $params)
-    {
-        $allQueryFields = ['tracking'];
-
-        $assetResponse = Route4Me::makeRequst([
-            'url'    => Endpoint::STATUS_V4,
-            'method' => 'GET',
-            'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
-        ]);
-
-        return $assetResponse;
-    }
+	/**
+	 * The route ID
+	 * @var string
+	 */
+	public $route_id;
+
+	/**
+	 * Member ID of a route owner
+	 * @var integer
+	 */
+	public $member_id;
+
+	/**
+	 * Optimization problem ID
+	 * @var string
+	 */
+	public $optimization_problem_id;
+
+	/**
+	 * Vehicle alias
+	 * @var string
+	 */
+	public $vehicle_alias;
+
+	/**
+	 * Driver alias
+	 * @var string
+	 */
+	public $driver_alias;
+
+	/**
+	 * Total route's trip distance
+	 * @var double
+	 */
+	public $trip_distance;
+
+	/**
+	 * The UDU distance measurement unit for the route.<br>
+	 * @note km or mi, the route4me api will convert all distance measurements into these units.
+	 * @var string
+	 */
+	public $udu_distance_unit;
+
+	/**
+	 * Total route's UDU trip distance
+	 * @var double
+	 */
+	public $udu_trip_distance;
+
+	/** Miles per gallon
+	 * @var double
+	 */
+	public $mpg;
+
+	/**
+	 * Gas price
+	 * @var double
+	 */
+	public $gas_price;
+
+	/**
+	 * Total route duration (seconds)
+	 * @var integer
+	 */
+	public $route_duration_sec;
+
+	/**
+	 * Number of the destinations in the route.
+	 * @var integer
+	 */
+	public $destination_count;
+
+	/**
+	 * Notes count in the route.
+	 * @var integer
+	 */
+	public $notes_count;
+
+	/**
+	 * Route parameters
+	 * @var RouteParameters
+	 */
+	public $parameters;
+
+	/**
+	 * An array of the route addresses
+	 * @var Address[]
+	 */
+	public $addresses = [];
+
+	/**
+	 * An array of the links
+	 * @var string[]
+	 */
+	public $links = [];
+
+	/**
+	 * Edge by edge turn-by-turn directions.
+	 * @var Direction[]
+	 */
+	public $directions = [];
+
+	/**
+	 * Edge-wise path to be drawn on the map.
+	 * @var GeoPoint[]
+	 */
+	public $path = [];
+
+	/**
+	 * A collection of device tracking data with coordinates, speed, and timestamps.
+	 * @var Tracking\TrackingHistory[]
+	 */
+	public $tracking_history = [];
+
+	/**
+	 * HTTP headers
+	 * @var string
+	 */
+	public $httpheaders;
+
+	/**
+	 * If true, the route is unrouted.
+	 * @var Boolean
+	 */
+	public $is_unrouted;
+
+	/**
+	 * User route rating [0, 5]. A null value means no rating was given.<br>
+	 * Users can rate routes so that future optimizations take these ratings into account.
+	 * @var integer
+	 */
+	public $user_route_rating;
+
+	/**
+	 * The member's email
+	 * @var string
+	 */
+	public $member_email;
+
+	/**
+	 * URL to a member picture
+	 * @var string
+	 */
+	public $member_picture;
+
+	/**
+	 * Member tracking subheadline.
+	 * @var string
+	 */
+	public $member_tracking_subheadline;
+
+	/**
+	 * If true, the order is approved for execution.
+	 * @var Boolean
+	 */
+	public $approved_for_execution;
+
+	/**
+	 * Counter of the approved revisions.
+	 * @var integer
+	 */
+	public $approved_revisions_counter;
+
+	/**
+	 * The member's first name.
+	 * @var string
+	 */
+	public $member_first_name;
+
+	/**
+	 * The member's last name.
+	 * @var string
+	 */
+	public $member_last_name;
+
+	/**
+	 * Channel name
+	 * @var string
+	 */
+	public $channel_name;
+
+	/**
+	 * Total cost of the route.
+	 * @var double
+	 */
+	public $route_cost;
+
+	/**
+	 * Total route revenue
+	 * @var double
+	 */
+	public $route_revenue;
+
+	/**
+	 * Net revenue per distance unit.
+	 * @var double
+	 */
+	public $net_revenue_per_distance_unit;
+
+	/**
+	 * When route created (UNIX format timestamp).
+	 * @var integer
+	 */
+	public $created_timestamp;
+
+	/**
+	 * Planned total route duration (seconds).
+	 * @var integer
+	 */
+	public $planned_total_route_duration;
+
+	/**
+	 * Total wait time (seconds).
+	 * @var integer
+	 */
+	public $total_wait_time;
+
+	/**
+	 * UDU Actual travel distance.
+	 * @var double
+	 */
+	public $udu_actual_travel_distance;
+
+	/**
+	 * Actual travel distance.
+	 * @var double
+	 */
+	public $actual_travel_distance;
+
+	/**
+	 * Actual travel time (seconds).
+	 * @var integer
+	 */
+	public $actual_travel_time;
+
+	/**
+	 * Actual footsteps.
+	 * @var integer
+	 */
+	public $actual_footsteps;
+
+	/**
+	 * Working time.
+	 * @var integer
+	 */
+	public $working_time;
+
+	/**
+	 * Driving time.
+	 * @var integer
+	 */
+	public $driving_time;
+
+	/**
+	 * Idling time.
+	 * @var integer
+	 */
+	public $idling_time;
+
+	/**
+	 * Paying miles
+	 * @var double
+	 */
+	public $paying_miles;
+
+	/**
+	 * Geofence polygon type.<br>
+	 * enum: ["circle", "poly", "rect"]
+	 * @var string
+	 */
+	public $geofence_polygon_type;
+
+	/**
+	 * Geofence polygon size.
+	 * @var integer
+	 */
+	public $geofence_polygon_size;
+
+	/**
+	 * Route notes
+	 * @var AddressNote[]
+	 */
+	public $notes=[];
+
+	/**
+	 * A vehicle assigned to the route.
+	 * @var Vehicles\VehicleResponseV4
+	 */
+	public $vehicle=[];
+
+	/**
+	 * Member config key-value pairs.
+	 * @var array
+	 */
+	public $member_config_storage;
+
+	/**
+	 * Original route
+	 * @var Route
+	 */
+	public $original_route;
+
+	/**
+	 * If true, the route will be unlinked from the master optimization.
+	 * @var Boolean
+	 */
+	public $unlink_from_master_optimization;
+
+	public function __construct()
+	{
+		Route4Me::setBaseUrl(Endpoint::BASE_URL);
+	}
+
+	public static function fromArray(array $params)
+	{
+		$route = new self();
+		$route->route_id = Common::getValue($params, 'route_id');
+		$route->member_id = Common::getValue($params, 'member_id');
+		$route->member_email = Common::getValue($params, 'member_email');
+		$route->member_picture = Common::getValue($params, 'member_picture');
+		$route->member_tracking_subheadline = Common::getValue($params, 'member_tracking_subheadline');
+		$route->approved_for_execution = Common::getValue($params, 'approved_for_execution');
+		$route->approved_revisions_counter = Common::getValue($params, 'approved_revisions_counter');
+		$route->member_first_name = Common::getValue($params, 'member_first_name');
+		$route->member_last_name = Common::getValue($params, 'member_last_name');
+		$route->channel_name = Common::getValue($params, 'channel_name');
+		$route->optimization_problem_id = Common::getValue($params, 'optimization_problem_id');
+		$route->user_route_rating = Common::getValue($params, 'user_route_rating');
+		$route->vehicle_alias = Common::getValue($params, 'vehicle_alias');
+		$route->driver_alias = Common::getValue($params, 'driver_alias');
+		$route->trip_distance = Common::getValue($params, 'trip_distance');
+		$route->udu_distance_unit = Common::getValue($params, 'udu_distance_unit');
+		$route->udu_trip_distance = Common::getValue($params, 'udu_trip_distance');
+		$route->mpg = Common::getValue($params, 'mpg');
+		$route->gas_price = Common::getValue($params, 'gas_price');
+		$route->route_duration_sec = Common::getvalue($params, 'route_duration_sec');
+		$route->planned_total_route_duration = Common::getvalue($params, 'planned_total_route_duration');
+		$route->total_wait_time = Common::getvalue($params, 'total_wait_time');
+		$route->udu_actual_travel_distance = Common::getvalue($params, 'udu_actual_travel_distance');
+		$route->actual_travel_distance = Common::getvalue($params, 'actual_travel_distance');
+		$route->actual_travel_time = Common::getvalue($params, 'actual_travel_time');
+		$route->actual_footsteps = Common::getvalue($params, 'actual_footsteps');
+		$route->working_time = Common::getvalue($params, 'working_time');
+		$route->driving_time = Common::getvalue($params, 'driving_time');
+		$route->idling_time = Common::getvalue($params, 'idling_time');
+		$route->paying_miles = Common::getvalue($params, 'paying_miles');
+		$route->geofence_polygon_type = Common::getvalue($params, 'geofence_polygon_type');
+		$route->geofence_polygon_size = Common::getvalue($params, 'geofence_polygon_size');
+		$route->destination_count = Common::getvalue($params, 'destination_count');
+		$route->notes_count = Common::getvalue($params, 'notes_count');
+		$route->is_unrouted = Common::getvalue($params, 'is_unrouted');
+		$route->route_cost = Common::getvalue($params, 'route_cost');
+		$route->route_revenue = Common::getvalue($params, 'route_revenue');
+		$route->net_revenue_per_distance_unit = Common::getvalue($params, 'net_revenue_per_distance_unit');
+		$route->created_timestamp = Common::getvalue($params, 'created_timestamp');
+
+		if (isset($params['vehicle'])) {
+			$route->vehicle = new Vehicle();
+			$route->vehicle = Vehicle::fromArray($params['vehicle']);
+			Route4Me::setBaseUrl(Endpoint::BASE_URL);
+		};
+
+		$route->member_config_storage = Common::getvalue($params, 'member_config_storage');
+
+		// Make RouteParameters
+		if (isset($params['parameters'])) {
+			$route->parameters = new RouteParameters();
+			$route->parameters = RouteParameters::fromArray($params['parameters']);
+			Route4Me::setBaseUrl(Endpoint::BASE_URL);
+		}
+
+		if (isset($params['addresses'])) {
+			$addresses = [];
+
+			foreach ($params['addresses'] as $address) {
+				$addresses[] = Address::fromArray($address);
+			}
+
+			$route->addresses = $addresses;
+		}
+
+		$route->links = Common::getValue($params, 'links', []);
+		$route->notes = Common::getValue($params, 'notes', []);
+		$route->directions = Common::getValue($params, 'directions', []);
+		$route->path = Common::getValue($params, 'path', []);
+		$route->tracking_history = Common::getValue($params, 'tracking_history', []);
+
+		if (isset($params['original_route'])) {
+			$route->original_route = Route::fromArray($params['original_route']);
+		};
+
+		return $route;
+	}
+
+	/**
+	 * @param RouteParametersQuery $params
+	 * @return An array of the routes
+	 * @throws Exception\ApiError
+	 */
+	public static function getRoutes($params = null)
+	{
+		$allQueryFields = ['route_id', 'original', 'route_path_output', 'query', 'directions', 'device_tracking_history', 'limit', 'offset','start_date','end_date'];
+
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::ROUTE_V4,
+			'method'    => 'GET',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		if (isset($params['route_id'])) {
+			if (strlen($params['route_id'])==32) {
+				return self::fromArray($result);
+			} else {
+				return $result;
+			}
+		} else {
+			$routes = [];
+			foreach ($result as $route) {
+				$routes[] = self::fromArray($route);
+			}
+
+			return $routes;
+		}
+	}
+
+	public function getRoutePoints($params)
+	{
+		$allQueryFields = ['route_id', 'route_path_output', 'compress_path_points', 'directions'];
+
+		$result = Route4Me::makeRequst([
+			'url'    => Endpoint::ROUTE_V4,
+			'method' => 'GET',
+			'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $result;
+	}
+
+	public function duplicateRoute($routeIDs)
+	{
+		$result = Route4Me::makeRequst([
+			'url'    => Endpoint::ROUTE_V4,
+			'method' => 'POST',
+			'body'   => [
+				'duplicate_routes_id' => $routeIDs
+			],
+		]);
+
+		return $result;
+	}
+
+	public function resequenceRoute($params)
+	{
+		$allQueryFields = ['route_id', 'route_destination_id'];
+		$allBodyFields = ['addresses'];
+
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::ROUTE_V4,
+			'method'    => 'PUT',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'      => Route4Me::generateRequestParameters($allBodyFields, $params),
+		]);
+
+		return $result;
+	}
+
+	/**
+	 * @deprecated 'The method is obsolete, use the method ReoptimizeRoute instead.'
+	 * @param $params
+	 * @return mixed|string
+	 */
+	public function resequenceAllAddresses($params)
+	{
+		$allQueryFields = ['route_id', 'disable_optimization', 'optimize'];
+
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::REOPTIMIZE_V3_2,
+			'method'    => 'GET',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $result;
+	}
+
+	/**
+	 * Reoptimize a route
+	 * @param $params type Route
+	 * @return mixed|string
+	 * @throws Exception\ApiError
+	 */
+	public function reoptimizeRoute($params)
+	{
+		$allQueryFields = ['route_id', 'reoptimize', 'remaining', 'device_type'];
+
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::ROUTE_V4,
+			'method'    => 'PUT',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $result;
+	}
+
+	/**
+	 * Merges the routes
+	 * @param $params array contains:
+	 * @param route_ids IDs of the routes to be merged.
+	 * @param depot_address a depot address of the merged route.
+	 * @param remove_origin if true, the origin routes will be removed.
+	 * @param depot_lat the depot's latitude
+	 * @param depot_lng the depot's longitude
+	 * @return Status response
+	 * @throws Exception\ApiError
+	 */
+	public function mergeRoutes($params)
+	{
+		$allBodyFields = ['route_ids', 'depot_address', 'remove_origin', 'depot_lat',  'depot_lng'];
+
+		$result = Route4Me::makeRequst([
+			'url'           => Endpoint::ROUTES_MERGE,
+			'method'        => 'POST',
+			'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
+			'HTTPHEADER'    => 'Content-Type: multipart/form-data',
+		]);
+
+		return $result;
+	}
+
+	/**
+	 * Share a route by an email
+	 * @param $params RouteParametersQuery contains:
+	 * @param route_id a route ID to be shared.
+	 * @param response_format the response format.
+	 * @param recipient_email Recipient email.
+	 * @return Status response
+	 * @throws Exception\ApiError
+	 */
+	public function shareRoute($params)
+	{
+		$allQueryFields = ['route_id', 'response_format'];
+		$allBodyFields = ['recipient_email'];
+
+		$result = Route4Me::makeRequst([
+			'url'           => Endpoint::ROUTE_SHARE,
+			'method'        => 'POST',
+			'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
+			'HTTPHEADER'    => 'Content-Type: multipart/form-data',
+		]);
+
+		return $result;
+	}
+
+	/**
+	 * Returns random route_id from existing routes between $offset and $offset+$limit
+	 * @param $offset integer The page number for route listing pagination.
+	 * @param $limit integer The maximum number of the returned routes.
+	 * @return string random route ID
+	 * @throws Exception\ApiError
+	 */
+	public function getRandomRouteId($offset, $limit)
+	{
+		$params = [
+			'offset'    => !is_null($offset) ? $offset : 0,
+			'limit'     => !is_null($limit) ? $limit : 30,
+		];
+
+		$route = new self();
+		$routes = $route->getRoutes($params);
+
+		if (is_null($routes) || sizeof($routes) < 1) {
+			echo '<br> There are no routes in the account. Please, create the routes first. <br>';
+
+			return null;
+		}
+
+		$randomIndex = rand(0, sizeof($routes) - 1);
+
+		return $routes[$randomIndex]->route_id;
+	}
+
+	/**
+	 * Update a route
+	 * @param $params array contains:
+	 * @param route_id string : route ID
+	 * @param reoptimize int : if equal to 1 the route re-optimized.
+	 * @param route_destination_id int : route destination ID
+	 * @param addresses Address[] : an array of a route addresses.
+	 * @param parameters RouteParameters : route parameters.
+	 * @param unlink_from_master_optimization  Boolean : if true, the route will be unlinked from optimization.
+	 * @return Route updated route
+	 * @throws Exception\ApiError
+	 */
+	public function updateRoute($params)
+	{
+		$allQueryFields = ['route_id', 'reoptimize','route_destination_id'];
+		$allBodyFields = ['addresses', 'parameters', 'unlink_from_master_optimization'];
+
+		$result = Route4Me::makeRequst([
+			'url'       => Endpoint::ROUTE_V4,
+			'method'    => 'PUT',
+			'query'     => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'      => (isset($params['addresses']) || isset($params['parameters']) || isset($params['unlink_from_master_optimization']))
+							? Route4Me::generateRequestParameters($allBodyFields, $params)
+							: null,
+		]);
+
+		return $result;
+	}
+
+	public function update()
+	{
+		$route = Route4Me::makeRequst([
+			'url'    => Endpoint::ROUTE_V4,
+			'method' => 'PUT',
+			'query'  => [
+				'route_id' => isset($this->route_id) ? $this->route_id : null,
+			],
+			'body'   => [
+				'parameters' => $this->parameters,
+				],
+			'HTTPHEADER' => isset($this->httpheaders) ? $this->httpheaders : null,
+		]);
+
+		return self::fromArray($route);
+	}
+
+	public function updateAddress($address = null)
+	{
+		$body = sizeof($this->addresses) < 1 ? get_object_vars($this->parameters)
+			: (isset($this->addresses[0]) ? $this->addresses[0] : get_object_vars($this->parameters));
+
+		$result = Route4Me::makeRequst([
+			'url'    => Endpoint::ADDRESS_V4,
+			'method' => 'PUT',
+			'query'  => [
+				'route_id' => isset($this->route_id) ? $this->route_id : null,
+				'route_destination_id' => isset($this->route_destination_id) ? $this->route_destination_id : null,
+			],
+			'body'   => $body,
+			'HTTPHEADER' => isset($this->httpheaders) ? $this->httpheaders : null,
+		]);
+
+		return $result;
+	}
+
+	public function updateRouteAddress()
+	{
+		$result = Route4Me::makeRequst([
+			'url'    => Endpoint::ADDRESS_V4,
+			'method' => 'PUT',
+			'query'  => [
+				'route_id' => isset($this->route_id) ? $this->route_id : null,
+				'route_destination_id' => isset($this->route_destination_id) ? $this->route_destination_id : null,
+			],
+			'body'   => [
+				'parameters' => isset($this->parameters) ? get_object_vars($this->parameters) : null,
+				'addresses' => isset($this->addresses) ? $this->addresses : null,
+			],
+			'HTTPHEADER' => isset($this->httpheaders) ? $this->httpheaders : null,
+		]);
+
+		return $result;
+	}
+
+	public function addAddresses($params)
+	{
+		$allQueryFields = ['route_id'];
+		$allBodyFields = ['addresses'];
+
+		$route = Route4Me::makeRequst([
+			'url'           => Endpoint::ROUTE_V4,
+			'method'        => 'PUT',
+			'query'         => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'          => Route4Me::generateRequestParameters($allBodyFields, $params),
+			'HTTPHEADER'    => isset($this->httpheaders) ? $this->httpheaders : null,
+		]);
+
+		return self::fromArray($route);
+	}
+
+	public function insertAddressOptimalPosition(array $params)
+	{
+		$allQueryFields = ['route_id'];
+		$allBodyFields = ['addresses', 'optimal_position'];
+
+		$route = Route4Me::makeRequst([
+			'url'    => Endpoint::ROUTE_V4,
+			'method' => 'PUT',
+			'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'   => Route4Me::generateRequestParameters($allBodyFields, $params),
+		]);
+
+		return self::fromArray($route);
+	}
+
+	public function addNoteFile($params)
+	{
+		$fname = isset($params['strFilename']) ? $params['strFilename'] : null;
+		$rpath = realpath($fname);
+
+		$allQueryFields = ['route_id', 'address_id', 'dev_lat', 'dev_lng', 'device_type'];
+		$allBodyFields = ['strUpdateType', 'strFilename', 'strNoteContents'];
+
+		$result = Route4Me::makeRequst([
+			'url'    => Endpoint::ROUTE_NOTES_ADD,
+			'method' => 'POST',
+			'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
+			'body'   => Route4Me::generateRequestParameters($allBodyFields, $params),
+			'FILE'   => $rpath,
+			'HTTPHEADER' => [
+				'Content-Type: application/x-www-form-urlencoded',
+			],
+		]);
+
+		return $result;
+	}
+
+	public function deleteRoutes($route_id)
+	{
+		$result = Route4Me::makeRequst([
+			'url'    => Endpoint::ROUTE_V4,
+			'method' => 'DELETE',
+			'query'  => [
+				'route_id' => $route_id,
+			],
+		]);
+
+		return $result;
+	}
+
+	public function GetAddressesFromRoute($route_id)
+	{
+		$route1 = self::getRoutes(['route_id' => $route_id]);
+
+		if (isset($route1)) {
+			return $route1->addresses;
+		} else {
+			return null;
+		}
+	}
+
+	public function GetRandomAddressFromRoute($route_id)
+	{
+		$route1 = self::getRoutes(['route_id' => $route_id]);
+
+		if (isset($route1)) {
+			$addresses = $route1->addresses;
+
+			$rnd = rand(0, sizeof($addresses) - 1);
+
+			return $addresses[$rnd];
+		} else {
+			return null;
+		}
+	}
+
+	public function getRouteId()
+	{
+		return $this->route_id;
+	}
+
+	public function getOptimizationId()
+	{
+		return $this->optimization_problem_id;
+	}
+
+	public function GetLastLocation(array $params)
+	{
+		$allQueryFields = ['route_id', 'device_tracking_history'];
+
+		$route = Route4Me::makeRequst([
+			'url'    => Endpoint::ROUTE_V4,
+			'method' => 'GET',
+			'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return self::fromArray($route);
+	}
+
+	public function GetTrackingHistoryFromTimeRange(array $params)
+	{
+		$allQueryFields = ['route_id', 'format', 'time_period', 'start_date', 'end_date'];
+
+		$route = Route4Me::makeRequst([
+			'url'    => Endpoint::GET_DEVICE_LOCATION,
+			'method' => 'GET',
+			'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $route;
+	}
+
+	public function GetAssetTracking(array $params)
+	{
+		$allQueryFields = ['tracking'];
+
+		$assetResponse = Route4Me::makeRequst([
+			'url'    => Endpoint::STATUS_V4,
+			'method' => 'GET',
+			'query'  => Route4Me::generateRequestParameters($allQueryFields, $params),
+		]);
+
+		return $assetResponse;
+	}
 }