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
use crate::directions::request::{unit_system::UnitSystem, Request};
impl<'a> Request<'a> {
/// Specifies the unit system to use when displaying results.
///
/// ## Arguments
///
/// * `unit_system` ‧ The measurement system the directions service should
/// supply in the response, _imperial_ or _metric_?
///
/// ## Description
///
/// [Unit Systems](https://developers.google.com/maps/documentation/directions/intro#UnitSystems)
///
/// Directions results contain `text` within `distance` fields that may be
/// displayed to the user to indicate the distance of a particular "step" of
/// the route. By default, this text uses the unit system of the origin's
/// country or region.
///
/// For example, a route from "Chicago, IL" to "Toronto, ONT" will display
/// results in miles, while the reverse route will display results in
/// kilometers. You may override this unit system by setting one explicitly
/// within the request's `unit_system` parameter, passing one of the
/// following values:
///
/// * `UnitSystem::Metric` specifies usage of the metric system. Textual
/// distances are returned using kilometers and meters.
///
/// * `UnitSystem::Imperial` specifies usage of the Imperial (English) system.
/// Textual distances are returned using miles and feet.
///
/// *Note*: this unit system setting only affects the `text` displayed
/// within `distance` fields. The `distance` fields also contain `values`
/// which are always expressed in meters.
///
/// ## Example
///
/// * Force unit system to Metric:
/// ```
/// .with_unit_system(UnitSystem::Metric)
/// ```
pub fn with_unit_system(&'a mut self, unit_system: UnitSystem) -> &mut Self {
self.unit_system = Some(unit_system);
self
} // fn
} // impl