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

//! Contains the `Bounds` struct and its associated traits. It is used to
//! specify a selection or bounding box over a geographic area using two
//! latitude & longitude pairs.

#[cfg(feature = "geo")]
mod geo;

// -----------------------------------------------------------------------------

use crate::types::error::Error as GoogleMapsError;
use crate::types::error::Error as TypeError;
use crate::types::latlng::LatLng;
use serde::{Deserialize, Serialize};

// -----------------------------------------------------------------------------

/// Contains the recommended viewport for displaying the returned result,
/// specified as two latitude & longitude pairs defining the southwest and
/// northeast corner of the viewport bounding box. Generally the viewport is
/// used to frame a result when displaying it to a user.

#[derive(Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd, Serialize, Deserialize)]
pub struct Bounds {
    /// South-west or bottom-left corner of the bounding box.
    pub southwest: LatLng,
    /// North-east or top-right corner of the bounding box.
    pub northeast: LatLng,
} // struct

// -----------------------------------------------------------------------------

impl std::fmt::Display for Bounds {
    /// Converts a `Bounds` struct to a `String` that contains two
    /// latitude & longitude pairs that represent a bounding box.
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(
            f,
            "{},{}|{},{}",
            self.southwest.lat, self.southwest.lng, self.northeast.lat, self.northeast.lng,
        ) // write!
    } // fn
} // impl

// -----------------------------------------------------------------------------

impl std::convert::From<&Self> for Bounds {
    /// Converts a borrowed `&Bounds` enum into an owned `Bounds` enum by
    /// copying it.
    fn from(bounds: &Self) -> Self {
        *bounds
    } // fn
} // impl

// -----------------------------------------------------------------------------

impl std::convert::From<&Bounds> for String {
    /// Converts a `Bounds` struct to a `String` that contains two
    /// latitude & longitude pairs that represent a bounding box.
    fn from(bounds: &Bounds) -> Self {
        bounds.to_string()
    } // fn
} // impl

// -----------------------------------------------------------------------------

impl std::str::FromStr for Bounds {
    // Error definitions are contained in the `type_error.rs` module.
    type Err = GoogleMapsError;
    /// Gets a `Bounds` struct from a `String` that contains two pipe-delimited
    /// latitude & longitude pairs.
    fn from_str(value: &str) -> Result<Self, Self::Err> {
        let corner: Vec<&str> = value.trim().split('|').collect();
        if corner.len() == 2 {
            let southwest = LatLng::from_str(corner[0].trim());
            let southwest =
                southwest.map_err(|_| TypeError::InvalidBoundsString(value.to_owned()))?;
            let northeast = LatLng::from_str(corner[1].trim());
            let northeast =
                northeast.map_err(|_| TypeError::InvalidBoundsString(value.to_owned()))?;
            Ok(Self {
                southwest,
                northeast,
            })
        } else {
            Err(TypeError::InvalidBoundsString(value.to_owned()))?
        } // if
    } // fn
} // impl