pub struct CalculateRouteMatrixFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to CalculateRouteMatrix
.
Calculates a route matrix given the following required parameters: DeparturePositions
and DestinationPositions
. CalculateRouteMatrix
calculates routes and returns the travel time and travel distance from each departure position to each destination position in the request. For example, given departure positions A and B, and destination positions X and Y, CalculateRouteMatrix
will return time and distance for routes from A to X, A to Y, B to X, and B to Y (in that order). The number of results returned (and routes calculated) will be the number of DeparturePositions
times the number of DestinationPositions
.
Your account is charged for each route calculated, not the number of requests.
Requires that you first create a route calculator resource.
By default, a request that doesn't specify a departure time uses the best time of day to travel with the best traffic conditions when calculating routes.
Additional options include:
-
Specifying a departure time using either
DepartureTime
orDepartNow
. This calculates routes based on predictive traffic data at the given time.You can't specify both
DepartureTime
andDepartNow
in a single request. Specifying both parameters returns a validation error. -
Specifying a travel mode using TravelMode sets the transportation mode used to calculate the routes. This also lets you specify additional route preferences in
CarModeOptions
if traveling byCar
, orTruckModeOptions
if traveling byTruck
.
Implementations§
Source§impl CalculateRouteMatrixFluentBuilder
impl CalculateRouteMatrixFluentBuilder
Sourcepub fn as_input(&self) -> &CalculateRouteMatrixInputBuilder
pub fn as_input(&self) -> &CalculateRouteMatrixInputBuilder
Access the CalculateRouteMatrix as a reference.
Sourcepub async fn send(
self,
) -> Result<CalculateRouteMatrixOutput, SdkError<CalculateRouteMatrixError, HttpResponse>>
pub async fn send( self, ) -> Result<CalculateRouteMatrixOutput, SdkError<CalculateRouteMatrixError, HttpResponse>>
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
Sourcepub fn customize(
self,
) -> CustomizableOperation<CalculateRouteMatrixOutput, CalculateRouteMatrixError, Self>
pub fn customize( self, ) -> CustomizableOperation<CalculateRouteMatrixOutput, CalculateRouteMatrixError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
Sourcepub fn calculator_name(self, input: impl Into<String>) -> Self
pub fn calculator_name(self, input: impl Into<String>) -> Self
The name of the route calculator resource that you want to use to calculate the route matrix.
Sourcepub fn set_calculator_name(self, input: Option<String>) -> Self
pub fn set_calculator_name(self, input: Option<String>) -> Self
The name of the route calculator resource that you want to use to calculate the route matrix.
Sourcepub fn get_calculator_name(&self) -> &Option<String>
pub fn get_calculator_name(&self) -> &Option<String>
The name of the route calculator resource that you want to use to calculate the route matrix.
Sourcepub fn departure_positions(self, input: Vec<f64>) -> Self
pub fn departure_positions(self, input: Vec<f64>) -> Self
Appends an item to DeparturePositions
.
To override the contents of this collection use set_departure_positions
.
The list of departure (origin) positions for the route matrix. An array of points, each of which is itself a 2-value array defined in WGS 84 format: \[longitude, latitude\]
. For example, \[-123.115, 49.285\]
.
Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See Position restrictions in the Amazon Location Service Developer Guide.
For route calculators that use Esri as the data provider, if you specify a departure that's not located on a road, Amazon Location moves the position to the nearest road. The snapped value is available in the result in SnappedDeparturePositions
.
Valid Values: \[-180 to 180,-90 to 90\]
Sourcepub fn set_departure_positions(self, input: Option<Vec<Vec<f64>>>) -> Self
pub fn set_departure_positions(self, input: Option<Vec<Vec<f64>>>) -> Self
The list of departure (origin) positions for the route matrix. An array of points, each of which is itself a 2-value array defined in WGS 84 format: \[longitude, latitude\]
. For example, \[-123.115, 49.285\]
.
Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See Position restrictions in the Amazon Location Service Developer Guide.
For route calculators that use Esri as the data provider, if you specify a departure that's not located on a road, Amazon Location moves the position to the nearest road. The snapped value is available in the result in SnappedDeparturePositions
.
Valid Values: \[-180 to 180,-90 to 90\]
Sourcepub fn get_departure_positions(&self) -> &Option<Vec<Vec<f64>>>
pub fn get_departure_positions(&self) -> &Option<Vec<Vec<f64>>>
The list of departure (origin) positions for the route matrix. An array of points, each of which is itself a 2-value array defined in WGS 84 format: \[longitude, latitude\]
. For example, \[-123.115, 49.285\]
.
Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See Position restrictions in the Amazon Location Service Developer Guide.
For route calculators that use Esri as the data provider, if you specify a departure that's not located on a road, Amazon Location moves the position to the nearest road. The snapped value is available in the result in SnappedDeparturePositions
.
Valid Values: \[-180 to 180,-90 to 90\]
Sourcepub fn destination_positions(self, input: Vec<f64>) -> Self
pub fn destination_positions(self, input: Vec<f64>) -> Self
Appends an item to DestinationPositions
.
To override the contents of this collection use set_destination_positions
.
The list of destination positions for the route matrix. An array of points, each of which is itself a 2-value array defined in WGS 84 format: \[longitude, latitude\]
. For example, \[-122.339, 47.615\]
Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See Position restrictions in the Amazon Location Service Developer Guide.
For route calculators that use Esri as the data provider, if you specify a destination that's not located on a road, Amazon Location moves the position to the nearest road. The snapped value is available in the result in SnappedDestinationPositions
.
Valid Values: \[-180 to 180,-90 to 90\]
Sourcepub fn set_destination_positions(self, input: Option<Vec<Vec<f64>>>) -> Self
pub fn set_destination_positions(self, input: Option<Vec<Vec<f64>>>) -> Self
The list of destination positions for the route matrix. An array of points, each of which is itself a 2-value array defined in WGS 84 format: \[longitude, latitude\]
. For example, \[-122.339, 47.615\]
Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See Position restrictions in the Amazon Location Service Developer Guide.
For route calculators that use Esri as the data provider, if you specify a destination that's not located on a road, Amazon Location moves the position to the nearest road. The snapped value is available in the result in SnappedDestinationPositions
.
Valid Values: \[-180 to 180,-90 to 90\]
Sourcepub fn get_destination_positions(&self) -> &Option<Vec<Vec<f64>>>
pub fn get_destination_positions(&self) -> &Option<Vec<Vec<f64>>>
The list of destination positions for the route matrix. An array of points, each of which is itself a 2-value array defined in WGS 84 format: \[longitude, latitude\]
. For example, \[-122.339, 47.615\]
Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See Position restrictions in the Amazon Location Service Developer Guide.
For route calculators that use Esri as the data provider, if you specify a destination that's not located on a road, Amazon Location moves the position to the nearest road. The snapped value is available in the result in SnappedDestinationPositions
.
Valid Values: \[-180 to 180,-90 to 90\]
Sourcepub fn travel_mode(self, input: TravelMode) -> Self
pub fn travel_mode(self, input: TravelMode) -> Self
Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
The TravelMode
you specify also determines how you specify route preferences:
-
If traveling by
Car
use theCarModeOptions
parameter. -
If traveling by
Truck
use theTruckModeOptions
parameter.
Bicycle
or Motorcycle
are only valid when using Grab
as a data provider, and only within Southeast Asia.
Truck
is not available for Grab.
For more information about using Grab as a data provider, see GrabMaps in the Amazon Location Service Developer Guide.
Default Value: Car
Sourcepub fn set_travel_mode(self, input: Option<TravelMode>) -> Self
pub fn set_travel_mode(self, input: Option<TravelMode>) -> Self
Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
The TravelMode
you specify also determines how you specify route preferences:
-
If traveling by
Car
use theCarModeOptions
parameter. -
If traveling by
Truck
use theTruckModeOptions
parameter.
Bicycle
or Motorcycle
are only valid when using Grab
as a data provider, and only within Southeast Asia.
Truck
is not available for Grab.
For more information about using Grab as a data provider, see GrabMaps in the Amazon Location Service Developer Guide.
Default Value: Car
Sourcepub fn get_travel_mode(&self) -> &Option<TravelMode>
pub fn get_travel_mode(&self) -> &Option<TravelMode>
Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
The TravelMode
you specify also determines how you specify route preferences:
-
If traveling by
Car
use theCarModeOptions
parameter. -
If traveling by
Truck
use theTruckModeOptions
parameter.
Bicycle
or Motorcycle
are only valid when using Grab
as a data provider, and only within Southeast Asia.
Truck
is not available for Grab.
For more information about using Grab as a data provider, see GrabMaps in the Amazon Location Service Developer Guide.
Default Value: Car
Sourcepub fn departure_time(self, input: DateTime) -> Self
pub fn departure_time(self, input: DateTime) -> Self
Specifies the desired time of departure. Uses the given time to calculate the route matrix. You can't set both DepartureTime
and DepartNow
. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.
Setting a departure time in the past returns a 400 ValidationException
error.
-
In ISO 8601 format:
YYYY-MM-DDThh:mm:ss.sssZ
. For example,2020–07-2T12:15:20.000Z+01:00
Sourcepub fn set_departure_time(self, input: Option<DateTime>) -> Self
pub fn set_departure_time(self, input: Option<DateTime>) -> Self
Specifies the desired time of departure. Uses the given time to calculate the route matrix. You can't set both DepartureTime
and DepartNow
. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.
Setting a departure time in the past returns a 400 ValidationException
error.
-
In ISO 8601 format:
YYYY-MM-DDThh:mm:ss.sssZ
. For example,2020–07-2T12:15:20.000Z+01:00
Sourcepub fn get_departure_time(&self) -> &Option<DateTime>
pub fn get_departure_time(&self) -> &Option<DateTime>
Specifies the desired time of departure. Uses the given time to calculate the route matrix. You can't set both DepartureTime
and DepartNow
. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.
Setting a departure time in the past returns a 400 ValidationException
error.
-
In ISO 8601 format:
YYYY-MM-DDThh:mm:ss.sssZ
. For example,2020–07-2T12:15:20.000Z+01:00
Sourcepub fn depart_now(self, input: bool) -> Self
pub fn depart_now(self, input: bool) -> Self
Sets the time of departure as the current time. Uses the current time to calculate the route matrix. You can't set both DepartureTime
and DepartNow
. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.
Default Value: false
Valid Values: false
| true
Sourcepub fn set_depart_now(self, input: Option<bool>) -> Self
pub fn set_depart_now(self, input: Option<bool>) -> Self
Sets the time of departure as the current time. Uses the current time to calculate the route matrix. You can't set both DepartureTime
and DepartNow
. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.
Default Value: false
Valid Values: false
| true
Sourcepub fn get_depart_now(&self) -> &Option<bool>
pub fn get_depart_now(&self) -> &Option<bool>
Sets the time of departure as the current time. Uses the current time to calculate the route matrix. You can't set both DepartureTime
and DepartNow
. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.
Default Value: false
Valid Values: false
| true
Sourcepub fn distance_unit(self, input: DistanceUnit) -> Self
pub fn distance_unit(self, input: DistanceUnit) -> Self
Set the unit system to specify the distance.
Default Value: Kilometers
Sourcepub fn set_distance_unit(self, input: Option<DistanceUnit>) -> Self
pub fn set_distance_unit(self, input: Option<DistanceUnit>) -> Self
Set the unit system to specify the distance.
Default Value: Kilometers
Sourcepub fn get_distance_unit(&self) -> &Option<DistanceUnit>
pub fn get_distance_unit(&self) -> &Option<DistanceUnit>
Set the unit system to specify the distance.
Default Value: Kilometers
Sourcepub fn car_mode_options(self, input: CalculateRouteCarModeOptions) -> Self
pub fn car_mode_options(self, input: CalculateRouteCarModeOptions) -> Self
Specifies route preferences when traveling by Car
, such as avoiding routes that use ferries or tolls.
Requirements: TravelMode
must be specified as Car
.
Sourcepub fn set_car_mode_options(
self,
input: Option<CalculateRouteCarModeOptions>,
) -> Self
pub fn set_car_mode_options( self, input: Option<CalculateRouteCarModeOptions>, ) -> Self
Specifies route preferences when traveling by Car
, such as avoiding routes that use ferries or tolls.
Requirements: TravelMode
must be specified as Car
.
Sourcepub fn get_car_mode_options(&self) -> &Option<CalculateRouteCarModeOptions>
pub fn get_car_mode_options(&self) -> &Option<CalculateRouteCarModeOptions>
Specifies route preferences when traveling by Car
, such as avoiding routes that use ferries or tolls.
Requirements: TravelMode
must be specified as Car
.
Sourcepub fn truck_mode_options(self, input: CalculateRouteTruckModeOptions) -> Self
pub fn truck_mode_options(self, input: CalculateRouteTruckModeOptions) -> Self
Specifies route preferences when traveling by Truck
, such as avoiding routes that use ferries or tolls, and truck specifications to consider when choosing an optimal road.
Requirements: TravelMode
must be specified as Truck
.
Sourcepub fn set_truck_mode_options(
self,
input: Option<CalculateRouteTruckModeOptions>,
) -> Self
pub fn set_truck_mode_options( self, input: Option<CalculateRouteTruckModeOptions>, ) -> Self
Specifies route preferences when traveling by Truck
, such as avoiding routes that use ferries or tolls, and truck specifications to consider when choosing an optimal road.
Requirements: TravelMode
must be specified as Truck
.
Sourcepub fn get_truck_mode_options(&self) -> &Option<CalculateRouteTruckModeOptions>
pub fn get_truck_mode_options(&self) -> &Option<CalculateRouteTruckModeOptions>
Specifies route preferences when traveling by Truck
, such as avoiding routes that use ferries or tolls, and truck specifications to consider when choosing an optimal road.
Requirements: TravelMode
must be specified as Truck
.
Sourcepub fn key(self, input: impl Into<String>) -> Self
pub fn key(self, input: impl Into<String>) -> Self
The optional API key to authorize the request.
Trait Implementations§
Source§impl Clone for CalculateRouteMatrixFluentBuilder
impl Clone for CalculateRouteMatrixFluentBuilder
Source§fn clone(&self) -> CalculateRouteMatrixFluentBuilder
fn clone(&self) -> CalculateRouteMatrixFluentBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for CalculateRouteMatrixFluentBuilder
impl !RefUnwindSafe for CalculateRouteMatrixFluentBuilder
impl Send for CalculateRouteMatrixFluentBuilder
impl Sync for CalculateRouteMatrixFluentBuilder
impl Unpin for CalculateRouteMatrixFluentBuilder
impl !UnwindSafe for CalculateRouteMatrixFluentBuilder
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);