RefreshRouteOptions (API Reference)
Class RefreshRouteOptions
The options to specify how to refresh an already calculated route identified by a RouteHandle. All the
options that may result in a new route shape are ignored as no new route is calculated. Instead, only the data that
accompanies a route, such as traffic information, can be refreshed. Therefore, the following route options are ignored:
RouteOptions.alternatives, RouteOptions.arrivalTime, and RouteOptions.optimizationMode.
If new AvoidanceOptions are specified, they are ignored as well and instead new SectionNotice's
are generated that indicate where the requested AvoidanceOptions are violated. Note that when
EVCarOptions.ensureReachability is set to true, the route refresh request will fail as this option
is incompatible with a fixed route shape.
If any of the ignored options are important, consider calculating a new route instead.
Note: This is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
-
Constructor Summary
ConstructorsConstructorDescriptionRefreshRouteOptions(BicycleOptions bicycleOptions) Deprecated.Constructs a RefreshRouteOptions object withBicycleOptions.RefreshRouteOptions(BusOptions busOptions) Deprecated.Constructs a RefreshRouteOptions object withBusOptions.RefreshRouteOptions(CarOptions carOptions) Deprecated.Constructs a RefreshRouteOptions object withCarOptions.RefreshRouteOptions(EVCarOptions evCarOptions) Deprecated.Constructs a RefreshRouteOptions object withEVCarOptions.RefreshRouteOptions(EVTruckOptions evTruckOptions) Deprecated.Constructs a RefreshRouteOptions object withEVTruckOptions.RefreshRouteOptions(PedestrianOptions pedestrianOptions) Deprecated.Constructs a RefreshRouteOptions object withPedestrianOptions.RefreshRouteOptions(PrivateBusOptions privateBusOptions) Deprecated.Constructs a RefreshRouteOptions object withPrivateBusOptions.RefreshRouteOptions(ScooterOptions scooterOptions) Deprecated.Constructs a RefreshRouteOptions object withScooterOptions.RefreshRouteOptions(TaxiOptions taxiOptions) Deprecated.Constructs a RefreshRouteOptions object withTaxiOptions.RefreshRouteOptions(TruckOptions truckOptions) Deprecated.Constructs a RefreshRouteOptions object withTruckOptions.RefreshRouteOptions(TransportMode transportMode) Deprecated.Constructs a RefreshRouteOptions object withTransportMode. -
Method Summary
-
Constructor Details
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
TransportMode.- Parameters:
transportMode-Updates the transport mode for the route.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
CarOptions.- Parameters:
carOptions-Converts the route to a car route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
TruckOptions.- Parameters:
truckOptions-Converts the route to a truck route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
PedestrianOptions.- Parameters:
pedestrianOptions-Converts the route to a pedestrian route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
ScooterOptions.- Parameters:
scooterOptions-Converts the route to a scooter route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
TaxiOptions.- Parameters:
taxiOptions-Converts the route to a taxi route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
EVCarOptions.- Parameters:
evCarOptions-Converts the route to an electric car route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
EVTruckOptions.- Parameters:
evTruckOptions-Converts the route to an electric truck route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
BicycleOptions.- Parameters:
bicycleOptions-Converts the route to a bicycle route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
BusOptions.- Parameters:
busOptions-Converts the route to a bus route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
RefreshRouteOptions
Deprecated.Constructs a RefreshRouteOptions object with
PrivateBusOptions.- Parameters:
privateBusOptions-Converts the route to a private bus route, if a different transport mode was used for the
RouteHandle. Note that in case this is not possible, anRoutingError.NO_ROUTE_FOUNDerror will be triggered.
-
Will be removed in v4.28.0. Use the
RoutingOptionsclass instead.