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

use crate::client::GoogleMapsClient;
use crate::geocoding::reverse::ReverseRequest;
use crate::latlng::LatLng;

// =============================================================================

impl<'a> ReverseRequest<'a> {

    // -------------------------------------------------------------------------
    //
    /// Initializes the builder pattern for a Geolocation API query with the
    /// required, non-optional parameters.
    ///
    /// # Arguments:
    ///
    /// * `client` ‧ Your application's Google Maps API client struct.
    /// * `latlng` ‧ The latitude and longitude values specifying the location
    /// for which you wish to obtain the closest, human-readable address.

    pub fn new(
        client: &'a GoogleMapsClient,
        latlng: LatLng
    ) -> ReverseRequest<'a> {

        // Instantiate struct and return it to caller:
        ReverseRequest {
            // Required parameters:
            client,
            latlng,
            // Optional parameters:
            language: None,
            location_types: None,
            result_types: None,
            // Internal use only:
            query: None,
        } // struct

    } // fn

    // -------------------------------------------------------------------------
    //
    /// Initializes the builder pattern for a Geolocation API query with the
    /// required, non-optional parameters.
    ///
    /// This function is the same as `new` but it supports
    /// the [geo](https://crates.io/crates/geo) crate's
    /// [Coordinate](https://docs.rs/geo/latest/geo/geometry/struct.Coordinate.html) type.
    ///
    /// # Arguments:
    ///
    /// * `client` ‧ Your application's Google Maps API client struct.
    /// * `coordinate` ‧ The `Coordinate` specifying the location for which you
    /// wish to obtain the closest, human-readable address.

    #[cfg(feature = "geo")]
    pub fn try_new_coordinate(
        client: &'a GoogleMapsClient,
        coordinate: &geo_types::Coordinate,
    ) -> Result<ReverseRequest<'a>, crate::error::Error> {

        // Instantiate struct and return it to caller:
        Ok(ReverseRequest {
            // Required parameters:
            client,
            latlng: LatLng::try_from(coordinate)?,
            // Optional parameters:
            language: None,
            location_types: None,
            result_types: None,
            // Internal use only:
            query: None,
        }) // struct

    } // fn

    // -------------------------------------------------------------------------
    //
    /// Initializes the builder pattern for a Geolocation API query with the
    /// required, non-optional parameters.
    ///
    /// This function is the same as `new` but it supports
    /// the [geo](https://crates.io/crates/geo) crate's
    /// [Point](https://docs.rs/geo/latest/geo/geometry/struct.Point.html) type.
    ///
    /// # Arguments:
    ///
    /// * `client` ‧ Your application's Google Maps API client struct.
    /// * `point` ‧ The `Point` specifying the location for which you wish to
    /// obtain the closest, human-readable address.

    #[cfg(feature = "geo")]
    pub fn try_new_point(
        client: &'a GoogleMapsClient,
        point: &geo_types::Point,
    ) -> Result<ReverseRequest<'a>, crate::error::Error> {

        // Instantiate struct and return it to caller:
        Ok(ReverseRequest {
            // Required parameters:
            client,
            latlng: LatLng::try_from(point)?,
            // Optional parameters:
            language: None,
            location_types: None,
            result_types: None,
            // Internal use only:
            query: None,
        }) // struct

    } // fn

} // impl