Struct Location 

pub struct Location {
    pub lat_lng: LatLng,
    pub heading: Option<u32>,
}

Encapsulates a location (a geographic point, and an optional heading).
See https://developers.google.com/maps/documentation/routes/reference/rest/v2/Location

Fields

lat_lng: LatLng

heading: Option<u32>

Heading values can be from 0 to 360, where 0 specifies a heading of due North, 90 specifies a heading of due East, and so on. You can use this field only for DRIVE and TWO_WHEELER RouteTravelMode.

Implementations

impl Location

pub fn new(latitude: f32, longitude: f32, heading: Option<u32>) -> Self

Create a Location at a geographic point, and an optional heading

Examples found in repository

examples/route_service.rs (line 31)

async fn get_route() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut route_service = RouteService::new_with_api_key(api_key);

    let masks = vec!["routes.duration", "routes.distanceMeters"];
    let origin = WayPoint::new_from_location(Location::new(37.419734, -122.0827784, None), None)?;
    let destination = WayPoint::new_from_location(Location::new(35.419734, -100.0827784, None), None)?;

    let mut mid_waypoint_option: HashMap<String, Value> = HashMap::new();
    mid_waypoint_option.insert("via".to_string(), true.into());

    let mut route_option: HashMap<String, Value> = HashMap::new();
    // let mid_waypoint = WayPoint::new_from_place_id("ChIJgUbEo8cfqokR5lP9_Wh_DaM", Some(mid_waypoint_option))?;
    // route_option.insert("intermediates".to_owned(), serde_json::to_value(vec![mid_waypoint.clone()])?);
    route_option.insert("travelMode".to_owned(), serde_json::to_value(RouteTravelMode::Drive)?);
    route_option.insert("routingPreference".to_owned(), serde_json::to_value(RoutingPreference::TrafficAwareOptimal)?);
    // route_option.insert("departureTime".to_owned(), serde_json::to_value(Utc::now() + Duration::seconds(60 * 60 * 24))?);
    // let route_modifiers = RouteModifiers::new(Some(true), Some(true), Some(true), None, None, None);
    // route_option.insert("routeModifiers".to_owned(), serde_json::to_value(route_modifiers)?);
    // route_option.insert("requestedReferenceRoutes".to_owned(), serde_json::to_value(vec![ReferenceRoute::FuelEfficient])?);
    let transit_preference = TransitPreferences::new(Some(vec![TransitTravelMode::Bus]), None);
    route_option.insert("transitPreferences".to_owned(), serde_json::to_value(transit_preference)?);

    let response = route_service.get_route(&origin, &destination, Some(masks.clone()), Some(route_option.clone())).await?;
    println!("response: {}", serde_json::to_string_pretty(&response)?);


    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut route_service = RouteService::new_with_credentials(credentials);
    let response = route_service.get_route(&origin, &destination, Some(masks.clone()), Some(route_option.clone())).await?;
    println!("response: {}", serde_json::to_string(&response)?);

    Ok(())
}


async fn get_route_matrix() -> Result<()> {
    dotenv().ok();

    // api auth
    let api_key = env::var("API_KEY")?;
    let mut route_service = RouteService::new_with_api_key(api_key);

    let masks = vec!["originIndex", "destinationIndex", "status", "condition", "distanceMeters", "duration"];
    let origin = WayPoint::new_from_location(Location::new(37.419734, -122.0827784, None), None)?;
    let destination = WayPoint::new_from_location(Location::new(35.419734, -100.0827784, None), None)?;

    let mut route_option: HashMap<String, Value> = HashMap::new();
    // let mid_waypoint = WayPoint::new_from_place_id("ChIJgUbEo8cfqokR5lP9_Wh_DaM", Some(mid_waypoint_option))?;
    // route_option.insert("intermediates".to_owned(), serde_json::to_value(vec![mid_waypoint.clone()])?);
    route_option.insert("travelMode".to_owned(), serde_json::to_value(RouteTravelMode::Drive)?);

    let response = route_service.get_route_matrix(&vec![RouteMatrixOrigin::new(&origin)], &vec![RouteMatrixOrigin::new(&destination)], Some(masks.clone()), Some(route_option.clone())).await?;
    println!("response: {}", serde_json::to_string_pretty(&response)?);


    // service account auth
    let filepath: PathBuf = PathBuf::from_str("credentials.json")?;
    let credentials = ServiceAccountCredentials::from_service_account_file(filepath)?;
    let mut route_service = RouteService::new_with_credentials(credentials);
    let response = route_service.get_route_matrix(&vec![RouteMatrixOrigin::new(&origin)], &vec![RouteMatrixOrigin::new(&destination)], Some(masks.clone()), Some(route_option.clone())).await?;
    println!("response: {}", serde_json::to_string_pretty(&response)?);

    Ok(())
}

Trait Implementations

impl Clone for Location

fn clone(&self) -> Location

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Location

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Location

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Location

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.