google-maps-navconnect-v1 1.0.0

// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// Code generated by sidekick. DO NOT EDIT.

#![allow(rustdoc::bare_urls)]
#![allow(rustdoc::broken_intra_doc_links)]
#![allow(rustdoc::invalid_html_tags)]
#![allow(rustdoc::redundant_explicit_links)]
#![no_implicit_prelude]
extern crate async_trait;
extern crate bytes;
extern crate gaxi;
extern crate google_cloud_gax;
extern crate google_cloud_type;
extern crate serde;
extern crate serde_json;
extern crate serde_with;
extern crate std;
extern crate tracing;
extern crate wkt;

mod debug;
mod deserialize;
mod serialize;

/// A trip.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Trip {
    /// Output only. Identifier. The resource name of the trip.
    /// Format: projects/{project_number}/trips/{trip_id}.
    pub name: std::string::String,

    /// Immutable. The configuration for the trip.
    pub config: std::option::Option<crate::model::TripConfig>,

    /// Input only. Immutable. The Android application ID of the mobile application
    /// that will use the trip. At least one of `android_app_id` or `ios_app_id`
    /// must be set.
    pub android_app_id: std::string::String,

    /// Input only. Immutable. The iOS bundle ID of the mobile application that
    /// will use the trip. At least one of `android_app_id` or `ios_app_id` must be
    /// set.
    pub ios_app_id: std::string::String,

    /// Output only. An opaque token that authorizes access to begin a NavConnect
    /// trip in Google Maps or Waze and grants these applications access to update
    /// the trip. Only returned by `CreateTrip`.
    pub auth_token: std::option::Option<crate::model::AuthToken>,

    /// Output only. The Trip state.
    pub state: crate::model::trip::State,

    /// Output only. The latest data about the execution of the trip. This may not
    /// be set if the trip is in an error state.
    pub execution: std::option::Option<crate::model::TripExecution>,

    /// Output only. Time according to the server when the trip was created.
    pub create_time: std::option::Option<wkt::Timestamp>,

    /// Output only. Time at which the server received the latest trip update.
    pub update_time: std::option::Option<wkt::Timestamp>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Trip {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::Trip::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// # let project_id = "project_id";
    /// # let trip_id = "trip_id";
    /// let x = Trip::new().set_name(format!("projects/{project_id}/trips/{trip_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }

    /// Sets the value of [config][crate::model::Trip::config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use google_maps_navconnect_v1::model::TripConfig;
    /// let x = Trip::new().set_config(TripConfig::default()/* use setters */);
    /// ```
    pub fn set_config<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TripConfig>,
    {
        self.config = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [config][crate::model::Trip::config].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use google_maps_navconnect_v1::model::TripConfig;
    /// let x = Trip::new().set_or_clear_config(Some(TripConfig::default()/* use setters */));
    /// let x = Trip::new().set_or_clear_config(None::<TripConfig>);
    /// ```
    pub fn set_or_clear_config<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TripConfig>,
    {
        self.config = v.map(|x| x.into());
        self
    }

    /// Sets the value of [android_app_id][crate::model::Trip::android_app_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// let x = Trip::new().set_android_app_id("example");
    /// ```
    pub fn set_android_app_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.android_app_id = v.into();
        self
    }

    /// Sets the value of [ios_app_id][crate::model::Trip::ios_app_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// let x = Trip::new().set_ios_app_id("example");
    /// ```
    pub fn set_ios_app_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.ios_app_id = v.into();
        self
    }

    /// Sets the value of [auth_token][crate::model::Trip::auth_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use google_maps_navconnect_v1::model::AuthToken;
    /// let x = Trip::new().set_auth_token(AuthToken::default()/* use setters */);
    /// ```
    pub fn set_auth_token<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::AuthToken>,
    {
        self.auth_token = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [auth_token][crate::model::Trip::auth_token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use google_maps_navconnect_v1::model::AuthToken;
    /// let x = Trip::new().set_or_clear_auth_token(Some(AuthToken::default()/* use setters */));
    /// let x = Trip::new().set_or_clear_auth_token(None::<AuthToken>);
    /// ```
    pub fn set_or_clear_auth_token<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::AuthToken>,
    {
        self.auth_token = v.map(|x| x.into());
        self
    }

    /// Sets the value of [state][crate::model::Trip::state].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use google_maps_navconnect_v1::model::trip::State;
    /// let x0 = Trip::new().set_state(State::New);
    /// let x1 = Trip::new().set_state(State::Enroute);
    /// let x2 = Trip::new().set_state(State::Arrived);
    /// ```
    pub fn set_state<T: std::convert::Into<crate::model::trip::State>>(mut self, v: T) -> Self {
        self.state = v.into();
        self
    }

    /// Sets the value of [execution][crate::model::Trip::execution].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use google_maps_navconnect_v1::model::TripExecution;
    /// let x = Trip::new().set_execution(TripExecution::default()/* use setters */);
    /// ```
    pub fn set_execution<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::TripExecution>,
    {
        self.execution = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [execution][crate::model::Trip::execution].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use google_maps_navconnect_v1::model::TripExecution;
    /// let x = Trip::new().set_or_clear_execution(Some(TripExecution::default()/* use setters */));
    /// let x = Trip::new().set_or_clear_execution(None::<TripExecution>);
    /// ```
    pub fn set_or_clear_execution<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::TripExecution>,
    {
        self.execution = v.map(|x| x.into());
        self
    }

    /// Sets the value of [create_time][crate::model::Trip::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use wkt::Timestamp;
    /// let x = Trip::new().set_create_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_create_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [create_time][crate::model::Trip::create_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use wkt::Timestamp;
    /// let x = Trip::new().set_or_clear_create_time(Some(Timestamp::default()/* use setters */));
    /// let x = Trip::new().set_or_clear_create_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_create_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.create_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [update_time][crate::model::Trip::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use wkt::Timestamp;
    /// let x = Trip::new().set_update_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_update_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [update_time][crate::model::Trip::update_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Trip;
    /// use wkt::Timestamp;
    /// let x = Trip::new().set_or_clear_update_time(Some(Timestamp::default()/* use setters */));
    /// let x = Trip::new().set_or_clear_update_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_update_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.update_time = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for Trip {
    fn typename() -> &'static str {
        "type.googleapis.com/google.maps.navconnect.v1.Trip"
    }
}

/// Defines additional types related to [Trip].
pub mod trip {
    #[allow(unused_imports)]
    use super::*;

    /// All possible trip states.
    ///
    /// # Working with unknown values
    ///
    /// This enum is defined as `#[non_exhaustive]` because Google Cloud may add
    /// additional enum variants at any time. Adding new variants is not considered
    /// a breaking change. Applications should write their code in anticipation of:
    ///
    /// - New values appearing in future releases of the client library, **and**
    /// - New values received dynamically, without application changes.
    ///
    /// Please consult the [Working with enums] section in the user guide for some
    /// guidelines.
    ///
    /// [Working with enums]: https://googleapis.github.io/google-cloud-rust/working_with_enums.html
    #[derive(Clone, Debug, PartialEq)]
    #[non_exhaustive]
    pub enum State {
        /// The trip state is unspecified.
        Unspecified,
        /// The trip was created but has not yet started.
        New,
        /// The transporter is enroute to the destination.
        Enroute,
        /// The transporter arrived at the destination.
        Arrived,
        /// The trip was suspended.
        Suspended,
        /// The trip failed to complete successfully.
        Failed,
        /// The trip failed due to a client error.
        ClientError,
        /// If set, the enum was initialized with an unknown value.
        ///
        /// Applications can examine the value using [State::value] or
        /// [State::name].
        UnknownValue(state::UnknownValue),
    }

    #[doc(hidden)]
    pub mod state {
        #[allow(unused_imports)]
        use super::*;
        #[derive(Clone, Debug, PartialEq)]
        pub struct UnknownValue(pub(crate) wkt::internal::UnknownEnumValue);
    }

    impl State {
        /// Gets the enum value.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the string representation of enums.
        pub fn value(&self) -> std::option::Option<i32> {
            match self {
                Self::Unspecified => std::option::Option::Some(0),
                Self::New => std::option::Option::Some(1),
                Self::Enroute => std::option::Option::Some(2),
                Self::Arrived => std::option::Option::Some(3),
                Self::Suspended => std::option::Option::Some(4),
                Self::Failed => std::option::Option::Some(5),
                Self::ClientError => std::option::Option::Some(6),
                Self::UnknownValue(u) => u.0.value(),
            }
        }

        /// Gets the enum value as a string.
        ///
        /// Returns `None` if the enum contains an unknown value deserialized from
        /// the integer representation of enums.
        pub fn name(&self) -> std::option::Option<&str> {
            match self {
                Self::Unspecified => std::option::Option::Some("STATE_UNSPECIFIED"),
                Self::New => std::option::Option::Some("NEW"),
                Self::Enroute => std::option::Option::Some("ENROUTE"),
                Self::Arrived => std::option::Option::Some("ARRIVED"),
                Self::Suspended => std::option::Option::Some("SUSPENDED"),
                Self::Failed => std::option::Option::Some("FAILED"),
                Self::ClientError => std::option::Option::Some("CLIENT_ERROR"),
                Self::UnknownValue(u) => u.0.name(),
            }
        }
    }

    impl std::default::Default for State {
        fn default() -> Self {
            use std::convert::From;
            Self::from(0)
        }
    }

    impl std::fmt::Display for State {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
            wkt::internal::display_enum(f, self.name(), self.value())
        }
    }

    impl std::convert::From<i32> for State {
        fn from(value: i32) -> Self {
            match value {
                0 => Self::Unspecified,
                1 => Self::New,
                2 => Self::Enroute,
                3 => Self::Arrived,
                4 => Self::Suspended,
                5 => Self::Failed,
                6 => Self::ClientError,
                _ => Self::UnknownValue(state::UnknownValue(
                    wkt::internal::UnknownEnumValue::Integer(value),
                )),
            }
        }
    }

    impl std::convert::From<&str> for State {
        fn from(value: &str) -> Self {
            use std::string::ToString;
            match value {
                "STATE_UNSPECIFIED" => Self::Unspecified,
                "NEW" => Self::New,
                "ENROUTE" => Self::Enroute,
                "ARRIVED" => Self::Arrived,
                "SUSPENDED" => Self::Suspended,
                "FAILED" => Self::Failed,
                "CLIENT_ERROR" => Self::ClientError,
                _ => Self::UnknownValue(state::UnknownValue(
                    wkt::internal::UnknownEnumValue::String(value.to_string()),
                )),
            }
        }
    }

    impl serde::ser::Serialize for State {
        fn serialize<S>(&self, serializer: S) -> std::result::Result<S::Ok, S::Error>
        where
            S: serde::Serializer,
        {
            match self {
                Self::Unspecified => serializer.serialize_i32(0),
                Self::New => serializer.serialize_i32(1),
                Self::Enroute => serializer.serialize_i32(2),
                Self::Arrived => serializer.serialize_i32(3),
                Self::Suspended => serializer.serialize_i32(4),
                Self::Failed => serializer.serialize_i32(5),
                Self::ClientError => serializer.serialize_i32(6),
                Self::UnknownValue(u) => u.0.serialize(serializer),
            }
        }
    }

    impl<'de> serde::de::Deserialize<'de> for State {
        fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
        where
            D: serde::Deserializer<'de>,
        {
            deserializer.deserialize_any(wkt::internal::EnumVisitor::<State>::new(
                ".google.maps.navconnect.v1.Trip.State",
            ))
        }
    }
}

/// Configuration for the trip.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct TripConfig {
    /// Optional. Whether to enable high frequency trip updates.
    ///
    /// NOTE: Enabling this feature logs the trip under Enterprise Tier usage, and
    /// is subject to Enterprise Tier rates.
    pub enable_high_frequency_updates: bool,

    /// Optional. Whether to enable pubsub notifications for the trip.
    pub enable_pubsub: bool,

    /// Optional. If set, only the specified subset of the Trip fields will be
    /// included in the pubsub notifications.
    ///
    /// If not set, all Trip fields will be included in the pubsub notifications
    /// (default behavior).
    ///
    /// The following fields are not supported:
    ///
    /// * `android_app_id`
    /// * `ios_app_id`
    /// * `auth_token`
    /// * `config`
    ///
    /// NOTE: This field is ignored if `enable_pubsub` is false.
    pub pubsub_field_mask: std::option::Option<wkt::FieldMask>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl TripConfig {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [enable_high_frequency_updates][crate::model::TripConfig::enable_high_frequency_updates].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripConfig;
    /// let x = TripConfig::new().set_enable_high_frequency_updates(true);
    /// ```
    pub fn set_enable_high_frequency_updates<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enable_high_frequency_updates = v.into();
        self
    }

    /// Sets the value of [enable_pubsub][crate::model::TripConfig::enable_pubsub].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripConfig;
    /// let x = TripConfig::new().set_enable_pubsub(true);
    /// ```
    pub fn set_enable_pubsub<T: std::convert::Into<bool>>(mut self, v: T) -> Self {
        self.enable_pubsub = v.into();
        self
    }

    /// Sets the value of [pubsub_field_mask][crate::model::TripConfig::pubsub_field_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripConfig;
    /// use wkt::FieldMask;
    /// let x = TripConfig::new().set_pubsub_field_mask(FieldMask::default()/* use setters */);
    /// ```
    pub fn set_pubsub_field_mask<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.pubsub_field_mask = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [pubsub_field_mask][crate::model::TripConfig::pubsub_field_mask].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripConfig;
    /// use wkt::FieldMask;
    /// let x = TripConfig::new().set_or_clear_pubsub_field_mask(Some(FieldMask::default()/* use setters */));
    /// let x = TripConfig::new().set_or_clear_pubsub_field_mask(None::<FieldMask>);
    /// ```
    pub fn set_or_clear_pubsub_field_mask<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::FieldMask>,
    {
        self.pubsub_field_mask = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for TripConfig {
    fn typename() -> &'static str {
        "type.googleapis.com/google.maps.navconnect.v1.TripConfig"
    }
}

/// An authentication token.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct AuthToken {
    /// Output only. The authentication token that should be passed to the mobile
    /// application.
    pub token: std::string::String,

    /// Output only. Time at which the authentication token will expire.
    pub expire_time: std::option::Option<wkt::Timestamp>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl AuthToken {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [token][crate::model::AuthToken::token].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::AuthToken;
    /// let x = AuthToken::new().set_token("example");
    /// ```
    pub fn set_token<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.token = v.into();
        self
    }

    /// Sets the value of [expire_time][crate::model::AuthToken::expire_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::AuthToken;
    /// use wkt::Timestamp;
    /// let x = AuthToken::new().set_expire_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_expire_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.expire_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [expire_time][crate::model::AuthToken::expire_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::AuthToken;
    /// use wkt::Timestamp;
    /// let x = AuthToken::new().set_or_clear_expire_time(Some(Timestamp::default()/* use setters */));
    /// let x = AuthToken::new().set_or_clear_expire_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_expire_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.expire_time = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for AuthToken {
    fn typename() -> &'static str {
        "type.googleapis.com/google.maps.navconnect.v1.AuthToken"
    }
}

/// Data about the execution of the trip.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct TripExecution {
    /// Output only. Origin of the trip which is generally the transporter's
    /// location at start of the NavConnect trip.
    pub origin: std::option::Option<crate::model::Location>,

    /// Output only. The destination of the trip as reported by the mobile
    /// application.
    pub destination: std::option::Option<crate::model::Stop>,

    /// Output only. The location signal representing the last known location of
    /// the transporter. This will be the road snapped location if available.
    pub location: std::option::Option<crate::model::Location>,

    /// Output only. Time traveled thus far.
    pub traveled_duration: std::option::Option<wkt::Duration>,

    /// Output only. Time left on this trip as estimated by Google.
    pub remaining_duration: std::option::Option<wkt::Duration>,

    /// Output only. Distance traveled from the origin in meters.
    pub traveled_distance_meters: std::option::Option<i32>,

    /// Output only. Distance remaining to the destination in meters.
    pub remaining_distance_meters: std::option::Option<i32>,

    /// Output only. Indicates whether a stop was added along the route.
    pub stop_added_in_route: std::option::Option<bool>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl TripExecution {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [origin][crate::model::TripExecution::origin].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use google_maps_navconnect_v1::model::Location;
    /// let x = TripExecution::new().set_origin(Location::default()/* use setters */);
    /// ```
    pub fn set_origin<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Location>,
    {
        self.origin = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [origin][crate::model::TripExecution::origin].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use google_maps_navconnect_v1::model::Location;
    /// let x = TripExecution::new().set_or_clear_origin(Some(Location::default()/* use setters */));
    /// let x = TripExecution::new().set_or_clear_origin(None::<Location>);
    /// ```
    pub fn set_or_clear_origin<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Location>,
    {
        self.origin = v.map(|x| x.into());
        self
    }

    /// Sets the value of [destination][crate::model::TripExecution::destination].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use google_maps_navconnect_v1::model::Stop;
    /// let x = TripExecution::new().set_destination(Stop::default()/* use setters */);
    /// ```
    pub fn set_destination<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Stop>,
    {
        self.destination = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [destination][crate::model::TripExecution::destination].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use google_maps_navconnect_v1::model::Stop;
    /// let x = TripExecution::new().set_or_clear_destination(Some(Stop::default()/* use setters */));
    /// let x = TripExecution::new().set_or_clear_destination(None::<Stop>);
    /// ```
    pub fn set_or_clear_destination<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Stop>,
    {
        self.destination = v.map(|x| x.into());
        self
    }

    /// Sets the value of [location][crate::model::TripExecution::location].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use google_maps_navconnect_v1::model::Location;
    /// let x = TripExecution::new().set_location(Location::default()/* use setters */);
    /// ```
    pub fn set_location<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Location>,
    {
        self.location = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [location][crate::model::TripExecution::location].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use google_maps_navconnect_v1::model::Location;
    /// let x = TripExecution::new().set_or_clear_location(Some(Location::default()/* use setters */));
    /// let x = TripExecution::new().set_or_clear_location(None::<Location>);
    /// ```
    pub fn set_or_clear_location<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Location>,
    {
        self.location = v.map(|x| x.into());
        self
    }

    /// Sets the value of [traveled_duration][crate::model::TripExecution::traveled_duration].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use wkt::Duration;
    /// let x = TripExecution::new().set_traveled_duration(Duration::default()/* use setters */);
    /// ```
    pub fn set_traveled_duration<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.traveled_duration = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [traveled_duration][crate::model::TripExecution::traveled_duration].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use wkt::Duration;
    /// let x = TripExecution::new().set_or_clear_traveled_duration(Some(Duration::default()/* use setters */));
    /// let x = TripExecution::new().set_or_clear_traveled_duration(None::<Duration>);
    /// ```
    pub fn set_or_clear_traveled_duration<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.traveled_duration = v.map(|x| x.into());
        self
    }

    /// Sets the value of [remaining_duration][crate::model::TripExecution::remaining_duration].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use wkt::Duration;
    /// let x = TripExecution::new().set_remaining_duration(Duration::default()/* use setters */);
    /// ```
    pub fn set_remaining_duration<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.remaining_duration = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [remaining_duration][crate::model::TripExecution::remaining_duration].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// use wkt::Duration;
    /// let x = TripExecution::new().set_or_clear_remaining_duration(Some(Duration::default()/* use setters */));
    /// let x = TripExecution::new().set_or_clear_remaining_duration(None::<Duration>);
    /// ```
    pub fn set_or_clear_remaining_duration<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Duration>,
    {
        self.remaining_duration = v.map(|x| x.into());
        self
    }

    /// Sets the value of [traveled_distance_meters][crate::model::TripExecution::traveled_distance_meters].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// let x = TripExecution::new().set_traveled_distance_meters(42);
    /// ```
    pub fn set_traveled_distance_meters<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<i32>,
    {
        self.traveled_distance_meters = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [traveled_distance_meters][crate::model::TripExecution::traveled_distance_meters].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// let x = TripExecution::new().set_or_clear_traveled_distance_meters(Some(42));
    /// let x = TripExecution::new().set_or_clear_traveled_distance_meters(None::<i32>);
    /// ```
    pub fn set_or_clear_traveled_distance_meters<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<i32>,
    {
        self.traveled_distance_meters = v.map(|x| x.into());
        self
    }

    /// Sets the value of [remaining_distance_meters][crate::model::TripExecution::remaining_distance_meters].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// let x = TripExecution::new().set_remaining_distance_meters(42);
    /// ```
    pub fn set_remaining_distance_meters<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<i32>,
    {
        self.remaining_distance_meters = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [remaining_distance_meters][crate::model::TripExecution::remaining_distance_meters].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// let x = TripExecution::new().set_or_clear_remaining_distance_meters(Some(42));
    /// let x = TripExecution::new().set_or_clear_remaining_distance_meters(None::<i32>);
    /// ```
    pub fn set_or_clear_remaining_distance_meters<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<i32>,
    {
        self.remaining_distance_meters = v.map(|x| x.into());
        self
    }

    /// Sets the value of [stop_added_in_route][crate::model::TripExecution::stop_added_in_route].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// let x = TripExecution::new().set_stop_added_in_route(true);
    /// ```
    pub fn set_stop_added_in_route<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<bool>,
    {
        self.stop_added_in_route = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [stop_added_in_route][crate::model::TripExecution::stop_added_in_route].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::TripExecution;
    /// let x = TripExecution::new().set_or_clear_stop_added_in_route(Some(false));
    /// let x = TripExecution::new().set_or_clear_stop_added_in_route(None::<bool>);
    /// ```
    pub fn set_or_clear_stop_added_in_route<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<bool>,
    {
        self.stop_added_in_route = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for TripExecution {
    fn typename() -> &'static str {
        "type.googleapis.com/google.maps.navconnect.v1.TripExecution"
    }
}

/// A stop in the trip where some task is to be performed.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Stop {
    /// Required. The location of the stop as a lat/lng.
    pub point: std::option::Option<google_cloud_type::model::LatLng>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Stop {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [point][crate::model::Stop::point].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Stop;
    /// use google_cloud_type::model::LatLng;
    /// let x = Stop::new().set_point(LatLng::default()/* use setters */);
    /// ```
    pub fn set_point<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<google_cloud_type::model::LatLng>,
    {
        self.point = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [point][crate::model::Stop::point].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Stop;
    /// use google_cloud_type::model::LatLng;
    /// let x = Stop::new().set_or_clear_point(Some(LatLng::default()/* use setters */));
    /// let x = Stop::new().set_or_clear_point(None::<LatLng>);
    /// ```
    pub fn set_or_clear_point<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<google_cloud_type::model::LatLng>,
    {
        self.point = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for Stop {
    fn typename() -> &'static str {
        "type.googleapis.com/google.maps.navconnect.v1.Stop"
    }
}

/// A location as reported by the mobile application.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct Location {
    /// Output only. The location lat/lng.
    pub point: std::option::Option<google_cloud_type::model::LatLng>,

    /// Output only. The time when the location was sourced as denoted by the
    /// client.
    pub source_time: std::option::Option<wkt::Timestamp>,

    /// Output only. The time at which the server received this location update.
    pub server_time: std::option::Option<wkt::Timestamp>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl Location {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [point][crate::model::Location::point].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Location;
    /// use google_cloud_type::model::LatLng;
    /// let x = Location::new().set_point(LatLng::default()/* use setters */);
    /// ```
    pub fn set_point<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<google_cloud_type::model::LatLng>,
    {
        self.point = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [point][crate::model::Location::point].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Location;
    /// use google_cloud_type::model::LatLng;
    /// let x = Location::new().set_or_clear_point(Some(LatLng::default()/* use setters */));
    /// let x = Location::new().set_or_clear_point(None::<LatLng>);
    /// ```
    pub fn set_or_clear_point<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<google_cloud_type::model::LatLng>,
    {
        self.point = v.map(|x| x.into());
        self
    }

    /// Sets the value of [source_time][crate::model::Location::source_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Location;
    /// use wkt::Timestamp;
    /// let x = Location::new().set_source_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_source_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.source_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [source_time][crate::model::Location::source_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Location;
    /// use wkt::Timestamp;
    /// let x = Location::new().set_or_clear_source_time(Some(Timestamp::default()/* use setters */));
    /// let x = Location::new().set_or_clear_source_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_source_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.source_time = v.map(|x| x.into());
        self
    }

    /// Sets the value of [server_time][crate::model::Location::server_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Location;
    /// use wkt::Timestamp;
    /// let x = Location::new().set_server_time(Timestamp::default()/* use setters */);
    /// ```
    pub fn set_server_time<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.server_time = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [server_time][crate::model::Location::server_time].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::Location;
    /// use wkt::Timestamp;
    /// let x = Location::new().set_or_clear_server_time(Some(Timestamp::default()/* use setters */));
    /// let x = Location::new().set_or_clear_server_time(None::<Timestamp>);
    /// ```
    pub fn set_or_clear_server_time<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<wkt::Timestamp>,
    {
        self.server_time = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for Location {
    fn typename() -> &'static str {
        "type.googleapis.com/google.maps.navconnect.v1.Location"
    }
}

/// Request message for NavConnectService.CreateTrip.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct CreateTripRequest {
    /// Required. The parent resource under which this trip will be created.
    /// Format: projects/{project_number}
    pub parent: std::string::String,

    /// Required. The ID to use for the trip, which will become the final component
    /// of the trip's resource name.
    ///
    /// This value must be a valid RFC-4122 UUID.
    pub trip_id: std::string::String,

    /// Required. The trip to create.
    pub trip: std::option::Option<crate::model::Trip>,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl CreateTripRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [parent][crate::model::CreateTripRequest::parent].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::CreateTripRequest;
    /// let x = CreateTripRequest::new().set_parent("example");
    /// ```
    pub fn set_parent<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.parent = v.into();
        self
    }

    /// Sets the value of [trip_id][crate::model::CreateTripRequest::trip_id].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::CreateTripRequest;
    /// let x = CreateTripRequest::new().set_trip_id("example");
    /// ```
    pub fn set_trip_id<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.trip_id = v.into();
        self
    }

    /// Sets the value of [trip][crate::model::CreateTripRequest::trip].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::CreateTripRequest;
    /// use google_maps_navconnect_v1::model::Trip;
    /// let x = CreateTripRequest::new().set_trip(Trip::default()/* use setters */);
    /// ```
    pub fn set_trip<T>(mut self, v: T) -> Self
    where
        T: std::convert::Into<crate::model::Trip>,
    {
        self.trip = std::option::Option::Some(v.into());
        self
    }

    /// Sets or clears the value of [trip][crate::model::CreateTripRequest::trip].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::CreateTripRequest;
    /// use google_maps_navconnect_v1::model::Trip;
    /// let x = CreateTripRequest::new().set_or_clear_trip(Some(Trip::default()/* use setters */));
    /// let x = CreateTripRequest::new().set_or_clear_trip(None::<Trip>);
    /// ```
    pub fn set_or_clear_trip<T>(mut self, v: std::option::Option<T>) -> Self
    where
        T: std::convert::Into<crate::model::Trip>,
    {
        self.trip = v.map(|x| x.into());
        self
    }
}

impl wkt::message::Message for CreateTripRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.maps.navconnect.v1.CreateTripRequest"
    }
}

/// Request message for NavConnectService.GetTrip.
#[derive(Clone, Default, PartialEq)]
#[non_exhaustive]
pub struct GetTripRequest {
    /// Required. The resource name of the trip to get.
    /// Format: projects/{project}/trips/{trip_id}
    pub name: std::string::String,

    pub(crate) _unknown_fields: serde_json::Map<std::string::String, serde_json::Value>,
}

impl GetTripRequest {
    /// Creates a new default instance.
    pub fn new() -> Self {
        std::default::Default::default()
    }

    /// Sets the value of [name][crate::model::GetTripRequest::name].
    ///
    /// # Example
    /// ```ignore,no_run
    /// # use google_maps_navconnect_v1::model::GetTripRequest;
    /// # let project_id = "project_id";
    /// # let trip_id = "trip_id";
    /// let x = GetTripRequest::new().set_name(format!("projects/{project_id}/trips/{trip_id}"));
    /// ```
    pub fn set_name<T: std::convert::Into<std::string::String>>(mut self, v: T) -> Self {
        self.name = v.into();
        self
    }
}

impl wkt::message::Message for GetTripRequest {
    fn typename() -> &'static str {
        "type.googleapis.com/google.maps.navconnect.v1.GetTripRequest"
    }
}