Replace Unknown for Micromobility

Replaced 'unknown' state with new 'non_contactable' and 'missing' along with associated event types in the transitions.

Author: Jean Kao

modes/micromobility.md

@@ -115,8 +115,9 @@ Valid micromobility vehicle states are
 - `non_operational` 
 - `reserved` 
 - `on_trip` 
+- `non_contactable`
+- `missing`
 - `elsewhere` 
-- `unknown`  
 
 See [Vehicle States][vehicle-states] for descriptions.
 
@@ -134,10 +135,10 @@ Valid micromobility vehicle event types are
 - `comms_restored`
 - `compliance_pick_up`
 - `decommissioned`
+- `not_located`
 - `located`
 - `maintenance`
 - `maintenance_pick_up`
-- `missing`
 - `off_hours`
 - `on_hours`
 - `provider_drop_off`
@@ -167,54 +168,57 @@ The state-transition table below describes how the `vehicle_state` changes in re
 
 Note that to handle out-of-order events, the validity of the prior-state shall not be enforced at the time of ingest via Provider or Agency.  Events received out-of-order may result in transient incorrect vehicle states.
 
-Vehicles can enter the `unknown` state to and from any other state with the following event types: any state can go to `unknown` with event type `comms_lost`, `missing`, or `unspecified`, and `unknown` can go to any state with event type `comms_restored` of `unspecified`.
+Vehicles can enter the `non_contactable` state to and from any other state with the following event types: any state can go to `non_contactable` with event type `comms_lost` or `unspecified`, and `non_contactable` can go to any state with event type `comms_restored` of `unspecified`.
+
+Vehicles can enter the `missing` state to and from any other state with the following event types: any state can go to `missing` with event type `not_located` or `unspecified`, and `missing` can go to any state with event type `located` of `unspecified`.
 
 | Valid prior `vehicle_state` values | `vehicle_state` | `event_type` | Description |
 | ---------------------------------- | --------------- | ------------ | ----------- |
 | `non_operational` | `available`   | `battery_charged`    | The vehicle became available because its battery is now charged. |
 | `non_operational` | `available`   | `on_hours`           | The vehicle has entered operating hours (per the regulator or per the provider) |
-| `removed`,  `unknown` | `available`   | `provider_drop_off`  | The vehicle was placed in the PROW by the provider |
-| `removed`,  `unknown` | `available`   | `agency_drop_off`    | The vehicle was placed in the PROW by a city or county |
+| `removed`,  `non_contactable`, `missing` | `available`   | `provider_drop_off`  | The vehicle was placed in the PROW by the provider |
+| `removed`,  `non_contactable`, `missing` | `available`   | `agency_drop_off`    | The vehicle was placed in the PROW by a city or county |
 | `non_operational` | `available`   | `maintenance`        | The vehicle was previously in need of maintenance |
 | `on_trip` | `available`   | `trip_end`           | A trip has ended, and the vehicle is again available for rent |
 | `reserved` | `available`   | `reservation_cancel` | A reservation was canceled and the vehicle returned to service |
 | `on_trip` | `available`   | `trip_cancel`        | A trip was initiated, then canceled prior to moving any distance |
 | `non_operational` | `available` | `system_resume`          | The vehicle is available because e.g. weather suspension or temporary regulations ended |
-| `unknown` | `available`   | `comms_restored`        | The vehicle transmitted status information after a period of being out of communication. |
-| `unknown` | `available`   | `located`        | The vehicle has been located by the provider |
-| `non_operational`, `unknown`| `available`   | `unspecified`        | The vehicle became available, but the provider cannot definitively (yet) specify the reason.  Generally, regulator Service-Level Agreements will limit the amount of time a vehicle's last event type may be `unspecified`. |
+| `non_contactable` | `available`   | `comms_restored`        | The vehicle transmitted status information after a period of being out of communication. |
+| `missing` | `available`   | `located`        | The vehicle has been located by the provider |
+| `non_operational`, `non_contactable`, `missing` | `available`   | `unspecified`        | The vehicle became available, but the provider cannot definitively (yet) specify the reason.  Generally, regulator Service-Level Agreements will limit the amount of time a vehicle's last event type may be `unspecified`. |
 | `available` | `reserved`    | `reservation_start`  | The vehicle was reserved for use by a customer |
-| `unknown` | `reserved`   | `comms_restored`        | The vehicle transmitted status information after a period of being out of communication. |
-| `unknown` | `reserved`   | `located`        | The vehicle has been located by the provider |
-| `unknown` | `reserved`   | `unspecified`        | The provider cannot definitively state how a vehicle became reserved. |
+| `non_contactable` | `reserved`   | `comms_restored`        | The vehicle transmitted status information after a period of being out of communication. |
+| `missing` | `reserved`   | `located`        | The vehicle has been located by the provider |
+| `non_contactable`, `missing` | `reserved`   | `unspecified`        | The provider cannot definitively state how a vehicle became reserved. |
 | `available`, `reserved` | `on_trip`        | `trip_start`         | A customer initiated a trip with this vehicle |
 | `elsewhere` | `on_trip`        | `trip_enter_jurisdiction` | A vehicle on a trip entered the jurisdiction |
-| `unknown` | `on_trip`   | `comms_restored`        | The vehicle transmitted status information after a period of being out of communication. |
-| `unknown` | `on_trip`   | `located`        | The vehicle has been located by the provider |
-| `unknown` | `on_trip`   | `unspecified`        | The provider cannot definitively state how a vehicle started a trip. |
+| `non_contactable` | `on_trip`   | `comms_restored`        | The vehicle transmitted status information after a period of being out of communication. |
+| `missing` | `on_trip`   | `located`        | The vehicle has been located by the provider |
+| `non_contactable`, `missing` | `on_trip`   | `unspecified`        | The provider cannot definitively state how a vehicle started a trip. |
 | `on_trip` | `elsewhere`   | `trip_leave_jurisdiction` | A vehicle on a trip left the jurisdiction |
 | `on_trip` | `on_trip `   | `changed_geographies` | **[Beta feature](/general-information.md#beta-features):** *Yes (as of 1.1.0)*. The vehicle has entered or left one or more Geographies managed by a Policy. See [Geography Driven Events](#geography-driven-events).|
-| `unknown` | `elsewhere`   | `comms_restored` | The vehicle transmitted status information after a period of being out of communication. |
-| `unknown` | `elsewhere`   | `located`        | The vehicle has been located by the provider |
-| `unknown` | `elsewhere`   | `unspecified` | The provider cannot definitively state how a vehicle went `elsewhere`. |
+| `non_contactable` | `elsewhere`   | `comms_restored` | The vehicle transmitted status information after a period of being out of communication. |
+| `missing` | `elsewhere`   | `located`        | The vehicle has been located by the provider |
+| `non_contactable`, `missing` | `elsewhere`   | `unspecified` | The provider cannot definitively state how a vehicle went `elsewhere`. |
 | `available` | `non_operational` | `battery_low`        | The vehicle's battery is below some rentability threshold |
 | `available` | `non_operational` | `maintenance`        | The vehicle requires some non-charge-related maintenance |
 | `available` | `non_operational` | `off_hours`          | The vehicle has exited operating hours (per the regulator or per the Provider) |
 | `available` | `non_operational` | `system_suspend`          | The vehicle is not available because of e.g. weather or temporary regulations |
-| `available`, `unknown` | `non_operational` | `unspecified`        | The vehicle became unavailable, but the Provider cannot definitively (yet) specify the reason. |
-| `unknown` | `non_operational`   | `comms_restored`        | The vehicle transmitted status information after a period of being out of communication |
-| `unknown` | `non_operational`   | `located`        | The vehicle has been located by the provider |
+| `available`, `non_contactable`, `missing` | `non_operational` | `unspecified`        | The vehicle became unavailable, but the Provider cannot definitively (yet) specify the reason. |
+| `non_contactable` | `non_operational`   | `comms_restored`        | The vehicle transmitted status information after a period of being out of communication |
+| `missing` | `non_operational`   | `located`        | The vehicle has been located by the provider |
 | `available`, `non_operational`, `elsewhere` | `removed`     | `rebalance_pick_up`  | The provider picked up the vehicle for rebalancing purposes |
 | `available`, `non_operational`, `elsewhere` | `removed`     | `maintenance_pick_up` | The provider picked up the vehicle to service it |
-| `available`, `non_operational`, `elsewhere`, `unknown` | `removed`     | `agency_pick_up`     | An agency picked up the vehicle for some reason, e.g. illegal placement |
+| `available`, `non_operational`, `elsewhere`, `non_contactable`, `missing` | `removed`     | `agency_pick_up`     | An agency picked up the vehicle for some reason, e.g. illegal placement |
 | `available`, `non_operational`, `elsewhere` | `removed`     | `compliance_pick_up` | The provider picked up the vehicle because it was placed in a non-compliant location |
-| `available`, `non_operational`, `elsewhere`, `unknown` | `removed`     | `decommissioned`     | The provider has removed the vehicle from its fleet |
-| `unknown`, `non_operational`, `available`, `elsewhere` | `removed`     | `unspecified`        | The vehicle was removed, but the provider cannot definitively (yet) specify the reason |
-| `unknown` | `removed`   | `comms_restored`        | The vehicle transmitted status information after a period of being in an unknown state |
-| `unknown` | `removed`   | `located`        | The vehicle has been located by the provider |
-| `available`, `elsewhere`, `non_operational`, `on_trip`, `removed`, `reserved` | `unknown`     | `missing`            | The vehicle is not at its last reported GPS location, or that location is wildly in error |
-| `available`, `elsewhere`, `non_operational`, `on_trip`, `removed`, `reserved` | `unknown`     | `comms_lost`       | The vehicle is unable to transmit its GPS location or other status information |
-| `available`, `elsewhere`, `non_operational`, `on_trip`, `removed`, `reserved` | `unknown`     | `unspecified`       | The provider cannot definitively (yet) specify the reason for the unknown state |
+| `available`, `non_operational`, `elsewhere`, `non_contactable`, `missing` | `removed`     | `decommissioned`     | The provider has removed the vehicle from its fleet |
+| `non_contactable`, `missing`, `non_operational`, `available`, `elsewhere` | `removed`     | `unspecified`        | The vehicle was removed, but the provider cannot definitively (yet) specify the reason |
+| `non_contactable` | `removed`   | `comms_restored`        | The vehicle transmitted status information after a period of being in an non_contactable state |
+| `missing` | `removed`   | `located`        | The vehicle has been located by the provider |
+| `available`, `elsewhere`, `non_operational`, `on_trip`, `removed`, `reserved` | `missing`     | `not_located`            | The vehicle is not at its last reported GPS location, or that location is wildly in error |
+| `available`, `elsewhere`, `non_operational`, `on_trip`, `removed`, `reserved` | `non_contactable`     | `comms_lost`       | The vehicle is unable to transmit its GPS location or other status information |
+| `available`, `elsewhere`, `non_operational`, `on_trip`, `removed`, `reserved` | `non_contactable`     | `unspecified`       | The provider cannot definitively (yet) specify the reason for the non_contactable state |
+| `available`, `elsewhere`, `non_operational`, `on_trip`, `removed`, `reserved` | `missing`     | `unspecified`       | The provider cannot definitively (yet) specify the reason for the missing state |
 
 [Top][toc]