everymap-providers-google 0.2.1

Google Maps provider for EveryMap — geocoding, routing, map matching, 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
80

use async_trait::async_trait;
use everymap_core::error::EveryMapResult;

/// Extension trait for Google-specific positioning capabilities.
///
/// Provides access to the rich Google Geolocation API response type,
/// which includes more detail than the core `PositioningResponse`.
///
/// ```ignore
/// use everymap_providers_google::GooglePositionerExt;
/// let result = positioner.locate(google_options).await?;
/// ```
#[async_trait]
pub trait GooglePositionerExt: Send + Sync {
    /// Get a position estimate with rich Google response type.
    /// POST /geolocation/v1/geolocate
    async fn locate(
        &self,
        options: super::domain::positioning::GooglePositioningOptions,
    ) -> EveryMapResult<super::domain::positioning::GoogleGeolocationResponse>;
}

/// Extension trait for Google-specific attribute capabilities.
///
/// Provides typed access to the Roads API speedLimits endpoints,
/// which return more detail than the core `AttributeResponse`.
///
/// ```ignore
/// use everymap_providers_google::GoogleAttributeExt;
/// let limits = provider.get_speed_limits_by_ids(&place_ids, None).await?;
/// ```
#[async_trait]
pub trait GoogleAttributeExt: Send + Sync {
    /// Get speed limits by place IDs.
    /// GET /v1/speedLimits?placeId=...&placeId=...&units=...
    async fn get_speed_limits_by_ids(
        &self,
        place_ids: &[String],
        units: Option<&str>,
    ) -> EveryMapResult<super::domain::attributes::GoogleSpeedLimitsResponse>;

    /// Get speed limits along a path (snapped to roads).
    /// GET /v1/speedLimits?path=...&units=...
    async fn get_speed_limits_along_path(
        &self,
        path: &str,
        units: Option<&str>,
    ) -> EveryMapResult<super::domain::attributes::GoogleSpeedLimitsResponse>;
}

// --- Extension trait implementations ---

#[async_trait]
impl GooglePositionerExt for super::domain::positioning::GooglePositioner {
    async fn locate(
        &self,
        options: super::domain::positioning::GooglePositioningOptions,
    ) -> EveryMapResult<super::domain::positioning::GoogleGeolocationResponse> {
        self.locate(options).await
    }
}

#[async_trait]
impl GoogleAttributeExt for super::domain::attributes::GoogleAttributeProvider {
    async fn get_speed_limits_by_ids(
        &self,
        place_ids: &[String],
        units: Option<&str>,
    ) -> EveryMapResult<super::domain::attributes::GoogleSpeedLimitsResponse> {
        self.get_speed_limits_by_ids(place_ids, units).await
    }

    async fn get_speed_limits_along_path(
        &self,
        path: &str,
        units: Option<&str>,
    ) -> EveryMapResult<super::domain::attributes::GoogleSpeedLimitsResponse> {
        self.get_speed_limits_along_path(path, units).await
    }
}