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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
//! A single leg consisting of a set of steps in a `DirectionsResult`. Some fields
//! in the leg may not be returned for all requests.
use crate::directions::response::{
directions_distance::DirectionsDistance, directions_duration::DirectionsDuration, step::Step,
transit_time::TransitTime,
}; // crate::directions::response
use crate::types::LatLng;
use serde::{Deserialize, Serialize};
// -----------------------------------------------------------------------------
//
/// A single leg consisting of a set of steps in a `DirectionsResult`. Some fields
/// in the leg may not be returned for all requests. Note that though this
/// result is "JSON-like," it is not strictly JSON, as it directly and
/// indirectly includes `LatLng` objects.
#[derive(Clone, Debug, Eq, Hash, PartialEq, Serialize, Deserialize)]
pub struct Leg {
/// An estimated arrival time for this leg. Only applicable for
/// `TravelMode::Transit` requests.
#[serde(default)]
pub arrival_time: Option<TransitTime>,
/// An estimated departure time for this leg. Only applicable for
/// `TravelMode::Transit` requests.
#[serde(default)]
pub departure_time: Option<TransitTime>,
/// The total distance covered by this leg. This property may be undefined
/// as the distance may be unknown.
pub distance: DirectionsDistance,
/// The total duration of this leg. This property may be undefined as the
/// duration may be unknown.
pub duration: DirectionsDuration,
/// The total duration of this leg, taking into account the traffic
/// conditions indicated by the `with_traffic_model()` method. This property
/// may be undefined as the duration may be unknown. Only available to
/// Premium Plan customers.
#[serde(default)]
pub duration_in_traffic: Option<DirectionsDuration>,
/// The address of the destination of this leg.
pub end_address: String,
/// The Directions Service calculates directions between locations by using
/// the nearest transportation option (usually a road) at the start and end
/// locations. `end_location` indicates the actual geocoded destination,
/// which may be different than the `end_location` of the last step if, for
/// example, the road is not near the destination of this leg.
pub end_location: LatLng,
/// The address of the origin of this leg.
pub start_address: String,
/// The Directions Service calculates directions between locations by using
/// the nearest transportation option (usually a road) at the start and end
/// locations. `start_location` indicates the actual geocoded origin, which
/// may be different than the `start_location` of the first step if, for
/// example, the road is not near the origin of this leg.
pub start_location: LatLng,
/// An array of `Steps`, each of which contains information about the
/// individual steps in this leg.
#[serde(default)]
pub steps: Vec<Step>,
} // struct
// -----------------------------------------------------------------------------
impl Leg {
/// A helper function for destructuring (or serializing) the optional
/// `duration_in_traffic` field. If the `Duration` struct is populated, this
/// function will return the _text_ field as a `String`. If the _Duration_
/// struct is empty, this function will return `None`.
/// ```rust
/// let duration_in_traffic_text = leg.get_duration_in_traffic_text();
/// ```
#[must_use]
pub fn get_duration_in_traffic_text(&self) -> Option<&String> {
self.duration_in_traffic
.as_ref()
.map(|duration| &duration.text)
} // fn
/// A helper function for destructuring (or serializing) the optional
/// `duration_in_traffic` field. If the `Duration` struct is populated, this
/// function will return the _value_ field as a `time::Duration`. If the
/// _Duration_ struct is empty, this function will return `None`.
/// ```rust
/// let duration_in_traffic_value = leg.get_duration_in_traffic_value();
/// ```
#[must_use]
pub fn get_duration_in_traffic_value(&self) -> Option<i64> {
self.duration_in_traffic
.as_ref()
.map(|duration| duration.value.num_seconds())
} // fn
/// A helper function for destructuring (or serializing) the optional
/// `arrival_time` field. If the `Time` struct is populated, this function
/// will return the _text_ field as a `String`. If the _Time_ struct is
/// empty, this function will return `None`.
/// ```rust
/// let arrival_time_text = leg.get_arrival_time_text();
/// ```
#[must_use]
pub fn get_arrival_time_text(&self) -> Option<&String> {
self.arrival_time.as_ref().map(|time| &time.text)
} // fn
/// A helper function for destructuring (or serializing) the optional
/// `arrival_time` field. If the `Time` struct is populated, this function
/// will return the _`time_zone`_ field as a `String` type. If the _Time_
/// struct is empty, this function will return `None`.
/// ```rust
/// let arrival_time_zone = leg.arrival_time_zone();
/// ```
#[must_use]
pub fn get_arrival_time_value(&self) -> Option<i64> {
self.arrival_time
.as_ref()
.map(|time| time.value.and_utc().timestamp())
} // fn
/// A helper function for destructuring (or serializing) the optional
/// `arrival_time` field. If the `Time` struct is populated, this function
/// will return the _time_ field as a `i64` UNIX timestamp. If the _Time_
/// struct is empty, this function will return `None`.
/// ```rust
/// let arrival_time_zone = leg.arrival_time_zone();
/// ```
#[must_use]
pub fn get_arrival_time_zone(&self) -> Option<String> {
self.arrival_time
.as_ref()
.map(|time| time.time_zone.name().to_string())
} // fn
/// A helper function for destructuring (or serializing) the optional
/// `departure_time` field. If the `Time` struct is populated, this function
/// will return the _text_ field as a `String`. If the _Time_ struct is
/// empty, this function will return `None`.
/// ```rust
/// let departure_time_text = leg.get_departure_time_text();
/// ```
#[must_use]
pub fn get_departure_time_text(&self) -> Option<&String> {
self.departure_time.as_ref().map(|time| &time.text)
} // fn
/// A helper function for destructuring (or serializing) the optional
/// `departure_time` field. If the `Time` struct is populated, this function
/// will return the _`time_zone`_ field as a `String` type. If the _Time_
/// struct is empty, this function will return `None`.
/// ```rust
/// let departure_time_zone = leg.departure_time_zone();
/// ```
#[must_use]
pub fn get_departure_time_value(&self) -> Option<i64> {
self.departure_time
.as_ref()
.map(|time| time.value.and_utc().timestamp())
} // fn
/// A helper function for destructuring (or serializing) the optional
/// `departure_time` field. If the `Time` struct is populated, this function
/// will return the _time_ field as a `i64` UNIX timestamp. If the _Time_
/// struct is empty, this function will return `None`.
/// ```rust
/// let departure_time_zone = leg.departure_time_zone();
/// ```
#[must_use]
pub fn get_departure_time_zone(&self) -> Option<String> {
self.departure_time
.as_ref()
.map(|time| time.time_zone.name().to_string())
} // fn
} // impl