everymap-providers-mapbox 0.2.1

MapBox provider for EveryMap — geocoding, routing, static maps, and more
Documentation 
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

use everymap_core::domains::matching::MatchedPoint;
use everymap_core::types::Coordinate;
use serde::{Deserialize, Serialize};

impl From<MapBoxTracepoint> for MatchedPoint {
    fn from(tp: MapBoxTracepoint) -> Self {
        let coordinate = tp
            .location
            .as_ref()
            .and_then(|loc| {
                if loc.len() >= 2 {
                    Some(Coordinate::new(loc[1], loc[0]).unwrap_or(Coordinate::ORIGIN))
                } else {
                    None
                }
            })
            .unwrap_or(Coordinate::ORIGIN);

        MatchedPoint {
            coordinate,
            confidence: tp.distance.map(|d| 1.0 - (d / 100.0).min(1.0)),
            road_name: tp.name,
        }
    }
}

/// Response from MapBox Map Matching API v5.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct MapBoxMatchResponse {
    #[serde(default, rename = "code")]
    pub code: Option<String>,
    #[serde(default)]
    pub matchings: Vec<MapBoxMatching>,
    #[serde(default)]
    pub tracepoints: Vec<MapBoxTracepoint>,
}

/// A matched route from MapBox Map Matching.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct MapBoxMatching {
    #[serde(default, rename = "confidence")]
    pub confidence: Option<f64>,
    #[serde(default, rename = "distance")]
    pub distance: f64,
    #[serde(default, rename = "duration")]
    pub duration: f64,
    #[serde(default, rename = "geometry")]
    pub geometry: Option<String>,
    #[serde(default)]
    pub legs: Vec<MapBoxMatchLeg>,
}

/// A leg in a matched route.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct MapBoxMatchLeg {
    #[serde(default, rename = "distance")]
    pub distance: f64,
    #[serde(default, rename = "duration")]
    pub duration: f64,
    #[serde(default)]
    pub steps: Vec<serde_json::Value>,
}

/// A tracepoint from MapBox Map Matching.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct MapBoxTracepoint {
    /// Waypoint index in the original trace.
    #[serde(default, rename = "waypoint_index")]
    pub waypoint_index: Option<u64>,
    /// Matched location as [lng, lat].
    #[serde(default)]
    pub location: Option<Vec<f64>>,
    /// Name of the matched road.
    #[serde(default, rename = "name")]
    pub name: Option<String>,
    /// Distance from the original point to the matched point (meters).
    #[serde(default, rename = "distance")]
    pub distance: Option<f64>,
}