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
use crate::{geocoding::error::Error, geocoding::forward::ForwardRequest};
use percent_encoding::{utf8_percent_encode, NON_ALPHANUMERIC};
impl<'a> ForwardRequest<'a> {
/// Builds the query string for the Google Maps Geocoding API based on the
/// input provided by the client.
///
/// ## Arguments
///
/// This method accepts no arguments.
pub fn build(&mut self) -> Result<&'a mut ForwardRequest, Error> {
// Ensure request has been validated before building the query string:
if !self.validated {
return Err(Error::RequestNotValidated);
}
// This section builds the "required parameters" portion of the query
// string:
let mut query = format!("key={}", self.client.key);
// This section builds the "optional parameters" portion of the query
// string:
// Address key/value pair:
if let Some(address) = &self.address {
query.push_str("&address=");
query.push_str(
&utf8_percent_encode(&String::from(address), NON_ALPHANUMERIC).to_string(),
);
}
// Place Id key/value pair:
if let Some(place_id) = &self.place_id {
query.push_str("&place_id=");
query.push_str(
&utf8_percent_encode(&String::from(place_id), NON_ALPHANUMERIC).to_string(),
);
}
// Bounds key/value pair:
if let Some(bounds) = &self.bounds {
query.push_str("&bounds=");
query.push_str(
&utf8_percent_encode(&String::from(bounds), NON_ALPHANUMERIC).to_string(),
);
}
// Components key/value pair:
if !self.components.is_empty() {
query.push_str("&components=");
query.push_str(
&utf8_percent_encode(
&self
.components
.iter()
.map(String::from)
.collect::<Vec<String>>()
.join("|"),
NON_ALPHANUMERIC,
)
.to_string(),
); // push_str
}
// Language key/value pair:
if let Some(language) = &self.language {
query.push_str("&language=");
query.push_str(&String::from(language));
}
// Region key/value pair:
if let Some(region) = &self.region {
query.push_str("®ion=");
query.push_str(&String::from(region));
}
// Set query string in ForwardRequest struct.
self.query = Some(query);
// Return modified ForwardRequest struct to caller.
Ok(self)
} // fn
} // impl