1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
use crate::directions::travel_mode::TravelMode;
use crate::distance_matrix::Error;
// -----------------------------------------------------------------------------
impl crate::traits::Validatable for crate::distance_matrix::Request<'_> {
/// Ensures that the request is valid.
///
/// This function checks the combination of parameters to ensure that they
/// make sense together and that Google Maps API will accept them.
///
/// For example, Google Maps will not allow both a Positional Request and a
/// Sampled Path Request in the same query.
///
/// This function does not check parameter values for validity - i.e. it
/// will not ensure Polylines or Latitudes/Longitudes are valid and
/// well-formed.
///
/// ## Arguments
///
/// This method accepts no arguments.
///
/// # Errors
///
/// * This will fail if the request `struct` fails validation. For example,
/// parameters in the request conflict with one another, or the request
/// parameters are set in a way that's incompatible.
///
/// For example, Google Maps Directions API cannot calculate alternative
/// routes if waypoints have been set. This will cause a validation
/// failure.
fn validate(&self) -> Result<(), crate::Error> {
if let Some(travel_mode) = &self.travel_mode {
// If the transit mode is not set to TravelMode::Transit...
if *travel_mode != TravelMode::Transit {
// ...an arrival time cannot be set:
if let Some(arrival_time) = &self.arrival_time {
return Err(Error::ArrivalTimeIsForTransitOnly(
travel_mode.to_string(),
arrival_time.format("%F %r").to_string(),
))?; // Err
} // if
// ...a transit mode cannot be set:
if !self.transit_modes.is_empty() {
return Err(Error::TransitModeIsForTransitOnly(
travel_mode.to_string(),
self.transit_modes
.iter()
.map(std::string::ToString::to_string)
.collect::<Vec<String>>()
.join("|"),
))?; // Err
} // if
// ...a transit route preference cannot be set:
if let Some(transit_route_preference) = &self.transit_route_preference {
return Err(Error::TransitRoutePreferenceIsForTransitOnly(
travel_mode.to_string(),
transit_route_preference.to_string(),
))?; // Err
} // if
} // if
} // if
// If an arrival time has been set...
if let Some(arrival_time) = &self.arrival_time {
// ...a departure time cannot be set:
if let Some(departure_time) = &self.departure_time {
return Err(Error::EitherDepartureTimeOrArrivalTime(
arrival_time.format("%F %r").to_string(),
departure_time.to_string(),
))?; // Err
} // if
} // if
// If we made it to the bottom, all tests have passed. Return `Ok` to
// caller:
Ok(())
} // fn
} // impl