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
//! Contains the `Api` enum and its associated traits. The `Api` enum is used to
//! specify a Google Maps Platform API when setting per-API request rate limits.
use serde::{Deserialize, Serialize};
// -----------------------------------------------------------------------------
//
/// `Api` is used to select an API to configure. For example, the Google Maps
/// Client can be set to have different request rates for `Directions` and
/// `Elevation` requests. This `enum` is used to select which Google Maps API
/// you would like to configure.
#[derive(Clone, Debug, Eq, Hash, Ord, PartialEq, PartialOrd, Serialize, Deserialize)]
pub enum Api {
/// This variant is used to select settings that are observed for _all_
/// APIs. These settings are observed in addition to the per-API settings.
All,
Directions,
DistanceMatrix,
Elevation,
Geocoding,
TimeZone,
Places,
Roads,
} // enum
// -----------------------------------------------------------------------------
impl std::convert::From<&Api> for String {
/// Converts an `Api` enum to a `String` that contains an API name.
fn from(api: &Api) -> Self {
match api {
Api::All => Self::from("All"),
Api::Directions => Self::from("Directions"),
Api::DistanceMatrix => Self::from("Distance Matrix"),
Api::Elevation => Self::from("Elevation"),
Api::Geocoding => Self::from("Geocoding"),
Api::TimeZone => Self::from("Time Zone"),
Api::Places => Self::from("Places"),
Api::Roads => Self::from("Roads"),
} // match
} // fn
} // impl
// -----------------------------------------------------------------------------
impl std::default::Default for Api {
/// Returns a reasonable default variant for the `Api` enum.
fn default() -> Self {
Self::All
} // fn
} // impl
// -----------------------------------------------------------------------------
impl std::fmt::Display for Api {
/// Formats an `Api` enum into a string that is presentable to the end user.
fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
write!(f, "{}", String::from(self))
} // fn
} // impl